Images

Images are integrated in TYPO3 using the “Text & Media” content element. Before uploading images, prepare them in an image editing program.

Image preparation

Important: Never upload uncompressed camera files. Always optimize and prepare images before uploading.

Requirement	Details
Formats	JPG/JPEG, GIF, PNG, SVG, WebP
Maximum Width	936 px (with right column) / 1176 px (without right column)
Consistent Dimensions	When using multiple images within one element, all images should have the same width and height
File Name	Use descriptive file names and avoid special characters

Uploading an image

Before you can use an image in a content element, it must first be uploaded to the Filelist:

1. Open the Filelist module from the module menu.
2. Navigate to the desired folder.
3. Click “Upload File”.
4. Select the image file you want to upload.

For more information, see the Filelist guide.

 

Adding an image to a content element

1. Open a “Text & Media” content element (create a new one or edit an existing one).
2. Switch to the “Media” tab.
3. Click “Add Media File”.
4. The File Browser opens. Navigate to your image and select it.
5. The image will then appear in the media list.

Image settings

Setting	Description
Width / Height	Enter only one value. The image will scale proportionally.
Text Wrapping	Text flows around the image on the left or right side.
Columns	Display multiple images side by side in up to 9 columns.
Order	Rearrange images using drag and drop.

Editing image metadata

Click on an image in the media list to configure element-specific settings:

• Title: Overrides the default file title.
• Caption: Displayed below the image in the frontend.
• Alternative Text (Alt Text): Used by screen readers and helps improve SEO. See “Alternative texts” for details.

Multiple images

• Vertical (stacked): Default layout; no column setting is required.
• Horizontal (side by side): Set the desired number of columns to display images next to each other.