- Erstellt:
- Aktualisiert:
- Autor:
- Roland Golla
Astro JS Lokalisierung 2026 – Mehrsprachige Websites mit integriertem i18n-Routing
Astro JS Lokalisierung (i18n) ist das integrierte System zur Erstellung mehrsprachiger Websites in Astro. Seit Astro 5 ist i18n-Routing direkt im Framework verankert – ohne externe Plugins, ohne zusätzliche Router-Konfiguration. Sprachen, URL-Prefixe und Routing-Strategien werden zentral in der astro.config.mjs definiert.
Im Jahr 2026 profitiert Astros i18n-System von der Cloudflare-Übernahme und dem Astro 6 Release: Live Content Collections ermöglichen mehrsprachige Inhalte zur Laufzeit, die workerd-Runtime sorgt für konsistentes Verhalten in Development und Production. Die Kombination aus statischem Routing, automatischer URL-Generierung und Middleware-Funktionen wie Astro.currentLocale macht Astro zu einer der entwicklerfreundlichsten Lösungen für internationalisierte Websites. Bei Never Code Alone setzen wir Astro-i18n neben Sulu CMS für performante mehrsprachige Projekte ein.
i18n-Konfiguration und Routing-Strategien in Astro
Astros i18n-System wird zentral in der astro.config.mjs konfiguriert. Über defaultLocale, locales und die routing-Strategie wird festgelegt, wie URLs für verschiedene Sprachen aufgebaut werden. Astro unterstützt zwei Hauptstrategien: prefixDefaultLocale: false zeigt die Standardsprache ohne URL-Prefix (/about statt /de/about), während prefixDefaultLocale: true alle Sprachen einheitlich mit Prefix darstellt.
// astro.config.mjs – i18n mit prefixDefaultLocale
import { defineConfig } from 'astro/config';
export default defineConfig({
i18n: {
defaultLocale: 'de',
locales: ['de', 'en', 'fr', 'es'],
routing: {
prefixDefaultLocale: false
}
}
});
// Ergebnis: /about (de), /en/about, /fr/about, /es/about
Für regionale Sprachvarianten wie de-AT, de-CH oder en-GB bietet Astro benutzerdefinierte Locale-Pfade. Mehrere BCP-47-Sprachcodes werden unter einem URL-Prefix zusammengefasst – nützlich für Projekte, die DACH-Regionen oder internationale Englisch-Varianten bedienen:
// Benutzerdefinierte Locale-Pfade für Sprachvarianten
i18n: {
defaultLocale: 'de',
locales: [
{ path: 'de', codes: ['de', 'de-AT', 'de-CH'] },
{ path: 'en', codes: ['en', 'en-US', 'en-GB'] },
'fr'
]
}
// /de/about bedient de, de-AT und de-CH
In Astro-Komponenten steht Astro.currentLocale über die Middleware bereit, um die aktive Sprache zu erkennen. Damit lassen sich Sprachweichen, hreflang-Tags und Navigation dynamisch rendern. Für die Content-Struktur werden sprachspezifische Ordner unter src/pages/ angelegt – jede Sprachversion ist eine eigene .astro- oder .md-Datei:
src/pages/
├── index.astro # → / (Deutsch, Standard)
├── about.astro # → /about
├── en/
│ ├── index.astro # → /en
│ └── about.astro # → /en/about
└── fr/
├── index.astro # → /fr
└── about.astro # → /fr/about
Wir bauen schnelle, sichere und barrierefreie Websites mit Astro. Kurze Ladezeiten, saubere Technik und gute Bedienbarkeit für alle, so erfüllt eure Website die gesetzlichen Anforderungen und wird gleichzeitig besser gefunden. Jede Änderung prüfen automatisierte Tests, bevor sie live geht.
SEO für mehrsprachige Astro-Websites: hreflang, Sitemaps und Content Collections
Für internationales SEO sind korrekte hreflang-Tags entscheidend. Sie signalisieren Suchmaschinen, welche Sprachversion für welche Region relevant ist. In Astro werden hreflang-Tags im <head>-Bereich der Layout-Komponente dynamisch generiert – basierend auf der i18n-Konfiguration und Astro.currentLocale:
// Layout.astro – hreflang-Tags dynamisch generieren
---
const locales = ['de', 'en', 'fr'];
const currentPath = Astro.url.pathname;
---
{locales.map(locale => (
<link
rel="alternate"
hreflang={locale}
href={`/${locale}${currentPath}`}
/>
))}
<link rel="alternate" hreflang="x-default" href={currentPath} />
Astros Content Layer API eignet sich hervorragend für mehrsprachige Content Collections. Inhalte werden in sprachspezifischen Verzeichnissen gespeichert und über das Collection-Schema mit Sprachmetadaten versehen. In Astro 6 können Live Content Collections Übersetzungen sogar zur Laufzeit aus externen Quellen wie Headless CMS oder Translation-Management-Systemen laden – ohne Rebuild.
Für die Sitemap-Generierung mit korrekten hreflang-Alternates bietet die offizielle @astrojs/sitemap-Integration automatische Unterstützung für i18n-Konfigurationen. Die generierte sitemap.xml enthält für jede Seite alle verfügbaren Sprachvarianten – wichtig für Google und andere Suchmaschinen, um die richtige Version in den richtigen Suchergebnissen anzuzeigen.
Häufig gestellte Fragen (FAQ)
Die wichtigsten Fragen zur Astro JS Lokalisierung – von i18n-Konfiguration über hreflang-Tags bis zu Content Collections und SEO-Strategien für mehrsprachige Websites.
Astro JS Lokalisierung (i18n) ist das integrierte System zur Erstellung mehrsprachiger Websites. Sprachen, URL-Prefixe und Routing-Strategien werden zentral in der astro.config.mjs konfiguriert. Seit Astro 5 ist i18n-Routing nativ im Framework verankert – ohne externe Plugins. Im Jahr 2026 ergänzen Astro 6 und Cloudflare Live Content Collections für Runtime-Übersetzungen.
In der astro.config.mjs definierst du defaultLocale, locales und die routing-Strategie. Mit prefixDefaultLocale: false erscheint die Standardsprache ohne URL-Prefix (/about statt /de/about). Astro generiert automatisch sprachspezifische URL-Pfade und stellt Astro.currentLocale in Komponenten über die Middleware bereit.
Astro bietet zwei Hauptstrategien: prefixDefaultLocale: false zeigt die Standardsprache ohne Prefix, alle anderen Sprachen erhalten ihr Kürzel als URL-Prefix. Mit prefixDefaultLocale: true erhalten alle Sprachen einheitlich einen Prefix. Die Wahl beeinflusst SEO-Strategie, kanonische URLs und hreflang-Implementierung der gesamten Website.
Astro erlaubt die Gruppierung mehrerer BCP-47-Sprachcodes unter einem URL-Prefix. Zum Beispiel können de, de-AT und de-CH unter dem Pfad 'de' zusammengefasst werden. Das ist besonders nützlich für DACH-Projekte oder internationale Websites mit regionalen Sprachvarianten. Die Konfiguration erfolgt als Objekt mit path und codes in der locales-Definition.
Seit der Cloudflare-Übernahme im Januar 2026 und dem Astro 6 Release profitiert i18n von Live Content Collections für Runtime-Übersetzungen ohne Rebuild. Die workerd-Runtime sorgt für konsistentes Dev/Prod-Verhalten. Server-seitig gerenderte mehrsprachige Seiten laufen am Edge mit Zugriff auf Cloudflare KV, R2 und Workers AI für dynamische Übersetzungsfunktionen.
Hreflang-Tags werden im head-Bereich der Layout-Komponente dynamisch generiert. Über Astro.url.pathname und die konfigurierten locales wird für jede Sprachversion ein link-Tag mit rel="alternate" und dem entsprechenden hreflang-Attribut erzeugt. Zusätzlich sollte ein x-default hreflang für die Fallback-Sprache gesetzt werden – wichtig für korrektes internationales SEO.
Die offizielle @astrojs/sitemap-Integration erkennt automatisch die i18n-Konfiguration und generiert für jede Seite alle verfügbaren Sprachvarianten mit korrekten hreflang-Alternates. Die sitemap.xml enthält damit alle sprachspezifischen URLs und signalisiert Google, welche Version für welche Region relevant ist. Die Integration wird über astro add sitemap installiert.
Inhalte werden in sprachspezifischen Unterordnern innerhalb der Collection organisiert, zum Beispiel content/blog/de/ und content/blog/en/. Das Collection-Schema kann Sprachmetadaten wie locale als Feld definieren. In Astro 6 ermöglichen Live Content Collections das Laden von Übersetzungen zur Laufzeit aus externen Quellen wie Headless CMS oder Translation-Management-Systemen.
Astro.currentLocale wird über die i18n-Middleware automatisch bereitgestellt und enthält den aktiven Sprachcode der aktuellen Route. Damit lassen sich Sprachweichen in Navigation, Footer und Content-Bereichen dynamisch rendern. In Kombination mit getRelativeLocaleUrl() können Links zu anderen Sprachversionen derselben Seite programmatisch erzeugt werden.
Ja, Astro eignet sich hervorragend für mehrsprachige Headless-CMS-Setups. CMS wie Sulu, Strapi oder Contentful liefern Inhalte in verschiedenen Sprachen über ihre API. Dynamische Routen laden die sprachspezifischen Inhalte per getStaticPaths() zur Build-Zeit oder im Server-Modus zur Laufzeit. Die Content Layer API in Astro 6 macht die Integration besonders nahtlos.
Astro generiert standardmäßig statisches HTML ohne JavaScript-Runtime, was zu schnelleren Ladezeiten für mehrsprachige Content-Websites führt. Next.js lädt eine React-Runtime für Client-Side-Navigation und bietet automatische Locale-Detection über den Accept-Language-Header. Astro ist leichtgewichtiger für statische mehrsprachige Websites, Next.js bietet mehr Built-in-Features für dynamische i18n-Applikationen.
Korrekte hreflang-Tags signalisieren Suchmaschinen die Beziehung zwischen Sprachversionen und verhindern Duplicate-Content-Probleme. Zusätzlich sollte jede Sprachversion eine kanonische URL mit dem rel="canonical" Tag setzen. Die einheitliche Trailing-Slash-Konfiguration über trailingSlash in der astro.config.mjs ist ebenfalls wichtig für konsistente URLs.
Der Astro Dev-Server zeigt alle sprachspezifischen Routen in der Konsole an. Du kannst die Sprache über die URL wechseln: /en/about, /fr/about. In Astro 6 nutzt der Dev-Server die workerd-Runtime für konsistentes Verhalten. Für automatisierte Tests empfiehlt sich Playwright mit sprachspezifischen Testsuites, die hreflang-Tags, Content und Sprachweichen prüfen.
Astro bietet keine eingebaute automatische Übersetzung – Inhalte müssen manuell oder über externe Translation-Management-Systeme erstellt werden. Über Astro 6 Live Content Collections können Übersetzungen jedoch zur Laufzeit aus externen Diensten geladen werden. Integration mit KI-Übersetzungstools wie DeepL oder Google Translate ist über API-Endpunkte im Server-Modus möglich.
Für Projekte mit vielen Sprachen empfiehlt sich die Kombination aus Content Collections und einem Headless CMS als Single Source of Truth. Die Verzeichnisstruktur wächst linear mit jeder Sprache, bleibt aber dank Astros dateibasiertem Ansatz übersichtlich. Shared Layouts und Komponenten reduzieren Redundanz. Server-Side-Rendering mit Edge-Deployment auf Cloudflare skaliert auch bei vielen Sprachvarianten performant.
Fazit: Astro JS Lokalisierung – native i18n für performante mehrsprachige Websites
Astros integriertes i18n-Routing gehört zu den durchdachtesten Lokalisierungslösungen im modernen Frontend-Ökosystem. Die zentrale Konfiguration in der astro.config.mjs, automatische URL-Generierung, Middleware-Unterstützung über Astro.currentLocale und benutzerdefinierte Locale-Pfade für regionale Varianten decken alle gängigen Anforderungen ab – vom zweisprachigen Blog bis zur mehrsprachigen Enterprise-Website.
Mit Astro 6, der Cloudflare-Integration und Live Content Collections wird die Lokalisierung 2026 noch flexibler: Runtime-Übersetzungen aus Headless CMS, Edge-Deployment für schnelle Auslieferung weltweit und die workerd-Runtime für konsistente Entwicklung. Für SEO sorgen automatische hreflang-Tags, die @astrojs/sitemap-Integration und statisches HTML ohne JavaScript-Overhead – ideal für internationale Content-Websites, die in Google und KI-Suchsystemen sichtbar sein müssen.
Du planst eine mehrsprachige Website mit Astro oder brauchst Unterstützung bei hreflang-Strategie, Headless-CMS-Integration oder Barrierefreiheit? Bei Never Code Alone verbinden wir Astro-Frontend-Expertise mit Backend-Know-how aus Sulu CMS und Symfony. Vereinbare eine kostenlose Erstberatung unter roland@nevercodealone.de oder ruf direkt an: +49 176 24747727.