Dateiliste

Auf einen Blick: Dateiliste

Die Dateiliste ist das zentrale Backend-Modul in TYPO3, in dem alle Dateien (Bilder, PDFs, Videos, Dokumente) hochgeladen, organisiert und mit Metadaten versehen werden.

Dateien werden einmal hochgeladen und können beliebig oft in Inhaltselementen verwendet werden.
Metadaten wie Alt-Text, Titel und Bildunterschrift werden bei der Datei gepflegt und automatisch in alle Inhaltselemente übernommen.
Eine gut geplante Ordner-Struktur ist zu empfehlen und zahlt sich schnell aus, vor allem bei einem größeren Redaktionsteam.
Vor dem Löschen einer Datei immer prüfen, ob sie noch verwendet wird: Eine gelöschte Datei fehlt sofort an allen Stellen, an denen sie eingebunden ist.
Die Dateiliste arbeitet auf einer Abstraktionsschicht: Umbenannte oder verschobene Dateien bleiben im Frontend korrekt verlinkt.

Was ist die Dateiliste in TYPO3?

Die Dateiliste ist das Medienmodul im TYPO3-Backend. Sie öffnen es in der linken Backend-Navigation über den Menüpunkt "Datei › Dateiliste" (ab TYPO3 v14 “Medien”). Dort verwalten Sie alle Dateien, die auf Ihrer Website verwendet werden: Bilder, PDFs, Videos, Office-Dokumente und weitere Formate.

Das Modul basiert auf dem File Abstraction Layer (FAL), der seit Langem das Herzstück der Dateiverwaltung in TYPO3 ist. FAL bedeutet: Jede Datei erhält beim Upload eine eindeutige interne ID. Alle Inhaltselemente, die diese Datei verwenden, referenzieren auf diese ID. Dadurch kann eine Datei umbenannt oder in einen anderen Ordner verschoben werden, ohne dass Verlinkungen im Frontend verloren gehen.

Standardmäßig werden alle Mediendateien im Ordner fileadmin/ auf dem Webserver abgelegt. Dieser Ordner ist öffentlich zugänglich: Wer den korrekten Pfad kennt oder errät, kann direkt auf Dateien zugreifen. Für geschützte Downloads (z. B. nur für eingeloggte Frontend-Nutzer) sind zusätzliche Maßnahmen erforderlich.

Der Verzeichnisbaum auf der linken Seite der Dateiliste zeigt die Ordnerstruktur. Er lässt sich frei gestalten: Sie können die Ordnerstruktur an der Seitenstruktur ausrichten, müssen es aber nicht. Wenn eine andere Struktur sinnvoller erscheint, legen Sie die Verzeichnisse nach eigenen Vorstellungen an.

Die Dateiliste in der Praxis

Für Redakteure

Der typische Arbeitsablauf beginnt in der Dateiliste, bevor ein Inhaltselement angelegt wird. Laden Sie zuerst die benötigte Datei in das richtige Verzeichnis hoch und pflegen Sie dann die Metadaten der Datei. Anschließend binden Sie die Datei in ein oder mehrere Inhaltselemente ein. Dieser Ablauf spart Zeit, weil Metadaten nicht in jedem Inhaltselement neu eingetragen werden müssen.

Schritt-für-Schritt: Eine Datei hochladen und für die Verwendung vorbereiten

Öffnen Sie im Backend das Modul "Datei › Dateiliste".
Wählen Sie im Verzeichnisbaum links den Zielordner aus (z. B. fileadmin/bilder/news/).
Klicken Sie oben auf das Upload-Symbol oder ziehen Sie Dateien per Drag-and-drop in die Dateiliste.
Nach dem Upload erscheint die Datei in der Liste. Klicken Sie auf das Stiftsymbol neben dem Dateinamen, um die Metadaten zu öffnen.
Tragen Sie mindestens den Alt-Text ein (Pflicht für Barrierefreiheit) sowie optional Titel, Bildunterschrift und Urheber.
Speichern Sie die Metadaten. Die Datei ist jetzt bereit für die Verwendung in Inhaltselementen.

Für Administratoren und Integratoren

Die Berechtigung für Dateizugriffe wird über sogenannte Verzeichnisfreigaben und die Zugriffsberechtigung des TYPO3-Accounts geregelt. Über Benutzergruppen und Verzeichnisfreigaben steuern Sie, welche Redakteure welche Ordner sehen und bearbeiten dürfen. Dabei können Sie Lese- und Schreibrechte getrennt vergeben. Zusätzliche Dateispeicher (z. B. für einen privaten oder schreibgeschützten Bereich) lassen sich über die TYPO3-Systemkonfiguration einrichten.

Typische Fehler und wie Sie sie vermeiden

Eine Datei wurde gelöscht, obwohl sie noch verwendet wird

