Filelist
The Filelist module is used to manage files (images, PDFs, videos, etc.) that you want to integrate into your pages later. Here you can upload, rename, delete, move, and add metadata to files.
Opening the Filelist module
- Click on Filelist (folder icon) in the module menu
- The folder structure appears on the left, and the contents of the selected folder are displayed on the right in the workspace
Adjusting the view
In TYPO3, you have several options to adjust how files are displayed:
| Mode | Icon | Description |
|---|---|---|
| List | List icon | Files displayed as a table with details |
| Tiles | Tile icon | Files displayed as visual preview tiles |
Thumbnails
- Click the preview icon to toggle thumbnail previews on or off.
- Helpful when working with many image files.
Creating folders
Keep your files well organized—clearly named folders make it much easier to use them later.
How to create a new folder:
- Navigate to the desired parent folder in the folder structure on the left
- Click Create folder (or the corresponding icon) at the top
- Enter a descriptive name
- Confirm with Save
Hint
Use descriptive folder names without special characters or spaces, e.g., "press-images-2025" instead of “Press Images 2025!”
Uploading files
How to upload a file:
- Navigate to the desired target folder
- Click Upload file (or drag and drop files into the workspace)
- Select the file(s) on your computer
- The upload starts automatically
File operations
Hover over a file with your mouse cursor or select the file using the checkbox. The following actions are available:
| Action | Description |
|---|---|
| Edit | Edit the file’s metadata |
| Open in new window | Display the file in a new browser tab |
| Replace | Replace the file with a new version (references are preserved) |
| Rename | Rename the file (all references are updated automatically) |
| Move | Move the file to another folder |
| Copy | Duplicate the file |
| Delete | Permanently delete the file |
| Download | Download the file to your computer |
| File info | Detailed view with technical information |
Entering metadata
Each file can be enriched with metadata. This information is important for:
- Accessibility (alt text for images)
- Search engine optimization
- Reuse across different pages
How to edit metadata:
- Click the edit icon next to the file
- The metadata form opens in the workspace
- Fill in the desired fields:
- Title – display name of the file
- Alternative text – description for screen readers and search engines
- Description – longer explanatory text
- Save by clicking Save
Hints
Important: Metadata entered directly in a content element will override the global metadata stored here—but only within that specific content element. The global metadata will remain unchanged for all other uses of the file.
Tip: Enter metadata directly in the Filelist if a file is used on multiple pages. This way, you only need to maintain the information once.
Editing multiple files at once (Clipboard)
To edit multiple files simultaneously:
- Enable the Show clipboard option at the top
- Switch to Clipboard #1 (multi-selection mode)
- Select the checkboxes next to the desired files
- Choose the desired action (move, copy, delete)
Hints for editors
Tip: Always use clear, descriptive names for files and folders. A well-structured Filelist saves time when adding content later and helps prevent duplicates.
Warning: Renaming a file is safe—TYPO3 automatically updates all existing references. Deleting a file, however, is permanent. Check beforehand whether the file is still used on other pages.