Dateiliste

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.

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

1. Öffnen Sie im Backend das Modul "Datei › Dateiliste".
2. Wählen Sie im Verzeichnisbaum links den Zielordner aus (z. B. fileadmin/bilder/news/).
3. Klicken Sie oben auf das Upload-Symbol oder ziehen Sie Dateien per Drag-and-drop in die Dateiliste.
4. Nach dem Upload erscheint die Datei in der Liste. Klicken Sie auf das Stiftsymbol neben dem Dateinamen, um die Metadaten zu öffnen.
5. Tragen Sie mindestens den Alt-Text ein (Pflicht für Barrierefreiheit) sowie optional Titel, Bildunterschrift und Urheber.
6. 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.

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.

• 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.