Hreflang Multisite
Eine Produktivinstanz

Deine europäische und deine nordamerikanische Website beschreiben dasselbe Produkt. Google ahnt nichts davon.
TYPO3 erzeugt hreflang-Tags für die Übersetzungen innerhalb eines Seitenbaums. Die meisten internationalen Setups haben aber für jeden Markt einen eigenen Baum. Dann erklärt jeder Baum den Suchmaschinen, er sei die einzige Fassung, die es gibt. Besucher landen in der falschen Region, und deine Märkte machen sich in den Suchergebnissen gegenseitig Konkurrenz.
Hreflang Multisite verbindet Seiten über diese Bäume hinweg zu einem Page-Set. Jede Seite im Set trägt die Tags aller anderen, einschließlich der Übersetzungen in jedem Baum.
Gepflegt von der Redaktion, im Backend, das sie ohnehin benutzt. Nicht von einem Entwickler in einer Konfigurationsdatei.
Du betreibst eine TYPO3-Installation mit einem eigenen Seitenbaum für jeden Markt. Europa mit Englisch, Deutsch, Spanisch, Französisch und Schweizerdeutsch. Nordamerika mit Englisch, Spanisch und Französisch.
Diese Trennung ist gewollt, und meist hat sie mehr als organisatorische Gründe. Die Märkte verkaufen Unterschiedliches: Eine Produktlinie, die es in Nordamerika nicht gibt, hat dort auch keine Seite, und einen regionalen Servicebereich gibt es nur in Europa. Die Navigation unterscheidet sich, weil sich das Angebot unterscheidet. Ein einzelner Baum mit Übersetzungen kam nie infrage, denn die Strukturen sind keine Übersetzungen voneinander.
Mit den Sprachen innerhalb eines Baums kommt TYPO3 gut zurecht. Die beiden Bäume verbinden kann es nicht, denn hreflang ist im Core an die Site des aktuellen Requests gebunden. Eine Site, ihre Sprachen, fertig.
Übrig bleiben zwei Inseln. Deine spanische Seite in Europa und deine spanische Seite in Nordamerika gibt es beide, beide ranken, und keine sagt Google, dass die andere für ein anderes Publikum gedacht ist.
Wo deine Märkte dasselbe verkaufen, sind diese Seiten oft fast identisch, nicht selten Wort für Wort, weil beide auf denselben Ausgangstext zurückgehen. Das ist Duplicate Content, und Suchmaschinen gehen damit so um wie immer: Sie behalten eine Fassung und ignorieren die andere weitgehend. Welche sie behalten, entscheidest nicht du. hreflang ist der Mechanismus, der aus Kopien regionale Alternativen macht.
Am Ende konkurrierst du mit dir selbst um deine eigenen Kunden.
Von Hand lässt sich das auch nicht lösen. hreflang muss wechselseitig sein: Jede Sprachfassung muss alle anderen und sich selbst nennen, die Liste muss überall dieselbe sein, und ein einziger falscher Eintrag macht die Gruppe für alle ungültig.
Die Liste zu schreiben ist nicht das Problem. Sie aktuell zu halten schon. Die Zuordnung ändert sich, sobald eine Seite dazukommt, umbenannt oder verschoben wird. Die Inhalte ändert die Redaktion, die Tags aber stehen in einem Template, an das sie nicht herankommt. Nichts prüft das Ergebnis, und niemand kann dir sagen, welche Gruppen gerade unvollständig sind. Mit einem Page-Set verknüpft ein Redakteur eine Seite pro Baum, und alle Sprachen ergeben sich aus deiner Site-Konfiguration. Bei fünfzehn Sprachen sind das zwei Verknüpfungen statt einer Liste mit fünfzehn Einträgen, die auf fünfzehn Seiten stehen muss. Der Schaden bleibt so oder so unsichtbar: Nichts geht kaputt, nichts landet im Log, und die Kosten tauchen Monate später als Zeile in einem Trafficbericht auf, deren Ursache niemand mehr findet.
hreflang setzt man nicht einmal. hreflang ist eine Gruppe, die man pflegt.
Ein Redakteur öffnet eine Seite, wählt die zugehörigen Seiten in den anderen Bäumen aus und markiert eine davon als x-default. Mehr ist nicht zu tun.
Ab dann gibt jede Seite der Gruppe alle Tags aus: eines pro Sprache und Region, dazu x-default als Rückfallebene. Die Sprachcodes kommen aus deiner Site-Konfiguration, wo sie ohnehin schon stehen. Keine Template-Änderung, kein TypoScript pro Seite, keine zweite Stelle, an der Sprachcodes gepflegt werden.
Drei Dinge passieren automatisch:
no_index und Seiten außerhalb ihres Veröffentlichungszeitraums.
Hier entscheidet sich, ob hreflang den Redaktionsalltag übersteht.
Jede Seite eines Sets zeigt dieselbe Gruppe, und auf jeder kannst du sie bearbeiten. Wer an der nordamerikanischen Seite arbeitet, sieht dort die ganze Gruppe und ändert sie direkt. Es gibt keine Hauptseite, kein „geh erst zum englischen Original“ und keine Regel, die sich jemand merken muss.
Andere Lösungen speichern die Verknüpfungen auf jeder Seite einzeln. Du siehst, worauf deine Seite zeigt, aber nicht, wie die Gruppe aussieht. In einer Demo mit drei Seiten fällt das nicht auf. Bei fünf Märkten mit je zweihundert Seiten gibt es den Ausschlag.

