The content element
The Text & Media content element is the most versatile element in TYPO3. It allows you to combine formatted text with images, videos, or other media within a single content element.
Create content element "Text & Media"
- Open the Page module and navigate to the desired page.
- Click the “+” icon in the content area at the position where you want to add the new element.
- In the dialog, select “Typical Page Content” → “Text & Media”.
- The editing form will open.
General Tab – entering text
In the “General” tab, you can configure:
- Heading with heading type selection (H1–H5 or Hidden)
- Text using the Rich Text Editor (RTE)
A separate guide is available for editing and formatting content with the Rich Text Editor (RTE).
Adding media
At the top of the Media tab, you have three options for adding media:
| Icon | Function |
|---|---|
| File Management icon | Select an image or file from the Filelist |
| Upload icon | Upload a file directly from your computer |
| Link icon | Embed a YouTube or Vimeo video using its URL |
Steps:
- Click the desired icon.
- Select the file or enter the video URL.
- The media item will appear in the media list below.
Changing the order of media
If your content element contains multiple images:
- Click and hold the drag handle (the six-dot icon) to the left of the image.
- Drag the image to the desired position using drag-and-drop.
The images will be displayed on the frontend in the same order as they appear in the media list.
Setting image size and text flow
Below the media list, you will find two important settings:
Width / Height:
Enter only one value (width or height). TYPO3 automatically calculates the other value to maintain the image's proportions. The specified size applies to all images within the content element.
Text flow:
Determines where the media is displayed in relation to the text:
- Top / Bottom: Media is displayed above or below the text.
- Left / Right: Media is displayed beside the text, with the text wrapping around it (float layout).
Columns
When using multiple images, you can choose the number of columns (1–9):
- 1 column: Images are displayed one below the other.
- Multiple columns: Images are displayed side by side.
Enable “Enlarge on click”
Enable this option if visitors should be able to click an image to view it in its full size.
Note
“Enlarge on Click” and linking an image (see image metadata settings) are mutually exclusive. You can use only one of these options for a particular image.
More Information
For more information about working with media - especially images - please refer to the dedicated Images guide. These guides provide detailed instructions on image preparation, uploading, gallery creation, metadata management, and display settings.