Hreflang Tag Builder

Generate hreflang tags for multilingual and multi-regional SEO. HTML and XML sitemap output. 100% client-side.

Languages & URLs
Output
Add language/URL pairs and click Generate to build hreflang tags.

How to Use the Hreflang Builder

  1. Choose a preset or start with Custom to manually add languages.
  2. Add language rows — select a language, optional region, and enter the URL for that version of your page.
  3. Add x-default — designate a fallback URL for users whose language does not match any hreflang entry.
  4. Click Generate — the tool outputs HTML link tags or XML sitemap entries, ready to copy.
  5. Toggle HTML / XML Sitemap format using the buttons above the output.

What Are Hreflang Tags?

Hreflang tags are HTML attributes used in <link rel="alternate"> elements that tell search engines which language and regional version of a page to serve to users in different locales. Implemented properly, hreflang tags ensure that a French-speaking user in France sees the French version of your page in Google search results, while an English-speaking user in the United States sees the English version.

The hreflang attribute uses a standardized format: hreflang="xx" for language-only targeting (e.g., en for English) or hreflang="xx-yy" for language-and-region targeting (e.g., en-us for American English, en-gb for British English). Language codes follow ISO 639-1 and region codes follow ISO 3166-1 Alpha-2.

Why Hreflang Tags Matter for International SEO

Without hreflang tags, search engines may display the wrong language version of your page to users, or treat your translated pages as duplicate content. This can lead to the wrong URL ranking in the wrong country, diluted ranking signals across multiple language versions, and a poor user experience for international visitors. Hreflang tags solve all of these problems by creating an explicit mapping between language versions.

The x-default Value

The special hreflang="x-default" value designates a fallback page for users whose language or region does not match any of the other hreflang entries. This is typically set to a language selector page or the main default version of your site (usually English). While optional, including x-default is strongly recommended as a best practice.

Implementation Methods

There are three ways to implement hreflang tags. You only need one:

  • HTML link tags — placed in the <head> section of each page. This is the most common and straightforward approach. Each page in the set must include link tags for all other language versions plus a self-referencing tag.
  • XML sitemap — hreflang annotations are added to your XML sitemap using <xhtml:link> elements. This approach is better for very large sites with many language versions, as it avoids adding many link tags to the HTML.
  • HTTP headers — used for non-HTML resources (PDFs, documents). The Link HTTP header specifies alternate language versions.

Common Hreflang Mistakes

  • Missing self-reference — every page must include a hreflang tag pointing to itself. Without it, search engines may ignore the entire set.
  • Missing return links — hreflang must be reciprocal. If page A points to page B, page B must point back to page A. One-directional references are ignored.
  • Wrong language/region codes — use ISO 639-1 for languages and ISO 3166-1 Alpha-2 for regions. Common mistakes include using en-uk (should be en-gb) or jp (should be ja).
  • Duplicate language codes — each language-region combination should appear only once in the set. Duplicates create conflicting signals.
  • Missing x-default — while technically optional, omitting x-default means there is no fallback for unlisted languages, which may result in poor user experience.

Presets

This tool includes presets for common international setups: English (US/GB) for targeting American and British audiences, European (EN/ES/FR/DE/IT) for covering major European markets, and Asian (EN/JA/KO/ZH) for targeting East Asian markets alongside English. Each preset pre-fills the language and region fields so you only need to enter your URLs. For a complete international SEO workflow, combine hreflang tags with our Canonical Checker to avoid duplicate content, our Meta Tag Generator for localized meta tags, and the Slug Normalizer for consistent URL formatting.

Frequently Asked Questions

Hreflang tags are HTML attributes that tell search engines which language and regional version of a page to show to users. They use the format hreflang="xx" or hreflang="xx-yy" where xx is a language code (ISO 639-1) and yy is an optional region code (ISO 3166-1 Alpha-2).
The x-default hreflang value designates a fallback page for users whose language or region does not match any of the other hreflang values. It is typically set to the main/default version of the page, often the English version or a language selector page.
No, you only need to implement hreflang in one location: either HTML link tags in the head section, XML sitemap entries, or HTTP headers. Using multiple methods is not harmful but is unnecessary. HTML link tags are the most common approach for most websites.
Every page in a hreflang set must include a self-referencing tag pointing to itself. If the self-reference is missing, search engines may ignore the entire hreflang set for that page. This tool validates and warns you if self-referencing tags are missing.
No. This hreflang builder runs 100% in your browser using JavaScript. Your URLs and language configurations never leave your machine. There is no server-side processing, no logging, and no data collection.