Die Page-Set-Übersicht im Backend geht deinen Seitenbaum durch und zeigt, welche Seite zu welchem Set gehört. Filtern kannst du nach Seiten mit, ohne oder mit unvollständiger Hreflang-Konfiguration. Der letzte Filter zeigt Zeile für Zeile, welcher Gruppe ein Markt fehlt.
Genau dieser Filter macht aus „wir haben hreflang“ ein „wir wissen, dass unser hreflang stimmt“.

x-default ist die Seite, auf die eine Suchmaschine zurückfällt, wenn ein Besucher zu keinem deiner Märkte passt. TYPO3 setzt sie automatisch, und zwar überall nach derselben Regel: Sie zeigt auf die erste konfigurierte Sprache der Site.
Mit Hreflang Multisite wählt die Redaktion sie pro Gruppe, und die Wahl wird gegen genau diese Gruppe geprüft.
Das ist wichtig, denn die richtige Rückfallseite ist nicht überall dieselbe. Eine Gruppe von Produktseiten über alle Märkte hinweg fällt sinnvollerweise auf deine internationale englische Seite zurück. Eine Gruppe, die es nur in Europa gibt, sollte auf eine europäische Seite zurückfallen, nicht auf eine US-Seite, die gar nicht zum Set gehört. Eine globale Einstellung kann das nicht abbilden. Sie legt eine Antwort fest und wendet sie auf Inhalte an, von denen sie nichts weiß.
Die Extension prüft, ob deine Wahl tatsächlich zur Gruppe gehört. Zeigt die Rückfallseite aus dem Set heraus, wird sie abgelehnt, statt stillschweigend ausgeliefert zu werden.
Nicht jeder Baum gehört in jede hreflang-Gruppe, manche gehören in gar keine. In der Konfiguration legst du fest, welche Bäume miteinander verknüpft werden dürfen. Alles andere bekommt die Redaktion gar nicht erst angeboten.
Am häufigsten betrifft das Kampagnenseiten. Liegen Kampagnen in einem eigenen Baum, lebt dieser nicht lange, ist inhaltlich oft fast eine Kopie und hat häufig eine eigene Domain. Niemand will die Landingpage der Frühjahrsaktion in der dauerhaften hreflang-Struktur eines Markts haben. Und niemand merkt es, wenn sie doch dort landet, weil eine falsche Gruppe genauso aussieht wie eine richtige. Schließ diesen Baum von allen Gruppen aus, dann ist der Fehler nicht mehr unwahrscheinlich, sondern unmöglich.
In einem Konzern löst dieselbe Grenze eine organisatorische Aufgabe: Ein Redakteur einer Landesgesellschaft kann seine Seiten nicht versehentlich in die Struktur einer anderen hängen.

