TYPO3 14 Medien

Eine Datei in TYPO3 14 ersetzen, ohne die Verlinkungen zu verlieren

Ein PDF bekommt eine neue Ausgabe, ein Bild einen neuen Stand. Wer die neue Datei danebenlegt und die alte löscht, sucht anschließend jede Seite zusammen, die darauf gezeigt hat. TYPO3 14 tauscht die Datei stattdessen an Ort und Stelle aus: Die Verlinkungen bleiben, der Dateiname auf Wunsch auch. Diese Fassung zeigt den Weg im Modul „Medien“.

Stand: 18.09.2026

Wie TYPO3 eine Datei verlinkt

Eine Datei liegt in TYPO3 nicht auf der Seite, auf der sie erscheint. Sie liegt im Modul „Medien“, und jede Stelle, die sie zeigt oder zum Herunterladen anbietet, verweist auf sie. Der Verweis zeigt auf die Nummer, unter der TYPO3 die Datei als Datensatz führt. Ordner und Dateiname spielen darin keine Rolle.

Das ist Buchhaltung, und sie entscheidet, was beim Austauschen passiert. Bleibt die Nummer, bleibt jeder Verweis gültig: das Bild im Inhaltselement, die Datei im Element „Dateilinks“ und der Link mitten im Text. Wer die neue Fassung als zweite Datei hochlädt und die alte löscht, hat dagegen zwei Datensätze und zieht jede Verwendung von Hand nach.

Modul „Medien“ mit dem Ordnerbaum „Redaktion“ › „dokumente“ und einer Kachel für die Datei „trinkwasseranalyse.pdf“ mit Vorschau und Datum. — Ein eigener Ordner „dokumente“ neben dem Ordner „bilder“ hält die Ablage übersichtlich. Für die Verlinkungen ist es ohne Bedeutung, in welchem Ordner eine Datei liegt.

Welche Stellen an einer Datei hängen, weiß TYPO3 selbst. Im Kontextmenü der Datei führt der Eintrag „Info“ zu einem Fenster, das unten den Abschnitt „Referenzen“ zeigt: eine Zeile je Verwendung, mit Titel des Inhaltselements und Feld.

Öffnen Sie im Modul „Medien“ den Ordner mit der Datei.

Klicken Sie mit der rechten Maustaste auf die Datei.
Wählen Sie „Info“.
Rollen Sie im Fenster nach unten bis zum Abschnitt „Referenzen“.

Fenster „Datei: trinkwasseranalyse.pdf“, gerollt zum Abschnitt „Referenzen“. Die Tabelle „Referenzen auf dieses Element“ führt zwei Seiteninhalte auf: „Trinkwasseranalyse zum Herunterladen“ im Feld „Dateien“ und „Trinkwasser in Emscherlohe“ im Feld „Text“ mit dem Softref-Schlüssel typolink_tag. — Beide Zeilen meinen dieselbe Datei. Die zweite kommt aus einem Link im Fließtext; das verrät der Eintrag „typolink_tag“ in der Spalte „Softref-Schlüssel“.

Der Link im Texteditor

Am deutlichsten sehen Sie das im Texteditor. Ein Link auf eine Datei sieht dort aus wie jeder andere, und was der Editor wirklich speichert, zeigt der Knopf „Quelle“ in der zweiten Zeile der Leiste: Er schaltet das Feld „Text“ auf den Quelltext um.

Öffnen Sie im Modul „Inhalt“ › „Layout“ die Seite mit dem Text, der auf die Datei verweist.

Klicken Sie in der Kopfzeile des Elements auf das Stift-Symbol.
Klicken Sie im Feld „Text“ in der Leiste auf „Quelle“.
Lesen Sie die Adresse im Link.
Klicken Sie oben rechts auf „Schließen“. Ein Blick in den Quelltext ändert nichts, TYPO3 fragt deshalb nicht nach.

