TYPO3 Content Blocks: Migration von Mask vor dem Update auf TYPO3 14
Stand: 9. Oktober 2026
Für die Extension Mask, mit der viele TYPO3-Websites ihre eigenen Inhaltselemente umsetzen, gibt es keine Version für TYPO3 14, und die Bugfixes sind beendet. Für Ihr TYPO3 Update bedeutet das: Mask-Elemente müssen vor dem Wechsel auf TYPO3 14 auf TYPO3 Content Blocks umgestellt sein. Die Umstellung betrifft Felddefinitionen, Bestandsdaten und Templates der Elemente gleichermaßen.
TYPO3 Content Blocks: eigene Inhaltselemente per YAML-Konfiguration
TYPO3 Content Blocks ist eine Extension, mit der Sie eigene Inhaltselemente per YAML-Konfiguration definieren. Die TYPO3-Community verfolgt diesen Ansatz offiziell, und er steht seit TYPO3 13 zur Verfügung. Ein Block bündelt Konfiguration, Frontend-Template und Beschriftungen eines Elements an einem Ort. TCA, TypoScript und Datenbankfelder müssen Sie dafür nicht mehr getrennt pflegen. Weil die Beschreibung als Datei vorliegt, lässt sie sich wie anderer Code versionieren und im Team prüfen.
Aufbau eines Content Blocks: Konfiguration, Template und Sprachdateien
Für die Umstellung gilt eine einfache Zuordnung, die Sie als Arbeitsgrundlage nutzen können:
- Mask-Element: wird zu genau einem Content Block. Das Inventar der Mask-Elemente ist damit zugleich die Liste der Blocks, die entstehen. Nicht mehr verwendete Elemente müssen Sie nicht übertragen.
- Mask-Felder: erscheinen im Block als Einträge der YAML-Konfiguration. Ob jeder Feldtyp eine direkte Entsprechung hat, prüfen Sie im Einzelfall.
- Element-Template: wird zum Frontend-Template des Blocks.
- Beschriftungen im Backend: gehören beim Block zur selben Einheit wie die Konfiguration.
Content Blocks und Mask im Vergleich
Nicht jedes Element lässt sich eins zu eins übertragen. Diese Fälle sollten Sie im Inventar gesondert markieren und im Einzelfall prüfen:
- Wiederholbare Felder: Hier muss geklärt werden, wie der Block die Mehrfacheinträge abbildet und ob die vorhandenen Datensätze weiterhin zugeordnet bleiben.
- Inhalte in Kindtabellen: Sie sind meist über eine Beziehung an das Elternelement gebunden. Diese Beziehung darf bei der Umstellung nicht verloren gehen.
- Backend-Layouts und Vorschauen: Sie gehören nicht zur Felddefinition und werden deshalb leicht übersehen. Ob und wie sie für den Block neu umgesetzt werden, hängt vom jeweiligen Element ab.
Von Mask zu Content Blocks migrieren: Vorgehen Schritt für Schritt
Die Migration von Mask zu Content Blocks folgt dieser Reihenfolge:
- Alle Mask-Elemente mit ihren Feldern erfassen und je Element die Zahl der vorhandenen Datensätze notieren. Das Inventar ist vollständig, wenn jedes Element, jedes Feld und jeder Datensatzbestand gelistet ist.
- Eine Kopie der Website mit vollständiger Datenbank anlegen. Alle weiteren Arbeiten laufen auf dieser Kopie, das Produktivsystem bleibt bis zur Übernahme unverändert. Als Backup dienen vollständige Dateien und ein SQL-Datenbank-Export.
- Content Blocks auf der Kopie installieren. Der Schritt ist erledigt, wenn die Extension im Backend aktiv ist und ein leerer Test-Block im Backend erscheint.
- Je Mask-Element einen Content Block anlegen und dabei Feldnamen, Datenbankspalten und CType unverändert übernehmen, damit die Inhalte erhalten bleiben. Abgenommen wird der Block, wenn seine Feldliste Zeile für Zeile mit dem Inventar übereinstimmt.
- Die Frontend-Templates in die Blocks übernehmen und anpassen. Geprüft wird die Ausgabe je Variante, am besten im direkten Vergleich der Seiten auf Produktiv- und Testsystem.
- Auf der Kopie testen: Datensätze je CType vor und nach der Umstellung zählen, je Sprache mindestens eine Stichprobe im Backend und im Frontend öffnen und, falls im Einsatz, auch Inhalte in Workspaces prüfen. Abweichungen in der Zählung werden vor dem nächsten Schritt geklärt.
- Mask entfernen und die umgestellte Website zusammen mit dem Update auf TYPO3 14 live nehmen. Vor dem Go-Live werden Templates, Formulare, Suche, Login-Bereiche und Redakteurs-Workflows getestet, danach Redirects, Sitemap, Schnittstellen und mehrsprachige Seiten.
Feldnamen beibehalten, damit Inhalte erhalten bleiben
Besonderes Augenmerk gilt Feldern, die mehrere Elemente gemeinsam nutzen. Sie liegen in derselben Datenbankspalte und müssen in allen betroffenen Blocks gleich definiert sein, sonst greifen die Blocks auf dieselben Daten unterschiedlich zu. Bei wiederholbaren Feldern und Kindtabellen zählt zusätzlich, dass die Datensätze ihrem Elternelement zugeordnet bleiben. Genau das ist der Grund, warum die Zählung je CType und die Stichproben in Schritt 6 nicht entfallen sollten.
Gridelements zu Container: Layout-Raster migrieren
Wer Layout-Raster mit Gridelements aufgebaut hat, steht vor dem Wechsel auf TYPO3 14 vor derselben Frage wie bei Mask. Die Gridelements-Version für TYPO3 12 und 13 ist im TER kostenlos, ihr Composer-Constraint lautet ^12.4 || ^13.4.7. Die Version für TYPO3 13 und 14 gibt es nur als bezahlten Priority Access. Der Migrationspfad führt deshalb zur Extension EXT:container (b13/container). Jede Raster-Konfiguration wird als Container-Element nachgebildet, sodass Spaltenzuordnungen und verschachtelte Inhalte erhalten bleiben. Das Vorgehen entspricht der Mask-Migration: erst das bestehende Raster erfassen, dann auf einer Kopie umbauen und prüfen.
Aufwand und Reihenfolge der Mask-Migration im Update-Projekt
Die Umstellung der Inhaltselemente ist ein eigenes Arbeitspaket innerhalb des Update-Projekts. Gridelements-Raster zählen zum selben Paket wie die Mask-Elemente. Der Umfang richtet sich nach der Zahl und der Komplexität der Elemente:
- Anzahl der Elemente: Jedes Element wird zu einem eigenen Block mit eigenem Test.
- Wiederholbare oder verschachtelte Felder: Sie erhöhen die Zahl der Datenstrukturen, die erhalten bleiben müssen.
- Verschachtelte Raster: Jede Ebene muss als Container nachgebildet und geprüft werden.
Eine belastbare Einschätzung gibt es erst, wenn feststeht, welche Elemente und Raster die Installation enthält.
Eigene Extensions gehören ebenfalls ins Arbeitspaket: Ab TYPO3 14 benötigt jede Extension eine gültige composer.json, und Extbase kommt ohne doctrine/annotations aus, sodass Annotations zu PHP-Attributen werden müssen.
Migration im selben Projekt wie das Update
Die Umstellung der Inhaltselemente gehört in dasselbe Projekt wie das Update: Wir stellen die Mask-Elemente auf Content Blocks um und heben die Website in einem Zug direkt auf TYPO3 14. Content Blocks läuft seit TYPO3 13 und ist auch für TYPO3 14 nutzbar, danach hat die Website keine Mask-Abhängigkeit mehr.
Zielversion ist TYPO3 14.3 LTS, die am 21.04.2026 erschienen ist. TYPO3 14.3 erhält kostenlose Bugfixes bis 31.12.2027 und kostenlose Sicherheitsupdates bis 30.06.2029. Reguläres ELTS läuft bis 30.06.2032, Partner-ELTS bis 30.06.2033.
Zuvor wird PHP angehoben und stabilisiert: TYPO3 14 unterstützt PHP 8.2 bis 8.5, empfohlen sind PHP 8.4 oder 8.5, da PHP 8.2 Ende 2026 ausläuft. Mehr dazu auf der Seite TYPO3 PHP-Version.
Kostentreiber Templates und Frontend
Als Kostentreiber nennt die Update-Kalkulation „Templates/Frontend“. Bei Mask-Websites schlägt er besonders zu Buche, denn jede Ausgabe-Variante eines Elements wird einzeln nachgebaut und getestet. Je mehr Logik ein Template enthält, desto länger dauern Umbau und Abnahme. Mit Fluid 5 kommt zudem eine strikte Typisierung der ViewHelper-Argumente hinzu. Individuelle Backend-Vorschauen müssen für den neuen Block ebenfalls umgesetzt werden.
Wer die TYPO3 Update Kosten einer Mask-Installation einschätzen möchte, sortiert die Elemente deshalb nach Template-Aufwand: einfache Ausgabe, mehrere Varianten, viel Logik.
Update auf TYPO3 14 LTS mit der IllusionFACTORY®
Die IllusionFACTORY® ist TYPO3 Gold Member und führt das Update auf TYPO3 14 LTS mit eigenen TYPO3-Entwicklern durch, einschließlich der Umstellung von Mask- und Gridelements-Elementen auf TYPO3 Content Blocks und EXT:container. Es gelten Aktionspreise je Ausgangsversion ab 1.200 € zzgl. MwSt. Den Endpreis legen wir nach einer individuellen Prüfung Ihrer Website fest, und in diese Prüfung fließt die Migration Ihrer Inhaltselemente ein. Wenn Sie wissen möchten, welcher Aktionspreis zu Ihrer Ausgangsversion passt und welchen Umfang die Elementmigration bei Ihnen hat, können Sie den Preis für Ihre TYPO3-Version prüfen.
FAQ
Was sind TYPO3 Content Blocks?
TYPO3 Content Blocks ist eine Extension, mit der Sie eigene Inhaltselemente per YAML-Konfiguration definieren. Jeder Block bündelt Konfiguration, Frontend-Template und Beschriftungen eines Elements an einem Ort. TCA, TypoScript und Datenbankfelder müssen Sie dafür nicht mehr getrennt pflegen. Damit sind Content Blocks eine Grundlage für projektspezifische Inhaltselemente, auch als Ersatz für Mask.
Seit welcher TYPO3-Version stehen Content Blocks zur Verfügung?
TYPO3 Content Blocks stehen seit TYPO3 13 zur Verfügung und sind auch für TYPO3 14 nutzbar. Das ist vor allem für Websites relevant, die bisher eigene Inhaltselemente mit Mask umgesetzt haben und diese im Zuge des Updates auf TYPO3 14 auf eine neue Grundlage stellen müssen.
Warum gilt Content Blocks als offizieller Ansatz der TYPO3-Community?
Die TYPO3-Community verfolgt Content Blocks offiziell als Ansatz, eigene Inhaltselemente zu definieren. Er ist auf Wartbarkeit ausgelegt: Die Beschreibung eines Elements liegt als Datei vor. Dadurch lässt sie sich wie anderer Code versionieren und im Team prüfen. Änderungen an Elementen werden so nachvollziehbar, und die Definition hängt nicht von Einstellungen ab, die nur im Backend einer einzelnen Installation existieren.
Läuft Mask mit TYPO3 14?
Nein. Zum Stand 9. Oktober 2026 gibt es für die Extension Mask keine Version für TYPO3 14, und die Bugfixes sind beendet. Eigene Inhaltselemente, die Sie mit Mask umgesetzt haben, brauchen vor dem Wechsel auf TYPO3 14 daher eine andere Grundlage. Als Nachfolger dient TYPO3 Content Blocks. Wer Mask weiter einsetzt, bekommt für die Extension also keine Fehlerbehebungen mehr.
Muss ich Mask vor dem Update auf TYPO3 14 durch Content Blocks ersetzen?
Ja. Mask-Elemente müssen vor dem Wechsel auf TYPO3 14 auf TYPO3 Content Blocks umgestellt sein, und zwar im selben Projekt wie das Update. Die Umstellung betrifft Felddefinitionen, Bestandsdaten und Templates, sie ist also mehr als ein reiner Austausch der Extension. Nicht mehr verwendete Elemente müssen Sie dabei nicht übertragen. Prüfen Sie deshalb vorab, welche Elemente auf Ihrer Website tatsächlich noch im Einsatz sind.
Bleiben meine Inhalte bei der Migration von Mask zu Content Blocks erhalten?
Ja, in der Regel bleiben Ihre Inhalte erhalten, wenn der Content Block an die vorhandenen Datenbankspalten anknüpft. Dafür übernehmen Sie je Mask-Element Feldnamen, Datenbankspalten und CType unverändert.
Besondere Aufmerksamkeit brauchen:
- Felder, die mehrere Elemente gemeinsam nutzen und in allen Blocks gleich definiert sein müssen
- wiederholbare Felder und Kindtabellen, deren Datensätze ihrem Elternelement zugeordnet bleiben müssen
Kontrollieren Sie das auf einer Testkopie: Zählen Sie die Datensätze je CType vor und nach der Umstellung, und prüfen Sie je Sprache mindestens eine Stichprobe im Backend und im Frontend. Falls im Einsatz, testen Sie auch Workspaces.
Wie läuft die Migration von Mask zu Content Blocks Schritt für Schritt ab?
Die Migration läuft in sieben Schritten ab: - Inventar: Alle Mask-Elemente mit Feldern erfassen und die Datensätze je Element zählen. - Kopie: Die Website mit vollständiger Datenbank kopieren und nur dort arbeiten. - Installation: Content Blocks auf der Kopie installieren und mit einem leeren Test-Block prüfen. - Blocks anlegen: Je Element einen Block erstellen und die bestehenden Bezeichner beibehalten. - Templates: Frontend-Templates übernehmen und anpassen. - Test: Das Ergebnis auf der Kopie systematisch kontrollieren. - Übernahme: Mask entfernen und die umgestellte Website zusammen mit dem Update auf TYPO3 14 live nehmen.
Warum sollte ich die Migration zuerst auf einer Kopie der Website testen?
Die Migration berührt mehrere Bereiche zugleich. Auf einer Kopie der Website können Sie Fehler gefahrlos finden, während das Produktivsystem bis zur Übernahme unverändert bleibt. Besonders hilfreich ist der direkte Vergleich: Rufen Sie die Seiten je Ausgabe-Variante auf der Kopie und im Produktivsystem auf und achten Sie auf Abweichungen. Auffälligkeiten klären Sie, bevor Sie den nächsten Schritt gehen. Erst nach erfolgreichem Test übernehmen Sie die Umstellung auf die Live-Website.
Wie werden Inhaltselemente in Content Blocks per YAML konfiguriert?
Jedes Inhaltselement wird in Content Blocks als eigener Block definiert. Die YAML-Datei beschreibt das Element und seine Felder. Bei einer Migration von Mask gilt folgende Zuordnung: - Mask-Element: wird zu genau einem Content Block. - Mask-Felder: erscheinen als Einträge der YAML-Konfiguration. Ob jeder Feldtyp eine direkte Entsprechung hat, prüfen Sie im Einzelfall. - Element-Template: wird zum Frontend-Template des Blocks.
Was wird aus Gridelements beim Update auf TYPO3 14?
Gridelements-Raster werden beim Update auf TYPO3 14 auf die Extension EXT:container (b13/container) umgestellt. Die Gridelements-Version für TYPO3 12 und 13 ist im TER kostenlos (Composer-Constraint ^12.4 || ^13.4.7). Die Version für TYPO3 13 und 14 gibt es nur als bezahlten Priority Access. Jede Raster-Konfiguration wird als Container-Element nachgebildet, sodass Spaltenzuordnungen und verschachtelte Inhalte erhalten bleiben. Das Vorgehen entspricht der Mask-Migration: Bestehende Raster erfassen, auf einer Kopie der Website umbauen und das Ergebnis prüfen.
Wie migriere ich Layout-Raster von Gridelements zu Container?
Für die Migration von Layout-Rastern gehen Sie je Raster einzeln vor: - Erfassen Sie zuerst jedes Raster mit seinen Spalten und Verschachtelungen. - Bilden Sie jede Raster-Konfiguration als Container-Element der Extension EXT:container (b13/container) nach. - Prüfen Sie jede Verschachtelungsebene einzeln, also auch Raster, die innerhalb anderer Raster liegen. - Auf diese Weise bleibt nachvollziehbar, an welcher Stelle eine Abweichung entsteht.
Wann erfolgt die Migration im Update-Projekt?
Im selben Projekt wie das Update auf TYPO3 14. Die Umstellung der Mask-Elemente auf Content Blocks gehört zum Arbeitspaket des Updates; danach hat die Website keine Mask-Abhängigkeit mehr und läuft direkt auf TYPO3 14.
Wie aufwendig ist die Migration von Mask zu Content Blocks?
Der Aufwand hängt von der Zahl und der Komplexität Ihrer Mask-Elemente ab. Die Umstellung ist ein eigenes Arbeitspaket im Update-Projekt, und jeder Block bekommt einen eigenen Test. Weniger Aufwand entsteht, weil nicht mehr verwendete Elemente nicht übertragen werden müssen. Der Aufwand steigt vor allem durch: - Elementanzahl: Jeder Block wird einzeln angelegt und geprüft. - Wiederholbare oder verschachtelte Felder: Hier müssen mehr Datenstrukturen erhalten bleiben. - Gridelements-Raster: Sie gehören zum selben Paket, weil sie auf EXT:container umgestellt werden. Eine belastbare Einschätzung ist erst möglich, wenn ein Inventar vorliegt.
Wie fließt die Migration meiner Inhaltselemente in die Preisprüfung der IllusionFACTORY® ein?
In die individuelle Prüfung Ihrer Website durch die IllusionFACTORY® fließt die Migration Ihrer Inhaltselemente ein, und danach wird der Endpreis festgelegt. Maßgeblich sind dabei vor allem: - Zahl und Komplexität der Mask-Elemente, die jeweils zu einem eigenen Content Block werden - Gridelements-Raster, die auf EXT:container umgestellt werden - Templates und Frontend, da jede Ausgabe-Variante einzeln nachgebaut und getestet wird Je mehr Elemente, Raster und Varianten Ihre Installation enthält, desto stärker wirkt sich die Migration auf den Preis aus.
Ab welchem Preis bietet die IllusionFACTORY® das Update auf TYPO3 14 LTS an?
Die IllusionFACTORY® bietet das Update auf TYPO3 14 LTS mit Aktionspreisen je Ausgangsversion ab 1.200 € zzgl. MwSt. an. Welcher Preis zu Ihrer Website passt, hängt von der Ausgangsversion ab; der Endpreis richtet sich außerdem nach Art und Zahl Ihrer Inhaltselemente. Das Update führen eigene TYPO3-Entwickler der IllusionFACTORY® durch, die als TYPO3 Gold Member tätig ist.