TYPO3-Extension nicht kompatibel – was tun beim Update?

Kurz gesagt: Unterstützt eine Erweiterung die neue TYPO3-Version nicht, gibt es vier Wege: auf eine neuere Version der Erweiterung aktualisieren, sie durch eine gepflegte Alternative ersetzen, die Funktion mit Bordmitteln von TYPO3 abbilden oder die Erweiterung selbst anpassen. Welcher Weg passt, zeigt eine Prüfung vor dem Update.

Der TYPO3-Kern lässt sich zuverlässig von Version zu Version heben. Bremsen sind fast immer die Erweiterungen: ein Kalender, ein News-Modul, ein Formular-Plugin oder eine Erweiterung, die eine Agentur vor Jahren eigens für Sie geschrieben hat.

Woran Sie erkennen, ob eine Erweiterung kompatibel ist

• Extension Repository (extensions.typo3.org): Bei jeder Erweiterung steht, welche TYPO3-Versionen sie unterstützt und wann die letzte Version erschienen ist.
• composer.json bzw. ext_emconf.php: In den Abhängigkeiten der Erweiterung ist festgelegt, mit welchen TYPO3-Versionen sie läuft.
• Extension Scanner: Im Install Tool unter „Upgrade“ durchsucht TYPO3 den Code der Erweiterungen nach Stellen, die in neueren Versionen geändert oder entfernt wurden.
• Letzte Aktivität: Wurde eine Erweiterung seit Jahren nicht aktualisiert, ist das ein Warnzeichen – auch wenn sie auf dem Papier noch passt.

Lösung 1: Neuere Version der Erweiterung

Der einfachste Fall. Viele verbreitete Erweiterungen werden gepflegt und erscheinen für jede neue LTS-Version. Beim Sprung über mehrere Versionen kann es nötig sein, auch die Erweiterung schrittweise zu aktualisieren und ihre eigenen Upgrade-Schritte auszuführen.

Lösung 2: Ersatz durch eine gepflegte Alternative

Für verwaiste Erweiterungen gibt es oft eine Nachfolgerin. Ein bekanntes Beispiel ist RealURL: Die Erweiterung für sprechende Adressen ist seit TYPO3 9 überflüssig, weil TYPO3 das Routing selbst übernimmt. Ähnlich ersetzen viele Projekte ältere Raster-Erweiterungen für Inhaltselemente durch neuere Lösungen. Wichtig beim Wechsel: Die vorhandenen Inhalte müssen übernommen werden – das gehört zur Planung.

Lösung 3: Bordmittel von TYPO3

TYPO3 hat über die Jahre vieles in den Kern übernommen, wofür früher eine Erweiterung nötig war: Routing, das Formular-Framework, SEO-Funktionen wie Meta-Tags und XML-Sitemaps. Statt eine alte Erweiterung mitzuschleppen, ist es oft sauberer, die Funktion mit dem Kern abzubilden – und eine Abhängigkeit weniger zu haben.

Lösung 4: Die Erweiterung selbst anpassen

Bei selbst entwickelten Erweiterungen bleibt nur dieser Weg, und auch bei verwaisten Erweiterungen ohne Alternative kann er sinnvoll sein. Der Extension Scanner zeigt die betroffenen Stellen, die Änderungshinweise von TYPO3 erklären, wie man sie ersetzt. Der Aufwand reicht von wenigen Stunden bis zu einigen Tagen – je nach Umfang und Alter des Codes.

Was Sie besser nicht tun

• Versionsgrenzen „aushebeln“: Die Kompatibilitätsangabe einer Erweiterung zu ändern, ohne den Code anzupassen, führt zu Fehlern – oft erst im Betrieb.
• Das Update deshalb verschieben: Eine einzelne Erweiterung ist selten ein Grund, auf Sicherheitsupdates zu verzichten. Fast immer gibt es einen der vier Wege.
• Erst beim Update merken: Wer die Erweiterungen vorab prüft, kennt Aufwand und Kosten, bevor es losgeht.

So gehe ich vor

In der TYPO3-Analyse für 150 € netto liste ich alle Erweiterungen Ihrer Website auf und bewerte jede: kompatibel, aktualisierbar, zu ersetzen oder anzupassen. Daraus ergibt sich der Festpreis für Ihr Update – ohne Überraschung mittendrin.

Mehr dazu: TYPO3-Update und TYPO3-Wartung und TYPO3-Update von 10 oder 11 auf 14: Ablauf, Dauer und Kosten.

Stand: Oktober 2026. Quellen: docs.typo3.org (Upgrade-Anleitung, Extension Scanner), extensions.typo3.org.