Beanspruchen zwei Seiten einer Gruppe dieselbe Sprache und Region, ist die Gruppe ungültig. Suchmaschinen verwerfen dann nicht den einen Eintrag, sondern die ganze Gruppe. Im Backend sieht man diesen Fehler nicht, in den Suchergebnissen kostet er viel.
Eine Prüfung im Seitenmodul meldet doppelte hreflang-Codes über deine verknüpften Bäume hinweg. So kommt das Problem ans Licht, solange es noch jemand beheben kann.
Hreflang Multisite kümmert sich um Seiten, also um alles, was in deinem Seitenbaum liegt und eine eigene URL hat. Manches gehört aber in die Gruppe, ohne eine Seite in deinem Baum zu sein: ein Markt auf einer anderen Plattform, eine alte Domain, eine Partnerseite. Solche Einträge kommen über ein PSR-14-Event hinzu. Es wird ausgelöst, während die Tags einer Gruppe zusammengestellt werden. Dein eigener Code kann also Einträge ergänzen, ändern oder entfernen, nach der Logik, die dein Projekt braucht.
Am häufigsten geht es dabei um Datensätze: News, Produkte, Veranstaltungen. Ein Datensatz hat oft gar kein Gegenstück in einem anderen Markt, und wenn doch, ist es selten eindeutig. Außerdem entstehen die URLs von Datensätzen in einem Route Enhancer und nicht im Seitenbaum. Es gibt also nichts, woran sich eine Verknüpfung speichern ließe. Die Zuordnung ist für jedes Projekt anders, deshalb gibt es dafür ein Event und keine Einstellung.
Wir haben das schon gebaut. Willst du es nicht selbst machen, erzähl uns von deinem Setup. Wir sagen dir, was es braucht.
| TYPO3-Core | Andere freie Extensions | Hreflang Multisite | |
|---|---|---|---|
| Tags für Übersetzungen in einem Baum | ja | ja | ja |
| Verbindet Seiten über getrennte Bäume hinweg | nein | ja | ja |
| Gruppe von jeder ihrer Seiten aus bearbeiten | — | nein, jede Seite speichert ihre eigenen Verknüpfungen | ja |
| Übersicht über alle Gruppen im Backend | nein | nein | ja |
| Markiert unvollständige Gruppen | nein | nein | ja |
| Festlegen, welche Bäume verknüpft werden dürfen | — | nein | ja |
x-default von der Redaktion gewählt | nein, automatisch die erste Sprache | eine ja, die andere leitet ihn aus der PHP-Konfiguration ab | ja, gegen die Gruppe geprüft |
Eigener x-default pro Gruppe | nein, eine Regel für die ganze Site | eine ja, bei der anderen gilt ein Baum global als Vorgabe | ja |
| Sprachcodes aus der Site-Konfiguration | ja | eine pflegt sie doppelt in einem PHP-Array | ja |
TYPO3 hält Seitenbäume mit Absicht auseinander: andere Redaktionen, andere Rechte, andere Strukturen. Hreflang Multisite schlägt eine Brücke über diese Trennung, ohne sie aufzuheben.
Unternehmen, deren Märkte wirklich verschieden sind und nicht nur übersetzt. Hersteller mit nationalen Vertriebsgesellschaften, Hochschulen mit Fakultätsseiten, Konzerne mit getrennten Marken.
Meist sind die Bäume aus zwei Gründen zugleich getrennt: Verschiedene Teams pflegen sie, und die Märkte verkaufen Unterschiedliches. Eine Produktlinie, die es in Nordamerika nicht gibt, hat dort keine Seite. Ein regionaler Servicebereich existiert in einem Baum und sonst nirgends. Die Navigation unterscheidet sich, weil sich das Angebot unterscheidet, und genau deshalb kam ein einzelner Baum mit Übersetzungen nie infrage.
Nur ein Teil der Inhalte hat ein Gegenstück, und nur dieser Teil muss in eine Gruppe. Seiten, die es nur in einem Markt gibt, gehören einfach zu keinem Set, und für sie ändert sich nichts.
Redaktionen, die ihren eigenen Markt pflegen. Die Gruppe lässt sich von jeder ihrer Seiten aus bearbeiten. Niemand muss wissen, wo die „echte“ Fassung liegt.
Alle, die es schon von Hand versucht haben. Pflegst du eine Tabelle, die Seiten-IDs über Märkte hinweg einander zuordnet, brauchst du sie danach nicht mehr.
Gebaut ist es für getrennte Seitenbäume. Für Sprachen innerhalb eines Baums erzeugt TYPO3 selbst korrekte hreflang-Tags, da gibt es nichts zu ergänzen.
Seinen Preis spielt es ein, wenn dein Setup wächst, und das passiert in zwei Richtungen zugleich. Kommt eine Sprache dazu, wird die Liste auf jeder Seite länger. Kommt ein Baum dazu, steigt die Zahl der Seiten, die du von Hand verknüpfst. Bei zwei Bäumen und fünfzehn Sprachen heißt das: eine Liste mit fünfzehn Einträgen, die auf fünfzehn Fassungen identisch sein muss. Mit einem Page-Set sind es zwei Verknüpfungen, und alle Sprachen ergeben sich aus deiner Site-Konfiguration. Die Liste zu schreiben ist einfach. Schief geht es, wenn sie stimmen soll, während die Redaktion Seiten verschiebt.
Selbst bauen sieht nach der günstigsten Lösung aus. Ist es aber nicht. Die Tags sind der einfache Teil. Zeit kostet die Bedienoberfläche: eine Gruppe, die von jeder ihrer Seiten aus erreichbar ist, beim Speichern geprüft wird und in einer Übersicht auftaucht. Lullabot, eine der bekanntesten Drupal-Agenturen, hatte genau diesen Teil des Problems, die manuelle Auswahl, auf der Roadmap. Sie haben aufgeschrieben, warum die Oberfläche das Schwierige daran ist, und ihn nie gebaut. Ihr Modul wird seit 2022 nicht mehr gepflegt.
TYPO3 v13.4 LTS oder v14, PHP 8.2 oder neuer. Die Systemextensions info und seo werden automatisch mitinstalliert.
Außerdem brauchst du mehr als eine Root-Seite und innerhalb jeder Gruppe eindeutige Sprach- und Regionscodes. Beanspruchen zwei Seiten eines Sets beide en-us, ist das kein gültiges hreflang, egal welches Produkt die Tags erzeugt.
Nach dem Kauf hast du in deinem Konto beim b13 Marketplace ein eigenes Composer-Repository.
1
2
composer config repositories.b13 composer https://b13.com/_api/composer/p/<your-project>/
composer require b13/hreflang-multisite
Die Zugangsdaten kommen in die auth.json. Hat dein Setup keinen Composer-Zugriff, findest du in deinem Konto einen ZIP-Download.
Danach bindest du das mitgelieferte Site-Set in deine Site-Konfiguration ein und legst fest, welche Root-Seiten verknüpft werden dürfen. Dann kann die Redaktion loslegen.
Ein Preis, der nicht steigt, wenn eine Sprache dazukommt.
Hreflang Multisite wird pro Jahr und pro Produktivinstanz lizenziert. Eine Produktivinstanz ist eine TYPO3-Installation mit einer Codebasis und einer Datenbank. Wie viele Sites, Seitenbäume, Sprachen oder Gruppen darin laufen, ändert am Preis nichts. Staging, Test und lokale Installationen sind kostenlos.
Eine Produktivinstanz
Setzt du das in Kundenprojekten ein? Gezählt wird jede Produktivinstallation. Übergibst du ein Projekt später an deinen Kunden, geht die Lizenz mit, er muss sie nicht neu kaufen. Sag uns, wie viele du brauchst, dann machen wir dir einen Preis.
Warum eine Jahreslizenz. Hreflang Multisite greift direkt in deine Frontend-Ausgabe ein und hängt davon ab, wie TYPO3 Sites, Sprachen und URLs auflöst. Genau dieser Bereich ändert sich zwischen Hauptversionen am stärksten. Bisher gab es das Produkt pro TYPO3-Version, du hast also bei jedem Hauptversionssprung neu bezahlt. Über einen LTS-Zyklus gerechnet kostet die Jahreslizenz etwa gleich viel, über kürzere Zeiträume ist sie günstiger.
Hast du Hreflang Multisite schon früher gekauft? Deine Lizenz gilt für die TYPO3-Version, für die du sie gekauft hast. Solange du darauf bleibst, ändert sich nichts. Der richtige Zeitpunkt für den Wechsel ist dein nächster Hauptversionssprung. Sprich mit deinem Ansprechpartner bei b13, dann klären wir das an deinem Projekt und nicht über ein Formular.

