Your hreflang configuration stays in your browser. Nothing is sent to Q3 Labs.
Alternate versions
| x-default | Language | Region | URL | Actions |
|---|---|---|---|---|
If supplied, checks whether this URL appears in the alternate set above.
Hreflang helps search engines understand alternate language or regional versions of a page. It is not a ranking boost by itself, and it doesn't translate content or replace localized pages.
0 errors, 0 warnings.
Place these tags inside the <head> of every page listed above.
Add at least one valid language/URL pair to generate HTML.What Is Hreflang?
Hreflang is an annotation — as an HTML <link> tag, an HTTP header, or an XML sitemap entry — that tells search engines about alternate language or regional versions of a page, so they can point a user searching in French to the French version and a user searching in English to the English version.
Why Use Hreflang?
If you maintain equivalent content in more than one language or for more than one region, hreflang helps search engines serve the right version to the right visitor, and can help avoid different language versions of the same content being treated as unrelated or duplicate pages.
When Should You Use Hreflang?
When you have two or more URLs serving equivalent content in different languages or for different regions. A single-language, single-region site generally has no need for it — hreflang exists to relate alternate versions, not to describe a page that has no alternates.
Language Codes vs Country Codes
A hreflang value is a language code (e.g. fr), optionally followed by a region/country code (e.g. fr-FR). The language subtag alone is enough when you don't need to distinguish between regions; the region is only added when the content genuinely differs by region. Google's own documentation specifically warns against specifying a region code alone, without a language code.
What Does en-US Mean?
English-language content specifically intended for readers in the United States — as distinct from English content aimed at the UK, Canada, or another English-speaking region.
What Does fr-FR Mean?
French-language content specifically intended for readers in France — as distinct from French content aimed at Canada, Belgium, or Switzerland, which would use a different region code.
What Is x-default?
x-default can be used for a default page when no other language or regional version is appropriate — for example, a language-selector page or a generic international version. It's a recommended option in many setups, not a mandatory one, and this tool only warns (rather than errors) when it's missing.
How Hreflang Works With Multilingual Websites
Every page in an alternate-language cluster carries the exact same set of hreflang annotations, listing every version — including itself. When two pages don't both reference each other, search engines may disregard the annotations, which is why the reciprocal relationship matters as much as the syntax itself.
HTML Hreflang vs XML Sitemap Hreflang
Both express the same relationship; they differ in where the annotation lives. HTML <link> tags live in each page's own <head>; XML sitemap annotations centralize the same information in one sitemap file using <xhtml:link> elements, which can be more practical to maintain at scale without editing every page's markup. An HTTP Link header is a third option, mainly useful for non-HTML resources.
Hreflang and Canonical URLs
Canonical and hreflang serve different purposes. A canonical tag indicates the preferred version among duplicate or near-duplicate URLs; hreflang identifies alternate language/region versions of otherwise equivalent content. A common and reasonable pattern is for each localized page to canonicalize to itself, not to a single "master" language version — canonicalizing every language version to one language would tell search engines the other language versions are duplicates to be consolidated, undermining the very point of having them.
Common Hreflang Mistakes
- Invalid language codes, or a region code used without a language code.
- Incorrect region capitalization (regions should be uppercase, e.g. FR not fr).
- Duplicate hreflang values across different entries.
- Missing self-reference — a page not listing itself among its own alternates.
- Missing reciprocal references — pages that don't point back to each other.
- Incorrect or relative URLs where absolute URLs are expected.
- Using hreflang to relate pages that aren't actually equivalent content.
- Treating hreflang as a translation mechanism rather than an annotation of already-existing pages.
- Using URL fragments, which aren't meaningful for identifying alternate HTML pages.
- A canonical implementation that conflicts with the hreflang relationships.
- Not using x-default where a genuine fallback page would help.
- Targeting a language/region with hreflang without any actually localized content for it.
Hreflang and Duplicate Content
Hreflang can help clarify that near-identical pages in different languages are intentional alternates rather than duplicate content, but it isn't a duplicate-content fix by itself — it's a relationship annotation, and the underlying pages still need to be genuinely intended as distinct language/region versions.
Does Hreflang Improve Rankings?
It isn't documented as a ranking factor. Hreflang helps search engines direct users to the most appropriate language/region version of a page — a search-presentation and user-experience mechanism, not a signal that boosts a page's position in results.
How to Implement Hreflang Correctly
- Use absolute URLs (with protocol and domain) for every entry.
- Include each page itself in its own alternate set, not just the others.
- Make sure every page in the set actually points back to every other page (reciprocal references).
- Use lowercase language codes and uppercase region codes.
- Only add a region when the content genuinely differs by region.
- Choose one implementation method (HTML, HTTP header, or sitemap) per set of pages, consistently.
- Verify the live result — this tool validates the configuration you build, not what your server actually returns.
Frequently Asked Questions
Explore more
Check whether your alternate URLs actually exist and return successfully with the HTTP Status Checker, or inspect a live page's full on-page signals with the On-Page SEO Checker and Meta Tag Checker. Generate a full sitemap with the XML Sitemap Generator and manage crawler access with the Robots.txt Generator & Tester. Draft a title and description for each localized page with the SEO Title & Meta Description Generator, preview how it looks in results with the SERP Snippet Preview, and add structured data with the JSON-LD Schema Markup Generator. Explore the rest of our free marketing tools, or see our SEO & organic growth services.
Related tools & resources
Related tools
- SERP Snippet PreviewPreview how your title, URL and meta description could look in a Google-style search result.
- Slug GeneratorTurn titles into clean, readable URL slugs as you type, with Unicode support and a URL preview. Nothing is up…
- Reverse Image SearchUpload a photo or paste an image URL to find visually similar images, possible sources, and related results o…
Learn more
- SEO GuidesTechnical SEO, on-page fundamentals, and the checklist we run against every client site before it goes live.
- SEO & Organic GrowthMost SEO work stalls after the first few technical fixes because there's no system connecting content, author…
Related articles
- The 2026 Technical SEO Checklist for Growing BrandsCore Web Vitals, structured data, and crawl budget: the technical fundamentals still separate the sites that…
- How Long Does SEO Take to Show ResultsSEO usually takes three to six months to show movement and six to twelve to deliver steady leads. Here is wha…
