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.

웹 & SEO소속: 웹 & SEO 도구 →

Hreflang 생성기

대체 로케일 URL에 대한 hreflang link 태그와 x-default 출력을 생성합니다.

데이터는 기기에 남습니다업로드 없음, 서버 없음오프라인 작동

이 도구를 사용하는 이유

각 태그를 수동으로 작성하지 않고 로케일과 URL 쌍으로부터 alternate-language 태그를 만듭니다.

로케일별 URL이 있고 페이지 헤드에 hreflang 블록이 필요할 때 활용하십시오.

로케일 쌍과 x-default 출력을 한 곳에서 관리하는 데 도움이 됩니다.

사용 방법

01기본 로케일을 설정합니다.

02행별로 로케일과 URL을 입력합니다.

03생성된 hreflang 태그를 복사합니다.

복사 전 빠른 확인

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.

자주 묻는 질문

나중에 더 많은 로케일을 추가할 수 있습니까?

네. 시작 행은 기본값일 뿐이며 도구가 확장되면 행을 추가할 수 있습니다.

x-default hreflang이란 무엇입니까?

사용자의 지역에 맞는 로케일별 페이지가 없을 때 표시되는 기본 언어 버전을 나타냅니다.

한 언어로만 게시하는 경우 hreflang이 필요합니까?

아니요. hreflang은 동일한 콘텐츠가 여러 언어 또는 지역에 존재할 때만 유용합니다.

Hreflang 생성기

대체 로케일 URL에 대한 hreflang link 태그와 x-default 출력을 생성합니다.

데이터는 기기에 남습니다업로드 없음, 서버 없음오프라인 작동

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

이 도구를 사용하는 이유

각 태그를 수동으로 작성하지 않고 로케일과 URL 쌍으로부터 alternate-language 태그를 만듭니다.

로케일별 URL이 있고 페이지 헤드에 hreflang 블록이 필요할 때 활용하십시오.

로케일 쌍과 x-default 출력을 한 곳에서 관리하는 데 도움이 됩니다.

사용 방법

01기본 로케일을 설정합니다.

02행별로 로케일과 URL을 입력합니다.

03생성된 hreflang 태그를 복사합니다.

복사 전 빠른 확인

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.

자주 묻는 질문

나중에 더 많은 로케일을 추가할 수 있습니까?

네. 시작 행은 기본값일 뿐이며 도구가 확장되면 행을 추가할 수 있습니다.

x-default hreflang이란 무엇입니까?

사용자의 지역에 맞는 로케일별 페이지가 없을 때 표시되는 기본 언어 버전을 나타냅니다.

한 언어로만 게시하는 경우 hreflang이 필요합니까?

아니요. hreflang은 동일한 콘텐츠가 여러 언어 또는 지역에 존재할 때만 유용합니다.

Hreflang 생성기

이 도구를 사용하는 이유

사용 방법

복사 전 빠른 확인

자주 묻는 질문

관련 도구

Canonical 태그 검사기

사이트맵 URL 목록 생성기

SEO 사전 검토 워크스페이스

Hreflang 생성기

이 도구를 사용하는 이유

사용 방법

복사 전 빠른 확인

자주 묻는 질문

관련 도구

Canonical 태그 검사기

사이트맵 URL 목록 생성기

SEO 사전 검토 워크스페이스

Hreflang 생성기

Canonical 태그 검사기→

사이트맵 URL 목록 생성기→

SEO 사전 검토 워크스페이스→

Hreflang 생성기

Canonical 태그 검사기→

사이트맵 URL 목록 생성기→

SEO 사전 검토 워크스페이스→

Canonical 태그 검사기

사이트맵 URL 목록 생성기

SEO 사전 검토 워크스페이스

Canonical 태그 검사기

사이트맵 URL 목록 생성기

SEO 사전 검토 워크스페이스