Symptom: Auf der Website erscheint ein leeres Bildfeld, ein fehlendes Dokument oder ein 404-Fehler beim Aufrufen eines Downloads.
Ursache: Die Datei wurde in der Dateiliste gelöscht, ohne vorher die Referenzanzahl zu prüfen. Wenn eine Datei an mehreren Stellen genutzt wird, ist die Pflege an der Datei der richtige Weg. Entfernen Sie Verwendungen oder ersetzen Sie die Datei. Erst danach löschen.
Lösung: Prüfen Sie vor jedem Löschvorgang die Spalte "Ref" (Referenzen) in der Dateiliste. Zeigt sie eine Zahl größer als 0, ist die Datei noch eingebunden. Nutzen Sie bei einer neueren Dateiversion die Funktion "Ersetzen" statt "Löschen".

Ein Ordner wurde umbenannt, externe Links laufen ins Leere

Symptom: Externe Links (z. B. aus E-Mails, sozialen Netzwerken oder anderen Websites) auf eine Datei führen auf eine Fehlerseite.
Ursache: Die Umbenennung eines Ordners hat zur Folge, dass sich die URL der darin enthaltenen Dateien ändert. Verlinkungen auf die Dateien in TYPO3 bleiben bestehen, sofern sie korrekt als Datei und nicht falsch als externe URL verlinkt sind. Externe Links können hingegen nicht automatisch aktualisiert werden.
Lösung: Ordner und Dateinamen möglichst frühzeitig final vergeben. Bei notwendigen Umbenennungen: Weiterleitungen einrichten, entweder über das TYPO3 Redirects-Modul oder in der Webserver-Konfiguration.

Metadaten werden nur im Inhaltselement gepflegt

Symptom: Dieselbe Datei wird an fünf Stellen eingesetzt. An jeder Stelle steht ein anderer Alt-Text, zum Teil unvollständig oder veraltet.
Ursache: Metadaten nur im Inhaltselement zu pflegen führt bei Mehrfachverwendung schnell zu Inkonsistenz. Der Standard ist, Metadaten zentral in der Dateiliste zu pflegen.
Lösung: Alt-Text, Titel und Bildunterschrift immer direkt bei der Datei in der Dateiliste hinterlegen. Eine Überschreibung im Inhaltselement ist nur dann sinnvoll, wenn derselbe Inhalt in einem bestimmten Kontext wirklich eine abweichende Beschriftung benötigt.

Alle Dateien werden im Wurzelverzeichnis abgelegt

Symptom: Die Dateiliste wächst auf hunderte Dateien ohne Unterordner. Dateien lassen sich kaum noch auffinden, Namenskonflikte häufen sich.
Ursache: Beim Upload wird kein Zielordner ausgewählt oder es gibt keine Unterordner, alle Dateien landen im Stammverzeichnis.
Lösung: Vor dem ersten Upload eine logische Ordnerstruktur anlegen (z. B. nach Themen, Seitenbereichen oder Dateitypen). Dateinamen von Beginn an sprechend und einheitlich vergeben (nur Kleinbuchstaben, keine Umlaute, keine Leerzeichen, keine generischen Namen wie bild1.jpg).

Assets des Website-Themes werden in fileadmin/ abgelegt

Symptom: Logos, Icon-Dateien oder CSS-Hintergrundbilder werden in der Dateiliste verwaltet und aus fileadmin/ ausgeliefert.
Ursache: Kein klares Konzept für die Trennung von Content-Assets und Theme-Assets.
Lösung: Assets, die für das Theme benötigt werden, gehören nicht in die Dateiliste. Sie werden im Ordner Resources/Public des Sitepackages oder einer anderen Extension abgelegt. Die Dateiliste ist ausschließlich für redaktionell verwaltete Medien gedacht.

Best Practices / Checkliste

Legen Sie eine Ordnerstruktur fest, bevor Sie mit dem Upload beginnen. Eine zweistufige Struktur (z. B. bilder/produkte/, downloads/presse/) ist für die meisten Projekte ausreichend.
Vergeben Sie Dateinamen in Kleinbuchstaben ohne Sonderzeichen, Umlaute und Leerzeichen. Verwenden Sie stattdessen Bindestriche oder Unterstriche als Trennzeichen (z. B. jahresbericht_2026.pdf). Das schützt vor Problemen mit URL-Encoding und sichert externe Links langfristig ab.
Pflegen Sie Metadaten direkt bei der Datei, nicht im Inhaltselement. Metadaten wie alternativer Text oder Titel wirken zentral: Einmal eingetragen, gelten sie überall dort, wo die Datei verwendet wird.
Tragen Sie für jedes Bild einen Alt-Text ein. Der alternative Text ist für Barrierefreiheit und Suchmaschinenoptimierung gleichermaßen relevant. Bei rein dekorativen Bildern sollte man dieses Feld bewusst leer lassen.
Prüfen Sie die Referenzanzahl, bevor Sie eine Datei löschen. Zeigt die Spalte "Ref" eine Zahl größer als 0, ist die Datei noch in Verwendung. Entfernen Sie sie aus den referenzierenden Elementen und löschen Sie die Datei danach.
Nutzen Sie die Funktion "Ersetzen" für Dateiaktualisierungen. Wird eine Datei über "Ersetzen" ausgetauscht, bleibt die FAL-ID erhalten: Die neue Version erscheint sofort an allen Stellen, ohne dass Inhaltselemente angepasst werden müssen.
Aktivieren Sie die Zwischenablage im Mehrfachauswahlmodus für effizientes Verschieben oder Kopieren mehrerer Dateien in einem Arbeitsschritt.
Speichern Sie keine sensiblen Dokumente ohne Zugriffsschutz in fileadmin/. Der Standardordner ist öffentlich erreichbar. Für geschützte Downloads ist eine spezielle TYPO3-Erweiterung oder ein separater privater Dateispeicher erforderlich.

