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 標籤產生器

根據語系與網址配對，產生 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" />

為什麼用這個工具

從語系與網址清單自動產生多語系 hreflang 標籤，無需手動逐一撰寫。

適合擁有多語系頁面時，快速產生頁面 head 所需的 hreflang 區塊。

可在同一介面管理所有語系配對與 x-default 設定。

怎麼使用

01設定預設語系。

02逐列輸入語系代碼與對應網址。

03複製產生的 hreflang 標籤。

複製前快速檢查

先確認輸入格式符合您的預期。

在把結果用於文件、連結、設定或訊息前快速掃一眼。

只複製您真正需要的輸出。

常見問題

只有一種語言的網站需要 hreflang 嗎？

不需要，hreflang 僅在相同內容存在多種語言或地區版本時才有用。

x-default hreflang 是什麼意思？

x-default 標示當沒有符合使用者地區的特定語系頁面時，所顯示的預設語言版本。

可以事後新增更多語系嗎？

可以，初始列僅為基礎，可隨時新增更多語系列。

Hreflang 標籤產生器

為什麼用這個工具

怎麼使用

複製前快速檢查

常見問題

相關工具

Canonical 標籤檢查工具

Sitemap 網址清單產生器

SEO 上線前檢查工作台

Hreflang 標籤產生器

Canonical 標籤檢查工具→

Sitemap 網址清單產生器→

SEO 上線前檢查工作台→

Canonical 標籤檢查工具

Sitemap 網址清單產生器

SEO 上線前檢查工作台