Study guide · Media, files and copyright
Managing files, naming them well and using them legally
Images, videos and PDFs are part of almost every page. On this page you learn how to manage them in the backend module Media, how to name files sensibly and how to embed them in content elements. At the end you look at copyright and data protection, because not every image may go on the website.
The example is the website of the Weidenau City Library. It has pages such as Home, Events, Media, Opening hours and Contact, plus an English version. Lena is the editor who maintains the content. Tom is the administrator who looks after the system and sets up Lena's access.
The Media module at a glance
In TYPO3 you manage files in the Media module. Up to TYPO3 13 it was called “Filelist”; since TYPO3 14 it has its new name. This is where images, videos, audio files and documents such as PDFs live.
The module is built like the Records module. On the left you see the folder tree of the file storages, on the right the files of the selected folder. The folder tree matches the folder structure on the server.
What you see depends on your permissions:
- Tom is an administrator. He sees the default storage fileadmin as the root. The documentation shows it as “fileadmin/ (auto-generated)”. When TYPO3 14 creates the storage itself, it is simply called fileadmin. It matches the folder fileadmin below the document root of the web server.
- Lena is an editor. She only sees the folders that Tom has shared with her through the file mounts of her backend group. Other files on the server stay invisible to her.
- Extensions can connect further storages, for example a WebDAV server or Amazon S3. You work with them just like with files on your own server.
The module shows files in two views. The default is the tile view with thumbnails. With the button “View” you switch to the list view. In the list you choose with “Select columns” which columns appear, such as title, size or references.
Your user settings contain the option “Show hidden files and folders in the Media module”. It shows files and folders that TYPO3 normally hides. It does not change your access rights. Folders outside your file mounts stay invisible.
Creating folders and uploading files
Lena creates a folder for the library's summer fair. Since TYPO3 14 the button for this is called “New Folder”; it used to be called “Create Folder”. It opens a dialog with the folder tree. There she picks the parent folder and enters a name. The dialog stays open after each folder. So she can create more folders right away, and every new folder appears in the tree immediately.
There are several ways to upload:
- You drag and drop files into the view. They land in the current folder.
- You click “New File” in the header of the module. Since TYPO3 14 this dialog combines the upload with “Select & upload files”, adding online media such as YouTube or Vimeo, and creating a text file. The former separate upload button has been merged into it.
- The context menu of a folder offers “New File” as well. This lets you upload straight into that folder.
If a file with the same name already exists, TYPO3 asks you. You can replace it, rename the new file, skip it or use the existing file.
The configuration of the installation decides which file extensions are allowed. That is why uploads and file selectors always show which formats are accepted. The maximum size of an upload can also be limited.
Good file names
A file name seems minor, but it often causes trouble. It appears in URLs, for example in download links. It travels between Windows, macOS and Linux. And it helps you find a file again months later.
So a few simple rules apply:
- Use lowercase letters from a to z, digits from 0 to 9 and the hyphen. The underscore is safe too, and so is the dot before the file extension.
- Avoid spaces, umlauts and special characters such as the ampersand, the hash sign, brackets, the slash or the question mark.
- Choose descriptive names such as “summer-fair-reading-garden.jpg” instead of “IMG_4711.jpg”. They are easier to find again.
- Write a date as year, month, day, so 2026-10-09. Then files sort themselves in the right order.
- Use a version number such as v2 instead of words like “new”, “final” or “really final”.
Why this matters: in a URL a space must be encoded and becomes percent twenty. Umlauts are stored differently depending on the system. Between operating systems this leads to garbled names and broken links. Slashes and question marks have a special meaning in paths and URLs. A date with dots is easily confused with the file extension, and it sorts in the wrong order.
What does TYPO3 do if a poor name comes in anyway? It sanitizes the file name on upload. By default it replaces characters outside the allowed range, such as spaces, brackets or an ampersand, with an underscore. The upload is not rejected, and TYPO3 does not assign a random name either. Whether umlauts are kept depends on a system setting. New installations keep them, while older installations often still convert them.
Maintaining metadata
For every file you can store metadata. It describes the file, not its pixels. Typical entries are:
- A title and a description that are shown in some places.
- An alternative text for images. Screen readers read it out, and it appears when an image does not load.
- A download name under which visitors save a file.
- Copyright information, that is the author and the licence.
- Technical data such as the camera used or the location of the shot.
Title, description and alternative text come with every installation. Fields such as download name, copyright or location come from the system extension “File Metadata”. So what you see depends on the system and on the file format. The permissions of backend groups or the layout of a page are not part of it.
You open the metadata with the pencil button on the file. Its title reads “Edit Metadata of this file”, Edit Metadata for short. The benefit: you maintain metadata once, and it applies wherever the file is used. In a single content element you can override the title or alternative text if needed.
If Lena has many images without an alternative text, she edits several files at once:
- She switches to the list view with “View”.
- With “View” and “Select columns” she picks the columns alternative text and description.
- She ticks the checkboxes in front of the file names.
- She clicks “Edit specific Metadata”. The form shows only the chosen fields of all selected files.
- She enters the texts and saves. The column choice stays in place for the next files.
Metadata can also be translated. The library has an English site, so the photo of the reading garden needs an English alternative text there. The file has a button “Translations” for this. For each language it offers to create or edit the metadata, for example “Create metadata of this file for English”. The learning objectives call this “Translate metadata”. The English page then shows the English text, and all other pages show the German one. You do not need a copy of the file.
Search, references and bulk actions
The Media module has its own search. It finds files by their file name and by the metadata title, description and alternative text. This is where good names and maintained metadata pay off. In current versions of TYPO3 14.3 the live search at the top of the backend finds files as well, but only within your file mounts. This change only arrived with a maintenance update of 14.3.
Whether a file is in use is shown by the “References” entry. In the list view you show it as a column. It tells you how often and where a file is embedded. A click opens the list of places.
Many tasks work for several files at once. You select them and can then delete them, download them or move them to the clipboard together. This works just like in the Records module.
There are two ways to move files:
- The quick way is drag and drop. You select files or folders and drag them onto the target folder in the folder tree. When you release the mouse button, they are moved.
- The clipboard keeps selected files until you paste them. It helps when you collect files over several steps or open the target folder later.
What the File Abstraction Layer does for you
Behind the Media module sits the File Abstraction Layer, FAL for short. It is a layer that separates files from their storage location. A content element does not point to a path such as a folder on the server. It points to the file itself through a file reference. FAL also makes the metadata for each file possible.
This leads to three rules you notice every day:
- Moving is harmless. When Lena drags an image into another folder, every content element keeps showing it. There is no error message and no copy left in the old folder.
- Deleting is blocked while the file is in use. TYPO3 refuses and lists the places where the file is still used. So the file never silently disappears from an element, and there is no placeholder image.
- Replacing works everywhere. When you swap a file for a new version, all references stay in place. Every usage shows the new file afterwards.
Replacing and deleting files
The library has a new logo. It is embedded on fifteen pages. Lena does not have to change fifteen elements one by one. The most efficient way: she replaces the file in the Media module with the new version. She chooses “Replace” on the file, selects the new file and decides whether to keep the current file name.
Since TYPO3 14 this opens a dialog in the backend instead of a new window. It shows more detailed information about the file: a thumbnail, the file type, the size and the creation date. So you can check before the swap that you picked the right file.
After replacing, you may need to clear the cache of the affected pages. Only then does the frontend show the new version everywhere.
Another case: the Events page still links an outdated PDF with last year's programme. Lena wants to delete it, and TYPO3 refuses. This is how she proceeds:
- She opens the list of places through “References”.
- She adjusts or deletes the content elements that still use the PDF.
- Then she deletes the file in the Media module.
Alternatively she simply replaces the PDF with the current programme.
Media in content elements
TYPO3 manages many kinds of media: images, videos, audio files and documents such as PDFs. There is no fixed limit such as one megabyte, and it is not restricted to JPG and PNG. The configuration decides which types are allowed.
The most important element for media is called “Text and Media”. It embeds images, video files and audio files. It also embeds videos from platforms such as YouTube and Vimeo.
The form has two buttons:
- “Add media file” selects a file from the Media module or uploads a new one. Lena uses it to embed her own video of the library's reading night.
- “Add media by URL” is for external sources. Here she pastes the link to a YouTube video.
Below the selection the element shows the allowed file extensions, including pseudo formats such as youtube or vimeo. This list depends on the configuration and on installed extensions.
The dialogs for choosing files, the file browsers, have had a column selector since TYPO3 14 as well. There you show, for example, title, size, modification date or references. In large folders you find the newest or the biggest file faster.
Image formats. For photos, JPG and the more compact WebP are common. For graphics people often use PNG. Logos and icons are best stored as SVG. It is a vector format and stays sharp at any size. A JPG loses sharpness at edges and with text. BMP and TIFF are too large for the web. PSD and RAW are working formats from image editing and cameras and are not meant for web pages.
File size. Lena has a twelve megabyte photo straight from the camera. The problem: large files slow down page loading. This hits visitors with a slow connection hardest. So she scales and compresses the photo before uploading it.
Scaled variants. In the frontend, images often appear at a different size than the original. TYPO3 creates processed variants from the original at a suitable size and with the chosen crop. The original stays unchanged in the Media module. Even so, oversized originals do not belong in the system.
Cropping. A wide image for the home page looks great on the desktop. On a smartphone the subject becomes tiny. That is why an image often needs different aspect ratios so it looks good on every device. In the field “Image manipulation” you open the image editor with “Open Editor”. If the site package is set up for it, you define a crop variant per device there. For example, you choose portrait for the smartphone and a wide banner for the desktop. Two pages or a second upload are not needed.
Copyright
As soon as you use files you did not create yourself, you have to respect copyright. This applies to images, videos and texts. Before Lena uses a photo from the internet, she checks whether she has the necessary rights of use. File size and format do not matter for this.
A few myths are hard to kill:
- Images from the image search of search engines are not automatically free. Copyright applies there too.
- Crediting the source does not replace permission. A credit is often required, but it does not make use without rights legal.
- Even your own work can infringe other people's rights. Photos of certain artworks are one example. And if you redraw a famous cartoon character, you may not simply publish the picture. A note such as “fan art” does not change that.
Using other people's images without the rights risks high fines. If in doubt, do not use the content, or get legal advice first.
Content from an AI. Tom has an AI write a text about a new law on lending and generate images. Such results can contain invented or outdated information. They can also reproduce other people's texts or images and so touch third-party rights. That is why Lena checks AI content carefully before publishing: for accuracy and for third-party rights, not just for typos.
Data protection and personal rights
Besides copyright there is data protection. The laws differ from country to country. In general, though, you only publish data and pictures of a person with their consent. There are exceptions, for example for public figures such as politicians or film stars.
Personal data is any information that can identify a person. That is more than just the name:
- Name, email address and phone number are personal data.
- The IP address counts too, because it can make a person identifiable.
- A nickname can give a person away just as well.
- Photos in which someone can be recognised, and car licence plates, belong here too.
The industry of a company or the opening hours of a shop, on the other hand, are not personal data.
The library wants to introduce its team on the Contact page. The combination of name and photo of a person is especially sensitive here, together with the direct phone line and personal email address. Publishing them needs a legal basis, usually consent.
External resources. When Lena embeds a YouTube video, the visitors' browser loads data from other servers. Visitor data can go to third parties in the process, for example their IP address. Depending on the country, this requires consent before loading. Two-click consent solutions are common: data is only transferred after the click on “Load video”.
Key points
- You manage files in the Media module, formerly Filelist. Editors only see the folders of their file mounts, administrators see the default storage fileadmin.
- The module shows tiles or a list, offers a clipboard like the Records module and allows actions on several files at once.
- You create folders with “New Folder” and upload files by drag and drop, through “New File” or through the context menu of a folder.
- Good file names consist of lowercase letters, digits and hyphens, and a date is written as year, month, day. TYPO3 replaces spaces and other disallowed characters with underscores.
- You maintain metadata such as title, description, alternative text and copyright with the pencil button, also for many files together, and per language through “Translations”.
- The search in the Media module finds files by name, title, description and alternative text. “References” shows where a file is used.
- Thanks to FAL, moving breaks nothing, files in use cannot be deleted, and replacing affects every usage.
- In “Text and Media” you embed your own files with “Add media file” and YouTube or Vimeo with “Add media by URL”.
- Photos as JPG or WebP, logos as SVG, images scaled down before upload, and crop variants for different devices.
- Other people's content needs rights of use, people in photos usually need to give consent, and AI content needs a check.
Terms
- Media
- Backend module for files and folders, called Filelist up to TYPO3 13.
- File mount
- A folder shared with a backend group or a backend user.
- File Abstraction Layer
- Layer that separates files from their storage location and enables metadata, FAL for short.
- File reference
- The link between a content element and a file.
- Metadata
- Information about a file such as title, description, alternative text and copyright.
- Alternative text
- Description of an image for screen readers and for when the image does not load.
- References
- Entry in the Media module that shows how often and where a file is used.
- Crop variant
- An image section with its own aspect ratio for a particular device.
- SVG
- Vector format that stays sharp at any size.
- Personal data
- Any information that can identify a person.
- Two-click consent
- External content only loads after the visitor has agreed.