---
title: "Working with images"
manual: "Tutorial for Editors"
version: "main"
permalink: "https://docs.typo3.org/permalink/t3editors:images@main"
source: "ContentElements/Images/Index.rst"
modified: "2026-09-15T07:05:35+00:00"
---

# Working with images

[Watch this video on YouTube](https://www.youtube.com/watch?v=KQ8fh_Ywktk)

---

![Content element Images in the TYPO3 backend](../../Images/ManualScreenshots/ContentElements/Images.png)

For content elements that support images (for example Text & Images, Text &
Media, Images Only), you will see an **Images** or **Media**
tab when you create or edit the content element.

Start by [Creating a content element](https://docs.typo3.org/permalink/t3editors:content-creating@main)
of type "Text & Images", "Text & Media", or "Images Only". You can find them in the
tab [Typical page content](https://docs.typo3.org/permalink/t3editors:content-typical@main).

## Add an image to the content element

On the **Images** tab, click on the **Add image** button to display a
**File selector** window which lets you browse for an image.

![Screenshot of a "Text with Image" TYPO3 content element, tab "Images"](../../Images/ManualScreenshots/ContentElements/TextWithImage/ImagesTab.png)

Browse the file tree, then select a folder. The file selector always starts
in the root folder of the default storage. Use the search field to find a
file by name. The search includes all the subfolders of the selected folder.

![The file selector window in the TYPO3 backend](../../Images/ManualScreenshots/ContentElements/TextWithImage/FileSelector.png)

## Configure the image

The **Images** tab lets you perform a number of actions to configure an image.

### Image metadata

Use the small arrow next to the thumbnail to collapse and expand this section.

Here you can set general metadata including description, alt text, and
insert a link to the image.

![Screenshot of the meta data of an image in a "Text and Image" content element](../../Images/ManualScreenshots/ContentElements/TextWithImage/ImageMetaData.png)

The information displayed here is drawn from the file metadata set in the
**Media**. If required, you can override this metadata to set specific
values for the image for the current content element.

You can experiment with the image manipulation editor to crop or resize the
image. Making changes here won't impact the original image file in
**Media**.

### Media adjustments

Manually specify the width and height of the image in pixels, and apply a
border.

![Screenshot of the Media Adjustments section of a "Text and Images" content element in TYPO3](../../Images/ManualScreenshots/ContentElements/TextWithImage/MediaAdjustments.png)

> [!NOTE]
> This section is only visible when your site package is based on the
> Site Package Tutorial or on Fluid Styled Content. Site Packages based on
> the Bootstrap Package have means to dynamically set the size of the images.
> The images will resize responsively to fill their container.

### Gallery settings

Choose where to position the image in relation to the text.

In "Text with Images" content elements you can position the image or images in
respect to the text here.

Multiple images are automatically arranged in columns, two by two. You can change this
behaviour with the **Number of Columns** field.

### Behavior

Use the **Enlarge on Click** setting to enable a lightbox display for the image.

> [!TIP]
> If you are more comfortable using shortcuts, there are different kinds of
> [keyboard commands](https://docs.typo3.org/permalink/t3editors:keyboard-commands@main) you can use in
> the backend forms.

## Manage your images in the Media module

> [!NOTE]
> **Changed in version 14.0**
>
> This module has been renamed from **Filelist** to **Media**
> see [Feature: #107628 - Improved backend module naming and structure](https://docs.typo3.org/c/typo3/cms-core/main/en-us/Changelog/14.0/Feature-107628-ImprovedBackendModuleNamingAndStructure.html#feature-107628-1729026000).

You can manage your previously uploaded images in the backend module
**Media**:

![Screenshot of the "Media" backend module in TYPO3](../../Images/ManualScreenshots/ContentElements/TextWithImage/FileList.png)

TYPO3 uses a file abstraction layer (FAL) you can therefore move images into
different folders without affecting the frontend output of the web page, even if
they are used in multiple places.

You can move images into folders by drag and drop:

![Screenshot of the "Media" backend module demonstration Drag and Drop](../../Images/ManualScreenshots/ContentElements/TextWithImage/FileListDragAndDrop.png)

The file abstraction layer will not allow you to delete images that are still in
use in some content element:

![File not deleted, The file "xxx.png" cannot be deleted since it is still used at the following places](../../Images/ManualScreenshots/ContentElements/TextWithImage/FileNotDeleted.png)

First alter or delete all content elements that still use the file, then you can
delete the file itself.

See also chapter [Managing files in the Fileadmin](https://docs.typo3.org/permalink/t3editors:managing-files-in-typo@main).