What is hreflang and when do I need it?

Hreflang is an HTML attribute that tells Google which version of a page to show users in different languages or regions. You need it when the same content exists in multiple translations or regional variants (e.g., en-US vs en-GB). Without it, Google may show the wrong language or treat your translations as duplicate content.

Do hreflang tags need to be bidirectional?

Yes. Every page in a hreflang group must reference every other page, including itself. If the English page references the Spanish version, the Spanish version must reference the English back. Google ignores hreflang tags that aren't reciprocal.

What is the x-default hreflang and is it required?

x-default specifies the fallback page shown when no locale-specific version matches a user's settings. It's strongly recommended (especially for global homepage layouts) but not strictly required. We recommend always including it.

Why is Google ignoring my hreflang tags?

The #1 reason is missing return tags — page A points to page B as an alternate, but B does not point back to A. Google requires every page in a group to reference every other page (including itself). Other common causes: malformed locale codes (use ISO 639-1 plus ISO 3166-1, not country names), pointing to redirecting URLs, or mixing canonical and hreflang in conflicting ways. Use the Validate tab to surface these before publishing.

Do I need self-referencing hreflang tags?

Yes — strongly recommended. Each page should list itself as one of the alternates in its own hreflang block (for example, the English page declares en-US as one of its alternates pointing to its own URL). Without a self-reference, Google may treat the group as ambiguous and pick an unpredictable variant for search results.

Can I bulk-import locales from a CSV?

Yes. Drop a CSV file with two columns — locale, URL — onto the dropzone in Generate mode. A header row (locale,url) is auto-detected and skipped. Empty rows are filtered out. The status message reports how many locales loaded.

Should I put hreflang in HTML head or in sitemap.xml?

Both work — Google treats them equivalently. Link tags in the head are easier for small sites. XML sitemap declarations scale better for large sites with hundreds of alternates per page (and avoid bloating every HTML response). Pick one delivery channel per page to keep things consistent.

Does hreflang work for region-only variants like en-US vs en-CA?

Yes, this is the primary use case for regional codes. The format is language-region where region uses ISO 3166-1 alpha-2 (en-US, en-GB, en-AU, en-CA). Google will show the right variant based on user location and browser language.

Can I use hreflang across subdomains or different domains?

Yes. hreflang URLs can point to subdomains (es.example.com), subdirectories (example.com/es/), or entirely different domains (example.es). All three are equally valid as long as you reference the full canonical URL.

Do I need hreflang if I only publish in one language?

No. Hreflang is only meaningful for content that exists in multiple languages or regional variants. Single-language sites don't need it.

Is the generator safe to use with proprietary or staging URLs?

Yes. Everything runs in your browser. No URLs, locales, or generated tags are sent to any server — there's no upload, no logging, no tracking.

Web & SEOTeil von Web- & SEO-Tools →

Hreflang Generator

Hreflang-Tags für alternative Sprach-URLs generieren und x-default-Ausgabe einbinden.

Ihre Daten bleiben auf Ihrem GerätKein Upload, kein ServerFunktioniert offline

Warum dieses Tool verwenden

Alternate-Language-Tags aus Locale- und URL-Paaren erstellen, ohne jeden Tag manuell zu schreiben.

Verwenden, wenn sprachspezifische URLs vorhanden sind und der Hreflang-Block für den Seiten-Head benötigt wird.

Hält Locale-Paare und x-default-Ausgabe an einem Ort.

So wird's verwendet

01Den Standard-Locale festlegen.

02Einen Locale und eine URL pro Zeile eingeben.

03Die generierten Hreflang-Tags kopieren.

Schnellcheck vor dem Kopieren

Confirm the input is the format you intended.

Scan the result before using it in a document, URL, config, or message.

Copy only the output you need.

FAQ

Wird Hreflang benötigt, wenn nur in einer Sprache veröffentlicht wird?

Nein. Hreflang ist nur nützlich, wenn derselbe Inhalt in mehreren Sprachen oder Regionen existiert.

Was ist x-default Hreflang?

Markiert die Standard-Version, die angezeigt wird, wenn keine spezifische Locale-Seite mit der Region des Nutzers übereinstimmt.

Können später weitere Locales hinzugefügt werden?

Ja. Die Anfangszeilen sind nur eine Basis; weitere Zeilen können bei Bedarf hinzugefügt werden.

Hreflang Generator

Hreflang-Tags für alternative Sprach-URLs generieren und x-default-Ausgabe einbinden.

Ihre Daten bleiben auf Ihrem GerätKein Upload, kein ServerFunktioniert offline

Mode

Output format

Drop a CSV here or click to loadTwo columns: locale,url

Default locale

Locale 1URL 1

Locale 2URL 2

Generated hreflang tags

<link rel="alternate" hreflang="en" href="https://toolgrid.app/tools/url-parser" />
<link rel="alternate" hreflang="zh-CN" href="https://toolgrid.app/tools/url-parser?lang=zh-CN" />
<link rel="alternate" hreflang="x-default" href="https://toolgrid.app/tools/url-parser" />

Warum dieses Tool verwenden

Alternate-Language-Tags aus Locale- und URL-Paaren erstellen, ohne jeden Tag manuell zu schreiben.

Verwenden, wenn sprachspezifische URLs vorhanden sind und der Hreflang-Block für den Seiten-Head benötigt wird.

Hält Locale-Paare und x-default-Ausgabe an einem Ort.

So wird's verwendet

01Den Standard-Locale festlegen.

02Einen Locale und eine URL pro Zeile eingeben.

03Die generierten Hreflang-Tags kopieren.

Schnellcheck vor dem Kopieren

Confirm the input is the format you intended.

Scan the result before using it in a document, URL, config, or message.

Copy only the output you need.

FAQ

Wird Hreflang benötigt, wenn nur in einer Sprache veröffentlicht wird?

Nein. Hreflang ist nur nützlich, wenn derselbe Inhalt in mehreren Sprachen oder Regionen existiert.

Was ist x-default Hreflang?

Markiert die Standard-Version, die angezeigt wird, wenn keine spezifische Locale-Seite mit der Region des Nutzers übereinstimmt.

Können später weitere Locales hinzugefügt werden?

Ja. Die Anfangszeilen sind nur eine Basis; weitere Zeilen können bei Bedarf hinzugefügt werden.

Hreflang Generator

Warum dieses Tool verwenden

So wird's verwendet

Schnellcheck vor dem Kopieren

FAQ

Verwandte Tools

Canonical-Tag-Prüfer

Sitemap-URL-Listen-Generator

SEO Preflight Workspace

Hreflang Generator

Warum dieses Tool verwenden

So wird's verwendet

Schnellcheck vor dem Kopieren

FAQ

Verwandte Tools

Canonical-Tag-Prüfer

Sitemap-URL-Listen-Generator

SEO Preflight Workspace

Hreflang Generator

Canonical-Tag-Prüfer→

Sitemap-URL-Listen-Generator→

SEO Preflight Workspace→

Hreflang Generator

Canonical-Tag-Prüfer→

Sitemap-URL-Listen-Generator→

SEO Preflight Workspace→

Canonical-Tag-Prüfer

Sitemap-URL-Listen-Generator

SEO Preflight Workspace

Canonical-Tag-Prüfer

Sitemap-URL-Listen-Generator

SEO Preflight Workspace