--- title: "Overlays in TYPO3 verstehen: Nutzung der Leistungsfähigkeit der TYPO3 Core API" url: "https://b13.com/de/wissen/lokalisierung-und-content-staging-meistern" description: Entdecke die Eleganz und Effizienz von TYPO3-Overlays. Erfahre, wie die TYPO3 Core API die Lokalisierung und die Bereitstellung von Inhalten automatisiert und durch intelligente Referenzierung ein nahtloses Content-Management gewährleistet. image: "https://b13.com/fileadmin/_processed_/b/7/csm_OverlaysExplained_Sharing_039168d1de.png" date: 2025-03-10 modified: 2026-08-19 lastUpdated: 2026-08-19 --- # Overlays in TYPO3 verstehen: Nutzung der Leistungsfähigkeit der TYPO3 Core API [ Localization ](https://b13.com/de/wissen/localization) [ Workspaces ](https://b13.com/de/wissen/workspaces) [ TYPO3 ](https://b13.com/de/wissen/typo3) Die elegante Funktionalität von TYPO3-Overlays ================================================ Lokalisierung und Content-Staging meistern ![](https://b13.com/fileadmin/_processed_/c/6/csm_benni_5e519221c4.jpg)Benni Mack 09. Mai 2025 [ RSS Feed ](https://b13.com/de/rss.xml) ![Abstrakte Darstellung überlappender Browserfenster und UI-Elemente, die das Konzept von Overlays in der Webentwicklung veranschaulicht.](https://b13.com/fileadmin/_processed_/8/9/csm_OverlaysExplained_Headerbild_e6227b1973.webp) In diesem Blogbeitrag wird das Konzept des „Overlays“-Mechanismus in TYPO3 erklärt, mit einigen detaillierten Einblicken, wie die TYPO3 Core Engine mit dieser Funktion unter der Haube umgeht. Einführung in Overlays ------------------------ Overlays werden in zwei wichtigen Funktionen von TYPO3 verwendet: - **Lokalisierung von Daten**. Lokalisierung in ihrer einfachsten Form ist eine 1:1-Übersetzung jedes einzelnen Inhalts auf deiner Website. - **Inhaltsbereitstellung von Daten („Workspaces“)**. Workspaces sind ein Mechanismus zum Hinzufügen oder Ändern von Inhalten, zur Vorschau und für einen definierten Veröffentlichungs-Workflow, bevor deine Besucher neue Inhalte auf deiner Website sehen. Bühne frei für Overlays ------------------------- ### Erstmalige Einrichtung: Nur Englisch, Live-Inhalte Beginnen wir mit einem einfachen Beispiel: eine Website auf Englisch, ohne Übersetzungen und ohne Workspaces. Ein Inhaltselement (Datensatz des Typs „tt\_content“) wird auf der Website in der „Standardsprache“ und als „Live-Datensatz“ angezeigt. In der Datenbank hat dieser Datensatz eine „uid“, eine numerische Darstellung des Inhalts, auf den verwiesen oder verlinkt werden kann. In unserem Beispiel hat dieser Datensatz die uid=13. ![Screenshot des Originalelements im TYPO3-Backend](https://b13.com/fileadmin/_processed_/3/a/csm_Screenshot_2025-03-10_at_16.37.47_4da945114c.webp) Inhaltselement in Standardsprache (uid=13). ### Hinzufügen einer Übersetzung Fügen wir nun eine zweite Sprache, beispielsweise „Hebräisch“, zur Website hinzu. Als Nächstes aktualisieren wir unser Inhaltselement, indem wir den Inhalt ins Hebräische übersetzen. Dies ist die „übersetzte Sprache“ und es handelt sich immer noch um einen „Live-Datensatz“, sodass der Inhalt öffentlich ist, sobald wir auf die Schaltfläche „Speichern“ klicken. ![Screenshot des übersetzten Elements im TYPO3-Backend](https://b13.com/fileadmin/_processed_/0/a/csm_Screenshot_2025-03-10_at_16.41.22_970f666add.webp) Inhaltselement, in eine andere Sprache übersetzt (uid=14). Intern wird ein neuer Datensatz, uid=14, erstellt, der auf uid=13 als „Übersetzungs-Elternteil“ (normalerweise ein Feld namens „l10n\_parent“) verweist, bei dem es sich um den „Standardsprache“-Datensatz handelt. ### Hinzufügen eines Workspace zur Kombination Fügen wir einen benutzerdefinierten Arbeitsbereich mit dem Namen „Staging-Arbeitsbereich“ hinzu, damit wir an unveröffentlichten Inhalten arbeiten können, ohne die Live-Website zu beeinträchtigen. Hier sehen wir alle Inhalte des aktuellen „Live-Arbeitsbereichs“, bis etwas geändert wird. Wenn etwas in der „Standardsprache“ geändert wird, wird eine Kopie dieses Datensatzes mit uid=15 erstellt. Diese Kopie, die wir „versionierter Datensatz“ nennen, befindet sich im Workspace ID=1 und ist mit dem „Live-Datensatz“ verbunden, der in der Datenbank in einem Feld namens „t3ver\_oid“ (oid steht für Online-ID) gespeichert ist. ![Screenshot eines aktualisierten Elements in einem TYPO3-Arbeitsbereich](https://b13.com/fileadmin/_processed_/3/a/csm_Screenshot_2025-03-10_at_16.37.47_4da945114c.webp) Inhaltselement in Standardsprache, jetzt in einem TYPO3-Workspace (uid=14) bearbeitet. Wir können nun eine Vorschau des geänderten („versionierten“) Inhalts anzeigen und auch die Übersetzung ändern. Auf diese Weise erhalten wir eine weitere Kopie (uid=16), diesmal aus der „Übersetzungssprache“ des „Live-Datensatzes“, wodurch dieser zum „versionierten Datensatz der Übersetzungssprache“ wird. ![Screenshot der betroffenen Zeilen in unserem Beispiel in der Datenbank](https://b13.com/fileadmin/_processed_/7/a/csm_Screenshot_2025-03-10_at_16.54.41_3b7e671daa.webp) Liste der Datenbankeinträge für unser Beispiel aus der TYPO3-Tabelle „tt\_content“. Die Mechanik und das Schöne an Overlays ----------------------------------------- Hier werden Overlays eingesetzt. TYPO3 verwendet Overlays im Hintergrund, wenn eine Seite mit Inhalten in einer Übersetzung oder in einem Arbeitsbereich (oder in beiden) in der Vorschau angezeigt wird. Damit dies funktioniert, verfügt TYPO3 über ein [„Context“-Objekt](https://docs.typo3.org/m/typo3/reference-coreapi/main/en-us/ApiOverview/Context/Index.html#context-api), in dem der aktuelle Workspace (ID) und die Sprache (ID) gespeichert sind. TYPO3 ruft zunächst immer die „Standardsprache des Live-Datensatzes“ ab (Sprache=0 und Workspace=0) und überprüft dann für jeden einzelnen Datensatz, ob es einen versionierten Datensatz dieser „Standardsprache“ gibt (durch Suche nach einem Datensatz mit „t3ver\_oid=13“ und „t3ver\_wsid=1“), und ersetzt alle Informationen dieses Datensatzes durch den versionierten Datensatz. Die tatsächliche „uid“ wird jedoch beibehalten. Dies wird in TYPO3 als „Overlays“ bezeichnet. Wenn kein versionierter Datensatz gefunden wird, bleibt TYPO3 bei der Live-Version. Die technische Raffinesse von Overlays: Durch das Beibehalten der „uid“ bleibt jede Referenz oder jeder Link zu diesem Inhalt weiterhin mit der „Live-Version“ verbunden, sodass TYPO3 nicht alle Links ersetzen und anpassen muss, wenn ein versionierter Datensatz erstellt wird. Wenn der TYPO3-Editor die hebräische Übersetzung anfordert, sucht TYPO3 nach einem „Sprach-Overlay“ und prüft, ob in der „Live-Version“ ein Datensatz vorhanden ist, dessen „Übersetzungs-Elternteil“ auf uid=13 (die Live-Standardsprache) gesetzt ist. Im Staging-Workspace wird auch die hebräische Version auf einen versionierten Datensatz überprüft. ### Eine vereinfachte Ansicht von Overlays sieht so aus: - Inhalt in der Standard-Sprache - Lokalisierter hebräischer Inhalt - Inhalt in der Standardsprache - Versionierter Datensatz - Lokalisierter hebräischer Inhalt - Versionierter Datensatz des lokalisierten Datensatzes TYPO3 erledigt all dies im Hintergrund. Mit der TYPO3 Core API zum Lesen (PageRepository) und Schreiben (DataHandler) wird all dies für dich erledigt! Vorteile des Overlay-Mechanismus ---------------------------------- ### TYPO3 fragt immer zuerst die „Standardsprache“ des „Live Workspace“ ab. Dies ist einer der Hauptgründe, warum das Konzept einer „Standardsprache“ und ihre Verbindung dazu existiert. Darüber hinaus ermöglicht dies eine weitere Funktion von TYPO3: Fallbacks. Auch wenn man vor allem über Fallbacks im TYPO3-Ökosystem liest, sind Fallbacks eigentlich eine Folge von Overlays — eine Funktion, die möglich ist, weil TYPO3 auf Overlays aufbaut. ### Wenn keine Sprachüberlagerung gefunden werden kann, kannst du entscheiden, was passiert. Die sogenannten „Fallback-Modi“ bei der Konfiguration einer Seitensprache werden nun angewendet: - **Strikt-Modus:** Wenn keine hebräische Übersetzung gefunden wird, zeige nicht einmal die Standardsprache an. Der nicht übersetzte Inhalt wird einfach nicht angezeigt. - **Fallback-Modus:** Wenn keine hebräische Übersetzung gefunden wird, zeige die englische Version an. - **Freier Modus:** Die Standardsprache nicht abfragen (= keine Overlay-Technologie verwenden). Dies ist nützlich, wenn deine Sprache nicht an die Standardsprache gebunden ist. Außerdem habe ich den Begriff *„Floating Records“* geprägt — Datensätze innerhalb einer Übersetzung, die kein Overlay haben, können weiterhin gerendert werden. Stell dir ein Teaser-Element auf einer Seite vor, das nur in der polnischen Version angezeigt werden soll — das ist ein Floating Record. Dieser Datensatz folgt jedoch nicht der Sortierung und Reihenfolge des Overlay-Mechanismus. ### In Workspaces werden nur geänderte oder neu erstellte Datensätze dupliziert. Anstatt die gesamte Datenbank für die Versionierung zu klonen, verwaltet TYPO3 die versionierten Inhalte automatisch für dich, indem es nur die geänderten Inhalte kopiert. ### Beim Veröffentlichen eines Workspace werden lediglich Inhalte ausgetauscht. Während des Veröffentlichungsprozesses behält TYPO3 die „Live-Version“ bei und tauscht lediglich die geänderten Felder in die vorhandenen Live-Datenbankeinträge aus. Zusammenfassung ----------------- Inzwischen solltest du verstehen, warum TYPO3 so leistungsstark ist. Die Verwendung der nativen APIs von TYPO3 erledigt alles für dich. Wenn du daran interessiert bist, dein Projekt gemeinsam mit uns zu betrachten, können wir prüfen, ob dein Projekt die TYPO3-APIs richtig nutzt. Ruf uns an. [ Kontakt aufnehmen ](https://b13.com/de/kontakt) ### Geschrieben von: ![Lächelnder Mann mit kurzen Haaren und einem Bart, der ein weinrotes Hemd trägt, steht in einer modernen Innenumgebung mit unscharfen Hintergrundelementen.](https://b13.com/fileadmin/_processed_/c/6/csm_benni_66cce9a81f.webp) Der Mitbegründer von b13 und Leiter des TYPO3 CMS Core Developement, Benni Mack, bestimmt maßgeblich unsere technischen Best-Practises. Er ist zuständig für den Aufbau und die Wartung unserer technischen Infrastruktur und koordiniert unseren Beitrag zum Open-Source-Projekt. Sein wesentliches Werkzeug: TYPO3 Benni Mack CTO [ mehr von Benni Mack ](https://b13.com/de/team/benni-mack) Ähnliche Artikel ------------------ - ![Cartoon-Trophäenfigur umgeben von Händen, die Daumen hoch und ein Herzzeichen geben, vor einem Hintergrund mit Zahnradmuster.](https://b13.com/fileadmin/_processed_/f/7/csm_T3ppy_Design_Kit_Headerbild_b51eb9dc31.webp) ### T3ppy gibt TYPO3 ein freundliches Gesicht 06. August 2026 | Florian “Flix” Keitgen TYPO3 ist leistungsstark — muss sich aber nicht unpersönlich anfühlen. Das ist T3ppy, unser freundlicher Begleiter fürs Backend. [ weiterlesen: T3ppy gibt TYPO3 ein freundliches Gesicht ](https://b13.com/de/wissen/t3ppy-design-kit) - ![Hammer mit der Aufschrift 'KI' auf einem schaltkreis-musternden Hintergrund mit gelben Sternen, der Regulierung oder Gesetzgebung im Zusammenhang mit künstlicher Intelligenz in der EU symbolisiert.](https://b13.com/fileadmin/_processed_/1/0/csm_EUAIAct_Headerbild_510724b3de.webp) ### KI-Inhalte in TYPO3: Transparenz braucht Verantwortung 02. August 2026 | Benni Mack Der EU AI Act rückt die Herkunft KI-generierter Inhalte in den Fokus. AI Label kennzeichnet KI-generierte und KI-bearbeitete Inhalte in TYPO3 und dokumentiert, wer den… [ weiterlesen: KI-Inhalte in TYPO3: Transparenz braucht Verantwortung ](https://b13.com/de/wissen/ai-content-in-typo3-labelling-needs-accountability) - ![Eine Reihe stilisierter Figuren in verschiedenen Posen, jede mit einem markanten orangefarbenen Hut, zeigt einen Übergang vom Gehen zum Stillstehen, während sie auf ein Handy schauen, vor einem lila Gitterhintergrund.](https://b13.com/fileadmin/_processed_/d/7/csm_QueuesDDEV_Headerbild_f640931350.webp) ### Bessere Skalierbarkeit mit entkoppelten Queues: So richtest du RabbitMQ mit TYPO3 ein 10. April 2024 | Jochen Roth Wenn integrierte Nachrichtentransporte an ihre Grenzen stoßen, kann RabbitMQ TYPO3 mit einer skalierbaren, robusten Message Queue versorgen. [ weiterlesen: Bessere Skalierbarkeit mit entkoppelten Queues: So richtest du RabbitMQ mit TYPO3 ein ](https://b13.com/de/wissen/bessere-skalierbarkeit-mit-entkoppelten-queues-so-richtest-du-rabbitmq-mit-typo3-ein) - ![Eine Cartoonfigur, die einem Schild ähnelt, gibt ein Daumen hoch vor einer Computeroberfläche mit verschiedenen Menüoptionen.](https://b13.com/fileadmin/_processed_/e/6/csm_Header_cda1f80173.webp) ### Gestatten, T3ppy! Ein neues Zeitalter für die Redaktionsarbeit in TYPO3 01. April 2026 | Florian “Flix” Keitgen Entdecke T3ppy und AiM — Deine KI-Assistenz im TYPO3 Backend für bessere Inhalte, klare Strukturen und volle Kontrolle über Redaktions-Prozesse. [ weiterlesen: Gestatten, T3ppy! Ein neues Zeitalter für die Redaktionsarbeit in TYPO3 ](https://b13.com/de/wissen/gestatten-t3ppy-ein-neues-zeitalter-fuer-die-redaktionsarbeit-in-typo3) - ![Retro-Mikrofon-Illustration mit einem Einkaufswagen-Symbol im Hintergrund, das E-Commerce oder Online-Shopping symbolisiert.](https://b13.com/fileadmin/_processed_/f/8/csm_Marketplace_Headerbild_ee1575614c.webp) ### Warum TYPO3 einen Marketplace für Produkte braucht 25. März 2026 | Florian “Flix” Keitgen Ein Marketplace würde TYPO3-Produkte sichtbarer machen, den Vergleich erleichtern und Agenturen sowie Kunden gleichermaßen profitieren lassen. [ weiterlesen: Warum TYPO3 einen Marketplace für Produkte braucht ](https://b13.com/de/wissen/warum-typo3-einen-marketplace-fuer-produkte-braucht) - ![Eine Hand hält eine Lupe über den Laptop-Bildschirm, der eine Webseite mit einem Bild und Textelementen anzeigt.](https://b13.com/fileadmin/_processed_/e/5/csm_BackendUserSection_Headerbild_6093c842fd.webp) ### Ein echter Geheimtipp in TYPO3: Die Backend User Section (Doktype 6) 05. März 2026 | David Steeb Entdecke den oft unterschätzten Doktype 6 (Backend User Section) in TYPO3 für sichere interne Vorschauen, Redaktionstrainings und Prototyping. Erfahre praxisnahe Anwendungsfälle,… [ weiterlesen: Ein echter Geheimtipp in TYPO3: Die Backend User Section (Doktype 6) ](https://b13.com/de/wissen/ein-echter-geheimtipp-in-typo3-die-backend-user-section-doktype-6) - ![Zwei stilisierte Webseiten-Designs mit einem Benutzerprofil, Platzhaltern für Bilder und Textabschnitten, vor einem hellblauen Hintergrund.](https://b13.com/fileadmin/_processed_/2/0/csm_BackendPreview_Headerbild_b4c5799cfa.webp) ### Backend-Content-Previews mit System — warum wir EXT:backendpreviews entwickelt haben 09. Februar 2026 | David Steeb EXT:backendpreviews sorgt für konsistente Content-Previews im TYPO3-Backend mit Fluid Templates, Layouts und Partials. [ weiterlesen: Backend-Content-Previews mit System — warum wir EXT:backendpreviews entwickelt haben ](https://b13.com/de/wissen/backend-content-previews-mit-system-warum-wir-extbackendpreviews-entwickelt-haben) - ![Eine menschliche Hand schüttelt eine Roboterhand vor einem lila Hintergrund mit Herzmustern, was die Zusammenarbeit zwischen Menschen und Technologie symbolisiert.](https://b13.com/fileadmin/_processed_/6/2/csm_AIbotsLoveMarkdown_Headerbild_72fe5820d6.webp) ### Das Internet ist nicht mehr nur für Menschen — KI-Bots lieben Markdown 28. Januar 2026 | Benni Mack Discover why most web traffic is now automated and how TYPO3’s structured content model prepares websites for humans, editors, and AI systems. [ weiterlesen: Das Internet ist nicht mehr nur für Menschen — KI-Bots lieben Markdown ](https://b13.com/de/wissen/das-internet-ist-nicht-mehr-nur-fuer-menschen-ki-bots-lieben-markdown) - ![Mehrere farbenfrohe Mockups von Webseiten, die übereinander gestapelt sind und verschiedene Layouts sowie Designelemente vor einem lila Hintergrund präsentieren.](https://b13.com/fileadmin/_processed_/e/3/csm_CaminoTheme_Headerbild_d082598009.webp) ### Camino—The Need for a Default Theme in TYPO3 Is Real 27. Januar 2026 | Benni Mack With TYPO3 v14, Camino introduces a default theme that removes friction from first installs. Why this matters—and how TYPO3 laid the groundwork. - ![Zwei ineinandergreifende Zahnräder mit einem getrennten elektrischen Stecker und einem Etikett mit der Aufschrift 'v13' auf lila Hintergrund.](https://b13.com/fileadmin/_processed_/0/7/csm_TYPO3v13_Headerbild_14eb602ce4.webp) ### Was gibt’s Neues in TYPO3 v13? 20. Januar 2026 | Desirée Lochner Mit TYPO3 v13 beginnt eine neue Ära der Nutzerfreundlichkeit. Die Version begeistert mit einer modernen, frischen und unglaublich performanten Benutzeroberfläche — entwickelt für… [ weiterlesen: Was gibt’s Neues in TYPO3 v13? ](https://b13.com/de/loesungen/typo3/was-gibts-neues-in-typo3-v13)