Bearbeitungsfeld „Trinkwasser in Emscherlohe“ von TYPO3 14 über der rechten Fensterhälfte. Das Feld „Text“ zeigt den Quelltext mit dem Link t3://file?uid=7 auf das Wort „Trinkwasseranalyse“; in der Leiste darüber ist der Knopf „Quelle“ markiert. — Im Quelltext steht kein Pfad und kein Dateiname. Deshalb übersteht der Link den Austausch, und eine zweite Datei daneben würde ihn brechen.

Im Link steht t3://file?uid=7. Die 7 ist die Nummer der Datei, dieselbe, die im Info-Fenster in eckigen Klammern hinter dem Dateinamen steht. Beim Ausliefern der Seite setzt TYPO3 daraus die Adresse zusammen, die der Besucher anklickt. Ändert sich der Inhalt der Datei, bleibt der Link, wie er ist.

Eine Datei ersetzen

Für den Austausch hat das Kontextmenü einer Datei den Eintrag „Ersetzen“. Er schiebt den Inhalt der neuen Datei in den vorhandenen Datensatz: gleiche Nummer, gleicher Ordner, neuer Inhalt. Alle Verweise darauf gelten weiter, ohne dass ein Inhaltselement angefasst wird.

Öffnen Sie im Modul „Medien“ den Ordner mit der Datei, und halten Sie die neue Fassung auf Ihrem Rechner bereit.

Klicken Sie mit der rechten Maustaste auf die Datei.
Wählen Sie „Ersetzen“.
Wählen Sie im Fenster unter „Neue Datei auswählen“ die neue Fassung von Ihrem Rechner.
Lassen Sie den Haken bei „Aktuellen Dateinamen beibehalten?“ stehen, wenn die Adresse der Datei gleich bleiben soll.
Klicken Sie auf „Ersetzen“.

Geöffnetes Kontextmenü einer Datei im Modul „Medien“ mit den Einträgen „Metadaten dieser Datei bearbeiten“, „Ersetzen“, „Umbenennen“, „Herunterladen“, „Info“, „Kopieren“, „Ausschneiden“ und „Löschen“; „Ersetzen“ ist markiert. — „Umbenennen“ darunter tauscht den Namen und lässt den Inhalt stehen, „Ersetzen“ macht es umgekehrt. Beides betrifft denselben Datensatz.

Fenster „Datei ‚trinkwasseranalyse.pdf‘ ersetzen“ mit Vorschau, Name, Größe und Erstelldatum der alten Datei, dem Bereich „Neue Datei auswählen“ mit der gewählten Datei und dem angehakten Kästchen „Aktuellen Dateinamen ‚trinkwasseranalyse.pdf‘ beibehalten?“; unten die Schaltflächen „Abbrechen“ und „Ersetzen“. — Name, Größe und Datum im Fenster gehören zur alten Datei, also zu dem, was gleich verschwindet. Der Knopf zum Auswählen gehört zum Browser und heißt je nach Programm anders.

Fenster „Datei: trinkwasseranalyse.pdf“ nach dem Ersetzen: Dateiname mit der Nummer 7 in eckigen Klammern, Erstelldatum und letzte Änderung, darunter die Vorschau der neuen Ausgabe 2026 und die Schaltflächen „Anzeigen“ und „Metadaten dieser Datei bearbeiten“. — Der Dateiname und die Nummer sind dieselben wie vorher, die Vorschau zeigt die neue Ausgabe. Auch das Erstelldatum steht jetzt auf dem Tag des Austauschs und nicht mehr auf dem Tag des ersten Hochladens.

Den Dateinamen behalten oder aufgeben

Die Verlinkungen halten so oder so; das Kästchen im Dialog entscheidet über die Adresse, unter der die Datei erreichbar ist. Mit Haken behält sie ihren alten Namen, auch wenn die neue Datei auf Ihrem Rechner anders heißt. Ohne Haken zieht der neue Name mit ein, und TYPO3 bereinigt ihn dabei: Leerzeichen und Sonderzeichen weichen einem Unterstrich.

