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 与 SEO属于 Web 与 SEO 工具 →

Hreflang 生成器

根据语言和 URL 配对生成 hreflang 与 x-default 标签。

数据留在您的设备无需上传至服务器可离线使用

模式

输出格式

拖入 CSV 文件或点击上传两列:locale,url

默认语言

语言 1URL 1

语言 2URL 2

生成的 hreflang 标签

<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" />

为什么用这个工具

为多语言页面生成可复制的 alternate 链接标签。

适合多语言站点整理语言版本 URL 时集中生成 head 标签。

可以同时输出 locale 对应标签和 x-default。

如何使用

01设置默认语言。

02填写语言和 URL 配对。

03复制生成标签。

复制前快速检查

先确认输入格式符合你的预期。

在把结果用于文档、链接、配置或消息前快速扫一眼。

只复制你真正需要的输出。

常见问题

支持输出 x-default 吗？

支持，会根据默认语言或首条记录生成 x-default。

Hreflang 生成器

为什么用这个工具

如何使用

复制前快速检查

常见问题

相关工具

Canonical 检查器

Sitemap URL 列表整理器

seo preflight workspace

Hreflang 生成器

Canonical 检查器→

Sitemap URL 列表整理器→

seo preflight workspace→

Canonical 检查器

Sitemap URL 列表整理器

seo preflight workspace