Product Development
Du brauchst mehr Instanzen oder hast eine andere Frage?
Sprich mit uns.
In jeder Lizenz enthalten sind Support per E-Mail, Fehlerbehebungen, Updates für neue TYPO3-Versionen und Sicherheitsfixes. Ein Postfach, eine Warteschlange. Anfragen, die deinen Betrieb aufhalten, ziehen wir vor. Du bekommst eine Vorgangsnummer und kannst jederzeit nach dem Stand fragen.
Priority — 300 € pro Jahr und Lizenz. Eine zugesicherte Antwort innerhalb eines Werktags und Fehlerbehebungen mit Vorrang.
Enterprise — ab 990 € pro Jahr. Reaktionszeiten nach Schweregrad, ein festes Servicefenster, ein Eskalationsweg und ein jährliches Abstimmungsgespräch. Individuell im Vertrag geregelt.
Was der Support nicht abdeckt: Installation und Konfiguration in deinem Projekt, Anpassungen an deinen speziellen Fall, Fehlersuche in deinem eigenen Code oder deiner Umgebung, Datenbereinigung und Schulungen. Pro Anfrage suchen wir bis zu eine Stunde nach der Ursache. Liegt sie außerhalb von Hreflang Multisite, sagen wir dir, was wir gefunden haben und wo du weitersuchen kannst.
Hreflang Multisite läuft in deiner Instanz. Eine Verfügbarkeit können wir dir deshalb nicht zusagen. Zusagen können wir, wann wir antworten.
Sicherheitslücken meldest du an [email protected]. Wir lesen jede Meldung, antworten mit einer Einschätzung und stimmen mit dir einen Termin ab, bevor etwas veröffentlicht wird. Braucht dein eigener Prozess ein festes Datum, schreib das in die Meldung, dann vereinbaren wir eins.
Ja. Die Extension liest die URLs aus deiner Site-Konfiguration, egal ob sich deine Märkte in der Domain, in der Subdomain oder im Pfad unterscheiden.
Auf Seiten in einem Set ersetzen die Tags des Sets sie, damit sich beide nicht widersprechen können. Auf Seiten, die zu keinem Set gehören, bleibt alles, wie der Core es macht.
Nein, genau darum geht es. Die Gruppe ist ein einziger Datensatz. Wer sie auf einer ihrer Seiten ändert, ändert sie für alle.
Nein, und das liegt an hreflang selbst, nicht an dieser Extension: Gehört eine Seite zu zwei konkurrierenden Gruppen, bekommen Suchmaschinen widersprüchliche Angaben.
Ja. hreflang verbindet Seiten, die denselben Zweck erfüllen, nicht Seiten mit denselben Wörtern. Märkte texten selbst, lassen Abschnitte weg und fügen eigene hinzu. Die deutschen „Produkte“ gehören zu den englischen „Products“ und nicht zu „Services“. Übereinstimmen muss die Aufgabe, die die Seite für einen Besucher in diesem Markt erfüllt.
Nur Seiten. Datensätze wie News, Produkte oder Veranstaltungen bekommen ihre Tags über das PSR-14-Event, mit einer Zuordnung, die für dein Projekt geschrieben wird. Das hat einen Grund: Ein Datensatz hat oft gar kein Gegenstück in einem anderen Markt, das Gegenstück ist selten eindeutig, und die URLs von Datensätzen entstehen in einem Plugin und nicht im Seitenbaum. Wir haben das schon für Kunden gebaut. Sprich uns auf deinen Fall an.
Jede Gruppe ja, denn nur du weißt, welche Seiten einander entsprechen. Die Extension nimmt dir die Arbeit pro Sprache ab: Du verknüpfst eine Seite pro Baum, und alle Sprachen ergeben sich aus deiner Site-Konfiguration. Die Page-Set-Übersicht zeigt dir, welche Seiten noch nicht verknüpft sind. Du arbeitest also eine Liste ab, statt zu suchen.
Den nimmst du über das PSR-14-Event dazu. Er gehört dann zum Set wie jeder andere Eintrag.
Die Seiten fallen auf das zurück, was TYPO3 von sich aus erzeugt: korrekte Tags innerhalb jedes Baums, keine Verbindungen zwischen den Bäumen. Deine Page-Sets bleiben in der Datenbank, beim Deinstallieren wird nichts gelöscht.
An deiner laufenden Installation ändert sich nichts. Der Code auf deinem Server funktioniert weiter, und nichts schaltet sich ab. Was endet, ist der Zugang zu neuen Releases: Unser Composer-Repository liefert dir keine Downloads mehr.
Für deine Deployment-Pipeline heißt das: Fährt sie bei jedem Build ein composer install gegen unser Repository, schlägt dieser Build nach Ablauf der Lizenz fehl. Deine Website läuft weiter, dein nächstes Deployment nicht. Der Code steht unter GPL-2.0-or-later, die Kopien, die du schon hast, gehören also dir.
Deshalb gibt es eine Nachfrist: Schlägt eine Zahlung fehl, kannst du 13 Tage lang weiter Releases beziehen, während das geklärt wird. Außerdem erinnern wir dich zweimal, bevor die Lizenz ausläuft.
Der Code steht unter GPL-2.0-or-later, wie jede TYPO3-Extension. Du bezahlst für den Zugang zu den Releases, für Updates für neue TYPO3-Versionen, Sicherheitsfixes und Support. Lesen kannst du jede Zeile.
Nein, die sind in deiner Produktivlizenz enthalten. Staging, Test, Integration und jede lokale Installation desselben Projekts sind abgedeckt. Gezählt werden nur Produktivinstanzen.
Eine TYPO3-Installation mit einer Codebasis und einer Datenbank. Alles darin ist abgedeckt: beliebig viele Seitenbäume und Sprachfassungen. Zehn Kundensites in einer Multisite-Installation sind eine Instanz. Zehn getrennte Installationen sind zehn. Sprich uns dafür an.
Deine Regionalsites beschreiben längst dieselben Produkte. Hreflang Multisite sagt den Suchmaschinen, dass sie zusammengehören. Gepflegt von der Redaktion, der die Inhalte gehören, nicht von einem Entwickler in einer Konfigurationsdatei.