Häufige Fragen zur Dateiliste

Kann ich eine Datei umbenennen, ohne dass Links im Frontend kaputt gehen?

Ja. TYPO3 speichert intern eine eindeutige Datei-ID. Inhaltselemente referenzieren auf diese ID, nicht auf den Dateinamen oder Pfad.

Benennen Sie die Datei in der Dateiliste um: Alle internen Verlinkungen werden automatisch aktualisiert.

Externe Links (z. B. aus E-Mails oder anderen Websites) werden jedoch nicht mehr funktionieren, weil sich die öffentliche URL der Datei ändert. Hier hilft nur eine Umleitung über das Redirects-Modul von TYPO3 oder eine Weiterleitung in der Webserver-Konfiguration.

Was passiert, wenn ich eine Datei lösche, die noch in einem Inhaltselement verwendet wird?

Die Datei wird sofort vom Server entfernt. An allen Stellen, an denen sie eingebunden war, erscheint ein leeres Bildfeld oder ein 404-Fehler für Downloads. TYPO3 warnt in der Dateiliste über die Referenzanzahl. Löschen Sie nur Dateien mit dem Wert 0 in der Referenzspalte oder entfernen Sie vorher alle Einbindungen.

Muss ich Metadaten in jedem Inhaltselement neu eintragen?

Nein. Metadaten, die Sie direkt an der Datei in der Dateiliste pflegen (Alt-Text, Titel, Bildunterschrift), werden automatisch in Inhaltselemente übernommen, wenn die Datei dort eingebunden wird. Eine erneute Eingabe ist nur nötig, wenn ein bestimmtes Inhaltselement eine abweichende Beschriftung benötigt.

Wie schränke ich ein, welche Redakteure welche Ordner sehen und bearbeiten dürfen?

Über sogenannte Verzeichnisfreigaben, die in den Benutzergruppen konfiguriert werden. Einer Verzeichnisfreigabe wird ein Startordner zugewiesen sowie eine Berechtigung (Lesen / Schreiben). Ein Redakteur sieht in der Dateiliste nur die Ordner, für die seiner Gruppe eine Verzeichnisfreigabe eingerichtet wurde.

Was ist der Unterschied zwischen der Dateiliste und dem Modul Liste?

Im Modul Liste werden Datensätze und Inhaltselemente angelegt und bearbeitet. In der Dateiliste werden Medien wie Bilder und Videos sowie andere Dateien hochgeladen, um sie anschließend mit Inhaltselementen zu verknüpfen. Beide Module teilen sich die Zwischenablage-Funktion.

Wie groß darf eine Datei sein, die ich hochlade?

Die maximale Dateigröße wird serverseitig konfiguriert und ist je nach TYPO3-Installation unterschiedlich. Typische Standardwerte liegen zwischen 20 MB und 64 MB. Der zuständige Administrator kann den Grenzwert in der PHP-Konfiguration (upload_max_filesize, post_max_size) und in der TYPO3-Systemkonfiguration anpassen.

Ihre Frage war nicht dabei? Kontaktieren Sie mich, damit ich sie gleich beantworten kann.

Begriff	Beschreibung
File Abstraction Layer	Technische Grundlage der Dateiliste: Verwaltet Dateien über eindeutige IDs statt über direkte Dateipfade. Kurzform: FAL.
Verzeichnisfreigabe	Konfiguriert, welche Ordner ein Backend-Benutzer in der Dateiliste sehen und bearbeiten darf. Englisch: File Mount.
Dateispeicher	Definiert, wo und wie Dateien abgelegt werden (lokal, extern, privat). Die Dateiliste zeigt immer mindestens einen Dateispeicher. Englisch: File Storage.
Inhaltselement	Verwendet Dateien aus der Dateiliste über Referenzen: Bild, Textmedia, Download usw. Mehr über Inhaltselemente.
Alternativer Text	Pflichtfeld für Barrierefreiheit, das in den Metadaten der Dateiliste gepflegt und automatisch in Inhaltselemente übernommen wird. Kurzform: Alt-Text.
Zwischenablage	Ermöglicht das gleichzeitige Kopieren oder Verschieben mehrerer Dateien und Ordner innerhalb der Dateiliste. Englisch: Clipboard.
Benutzergruppen	Steuern über Verzeichnisfreigaben und Zugriffsrechte, was Redakteure in der Dateiliste sehen und tun dürfen.