Wichtig wird das überall dort, wo die Adresse der Datei das Backend verlassen hat: in einem Newsletter, auf einem gedruckten Blatt, in einem QR-Code, in der Verlinkung einer anderen Website. Solche Adressen führen über den Dateinamen zur Datei. Bleibt der Name, bleiben sie gültig; ändert er sich, laufen sie ins Leere.

Nehmen Sie den Haken heraus, wenn der neue Name besser passt und die alte Adresse nirgends steht.

Fenster „Datei ‚kundencenter.jpg‘ ersetzen“ mit dem Bild und seinen Angaben, der gewählten neuen Datei und dem leeren Kästchen „Aktuellen Dateinamen ‚kundencenter.jpg‘ beibehalten?“, das markiert ist. — Ohne Haken heißt die Datei anschließend wie die neue. Weil der Haken voreingestellt ist, treffen Sie mit dem Herausnehmen eine bewusste Entscheidung.

Ordner „bilder“ im Modul „Medien“ mit vier Kacheln: „oekostrom.jpg“, „team.jpg“, „trinkwasserbrunnen.jpg“ und „wasserwerk.jpg“. Eine Kachel „kundencenter.jpg“ gibt es nicht mehr. — Im Ordner steht jetzt der neue Name. Verloren gegangen ist dabei nichts: Hinter der Kachel liegt derselbe Datensatz wie vorher.

Die Seite „Kundencenter“ im Modul „Inhalt“, Punkt „Layout“, mit dem Element „Text & Bilder“ „Kundencenter am Markt“. Unter dem Text steht die Vorschau des neuen Bildes. — Das Inhaltselement wurde nicht angefasst und zeigt trotzdem das neue Bild. Auch die Vorschau im Backend zieht von selbst nach.

Was beim Ersetzen nicht mitkommt

Ausgetauscht wird der Inhalt der Datei. Titel, alternativer Text, Beschreibung und Kategorien hängen am Datensatz und stehen nach dem Austausch unverändert da. Das ist gewollt, wird aber zur Falle, wenn die Beschreibung die alte Fassung meint: Ein alternativer Text zum Titelblatt der Ausgabe 2025 steht danach über einem Dokument, das es so nicht mehr gibt.

Öffnen Sie nach dem Ersetzen das Kontextmenü der Datei und wählen Sie „Metadaten dieser Datei bearbeiten“.

Häufige Fragen zum Ersetzen von Dateien in TYPO3 14

Bleiben in TYPO3 14 die Verlinkungen erhalten, wenn ich eine Datei ersetze?

Ja. Klicken Sie im Modul „Medien“ mit der rechten Maustaste auf die Datei und wählen Sie „Ersetzen“. TYPO3 14 tauscht den Inhalt aus und behält den Datensatz mit seiner Nummer. Damit bleibt jeder Verweis darauf gültig, auch der Link mitten in einem Text. Wer die neue Fassung stattdessen als zweite Datei hochlädt und die alte löscht, zieht jede Stelle von Hand nach.

Was bewirkt der Haken „Aktuellen Dateinamen beibehalten?“ in TYPO3 14?

Er entscheidet über die Adresse der Datei, nicht über die Verlinkungen. Mit Haken behält die Datei ihren alten Namen, ein weitergegebener Download-Link bleibt also gültig. Ohne Haken übernimmt TYPO3 14 den Namen der neuen Datei und bereinigt ihn dabei. Im Backend funktioniert danach alles weiter, die alte Adresse aber führt ins Leere. Voreingestellt ist der Haken.

Wo sehe ich in TYPO3 14, welche Seiten eine Datei verwenden?

Im Kontextmenü der Datei unter „Info“. Das Fenster zeigt unten den Abschnitt „Referenzen“ mit einer Zeile je Verwendung: Titel des Inhaltselements, Tabelle, Nummer und Feld. Steht in der Spalte „Softref-Schlüssel“ der Wert „typolink_tag“, kommt der Verweis aus einem Link im Text. So sehen Sie vor dem Austausch, was sich danach überall ändert.