SEOlust
On-page

Hreflang Tag Generator

Generate hreflang tags for international SEO and multilingual sites.

All tools

🌍 Hreflang Tag Generator

Generate hreflang tags for international SEO. Tell search engines about language and regional variants of your pages!

🌐 Language #1

🌐 Language #2

🗣️ Common Language Codes

en - English (generic)
en-US - English (United States)
en-GB - English (United Kingdom)
es - Spanish (generic)
es-ES - Spanish (Spain)
es-MX - Spanish (Mexico)
fr - French (generic)
fr-FR - French (France)
fr-CA - French (Canada)
de - German (generic)
de-DE - German (Germany)
pt - Portuguese (generic)
pt-BR - Portuguese (Brazil)
pt-PT - Portuguese (Portugal)
zh - Chinese (generic)
zh-CN - Chinese (Simplified)
ja - Japanese
x-default - Default/Fallback

💡 Best Practices

  • Add hreflang tags to ALL language/regional variants (bidirectional linking)
  • Use x-default for your default/international version
  • Always self-reference: include the current page's own hreflang
  • Use lowercase language codes (en-us not EN-US)
  • Regional codes should be uppercase (en-US not en-us)
  • Test implementation with Google Search Console

Free Hreflang Tag Generator - Create International SEO Tags Online

Free hreflang tag generator that creates HTML link tags and XML sitemap entries for international SEO and multilingual websites. Generate proper hreflang annotations telling search engines about language and regional variants of your pages, preventing duplicate content issues and ensuring users see the correct language version in search results. Add unlimited language variants including English (en-US, en-GB, en-AU), Spanish (es-ES, es-MX, es-AR), French (fr-FR, fr-CA), German (de-DE, de-AT), Portuguese (pt-BR, pt-PT), Chinese (zh-CN, zh-TW), and 100+ other language-region combinations. Perfect for international businesses, e-commerce sites, global SaaS platforms, publishers with translated content, and SEO professionals managing international campaigns. 100% free with unlimited tag generation, no registration required, instant results, and complete implementation instructions.

What are Hreflang Tags?

Hreflang tags are HTML attributes that tell search engines about the relationship between web pages in different languages or targeting different regions. They help search engines serve the correct language or regional URL to searchers based on their location and language preferences.

  • Hreflang tags are implemented as link elements in the HTML head section or as annotations in XML sitemaps using ISO 639-1 language codes (en, es, fr, de) and optional ISO 3166-1 Alpha 2 country codes (US, GB, MX, ES)
  • The syntax follows the format: link rel='alternate' hreflang='language-region' href='URL' where the hreflang attribute contains the language code, the href points to the alternate version's URL, and rel='alternate' indicates this is an alternative version
  • Example: A US English page includes hreflang tags pointing to its UK English variant (en-GB), Spanish variant (es-ES), French variant (fr-FR), and all other language versions, while each variant reciprocates by linking back creating bidirectional relationships
  • Hreflang solves duplicate content issues when same content exists in multiple languages, prevents incorrect language versions appearing in search results, ensures international users land on correct regional variants, and improves user experience
  • The x-default hreflang value serves as a fallback for users whose language/region doesn't match any specified variants, typically pointing to a language selector page or the site's default international version

Why Hreflang Tags Are Critical for International SEO

Proper hreflang implementation provides multiple SEO benefits and solves problems that can severely damage international search visibility.

  • Prevents Duplicate Content Penalties: Same content translated into multiple languages appears as duplicate to search engines without hreflang. Hreflang signals that pages are equivalent versions not duplicate spam. Search engines consolidate ranking signals across language variants rather than penalizing them
  • Targets Correct Geographic Audiences: Search engines use hreflang to show appropriate language variant in each country's search results. en-US pages appear for searches in United States while en-GB pages show for UK searchers. Regional targeting ensures Mexican Spanish speakers see es-MX not es-ES content
  • Improves Click-Through Rates: Search results display pages in user's language increasing likelihood they click. Searchers trust results in their language more than foreign language alternatives. Localized URLs and titles in SERPs signal relevant content for user's region
  • Enhances User Experience: Users land directly on content in their preferred language without manual selection. Reduces frustration from landing on wrong language version. International customers find region-appropriate pricing, shipping and policies immediately
  • Consolidates SEO Equity: Backlinks to any language variant strengthen all versions through hreflang clustering. Search engines understand all variants are equivalent distributing ranking authority across them. International link building benefits entire site not just specific language versions
  • Prevents Indexing Issues: Search engines index all language variants without confusion. Crawl budget is used efficiently as search engines understand site structure. Prevents accidental de-indexing of language variants that appear duplicate without hreflang

How to Implement Hreflang Tags Correctly

Proper hreflang implementation requires careful attention to syntax, bidirectional linking, and consistent application across all language variants.

  • Choose Implementation Method: HTML link elements in page head section work for most sites and are easiest to implement. XML sitemap annotations centralize hreflang management for large sites with many pages. HTML method recommended for most users as it's visible during page inspection
  • Use Correct Language Codes: ISO 639-1 two-letter language codes (en, es, fr, de, pt, zh, ja) are required. ISO 3166-1 Alpha 2 country codes (US, GB, MX, BR, CN, JP) are optional but recommended. Format is language-REGION with lowercase language and uppercase region (en-US not en-us or EN-US)
  • Create Bidirectional Links: Every page must reference all other language variants plus itself. If page A links to page B then page B must link back to page A. Self-referencing is required - each page includes hreflang pointing to itself. All variants must have identical complete set of hreflang tags
  • Use Absolute URLs: Hreflang href attributes must contain full absolute URLs including protocol and domain. Use https://example.com/page not /page or example.com/page. Include www or non-www consistently matching canonical URL version. Relative URLs are not supported
  • Add to Every Page: Hreflang isn't just for homepage - every page with language variants needs tags. Blog posts need hreflang pointing to translated post versions. Product pages need hreflang for same product in different regional sites. Programmatically generate hreflang for large sites
  • Include x-default Variant: x-default serves users whose language doesn't match any specified variants. Typically points to language selector page or international homepage. Often uses same URL as one language version (frequently English) as fallback
  • Validate Implementation: Use Google Search Console International Targeting report to check for errors. Inspect source code of live pages to verify tags are actually present. Monitor Google Search Console regularly as hreflang errors take weeks to appear

Common Hreflang Mistakes to Avoid

Many hreflang implementations fail due to preventable errors that cause Google to ignore the annotations entirely.

  • Missing Bidirectional Links: Page A links to page B but page B doesn't link back to page A breaks hreflang. Google requires reciprocal links otherwise ignores the annotations. Missing self-references where page doesn't include itself in hreflang tags. Bidirectional errors are most common hreflang problem in Search Console
  • Incorrect Language Codes: Using en-uk instead of en-GB (country codes are ISO 3166-1 Alpha 2). Mixing lowercase and uppercase (en-us should be en-US with uppercase region). Using three-letter codes (eng instead of en) which are ISO 639-2 not 639-1. Never invent language codes - use standard ISO codes only
  • Using Relative URLs: Hreflang requires absolute URLs but developers often use relative paths. /es/page doesn't work - must be https://example.com/es/page. Relative URLs cause hreflang to be ignored. Missing protocol (example.com/page) isn't absolute enough needs https://
  • Homepage-Only Implementation: Only adding hreflang to homepage while forgetting all other pages. Blog posts, product pages and deep content need hreflang tags too. Search engines need hreflang on actual ranking pages not just homepage. Incomplete implementation provides little SEO benefit
  • Incorrect x-default Usage: Not including x-default when serving international audience. Pointing x-default to specific language instead of language selector. Using x-default as only hreflang tag without specific language variants. x-default should point to one canonical international version
  • Pointing to Non-Existent Pages: Hreflang URLs returning 404 not found or 500 server errors. Pointing to pages that redirect elsewhere creating redirect chains. Linking to pages blocked by robots.txt preventing Google from verifying. Verify all hreflang URLs are live and accessible
  • Mixing Content Languages: Hreflang points to pages that aren't actually translations or equivalent content. Linking blog post about topic A to blog post about topic B in another language. Content must be equivalent even if not word-for-word translation

Hreflang for Different Site Structures

International sites use various URL structures each requiring specific hreflang implementation approaches.

  • Subdirectories (example.com/en/ example.com/es/): Most common structure using folders for language versions. Hreflang links all subdirectory variants. Easy to implement and manage on single domain. Benefits from consolidated domain authority across all languages. Works well for small to medium international sites
  • Subdomains (en.example.com es.example.com): Language versions on separate subdomains of main domain. Hreflang links across subdomains. Allows technical independence and separate hosting per language if needed. Requires absolute URLs since different subdomains involved
  • Different Domains (example.com example.es example.fr): Each language/region on separate country-code domain. Hreflang connects completely different domains via cross-domain tags. Provides strongest geo-targeting signal to search engines. Best for truly localized sites with regional teams
  • Hybrid Approaches: Combination like example.com for US, en.example.com for international, and example.es for Spain. Allows flexibility matching business structure and target markets. More complex to manage requiring careful hreflang coordination
  • URL Parameters (NOT Recommended): Using query parameters like example.com?lang=en creates SEO problems. Parameter-based URLs have crawl, indexing and ranking challenges. Avoid this structure for international sites if any alternative is possible

Pro Tip

For bulletproof hreflang implementation, build tags programmatically using your CMS or template system rather than hardcoding them on individual pages. Create a central hreflang management function that automatically generates the complete hreflang set for every page based on its URL path and available translations.

  • Programmatic approach ensures perfect bidirectional linking since every page generates from same source of truth. Automatically maintains self-references without manual effort. Scales effortlessly when adding new language variants. Survives URL changes if you update central configuration
  • Before going live, create comprehensive test checklist verifying every language variant page includes complete hreflang set. All URLs must be absolute and accessible returning 200 status codes. Bidirectional links must be perfect with each page referencing all others plus itself
  • Use Google Search Console's International Targeting report religiously after implementation. Monitor for hreflang errors which Google reports but may take 2-4 weeks to appear. Fix errors immediately as they compound over time
  • For large international sites with hundreds of pages, implement hreflang via XML sitemap rather than HTML link tags. This centralizes management and reduces per-page HTML weight. Consider using both methods for redundancy on critical pages
  • When launching new language variants, add hreflang references to existing pages BEFORE launching new variant. This avoids period where search engines see new variant as duplicate content without hreflang protection. Ensure all variants go live simultaneously
  • Test your hreflang implementation from different geographic locations using VPN or proxy services. Verify Google shows appropriate language variant in search results for each region. Hreflang effects on SERPs may only be visible from target country

FAQ

What is hreflang and why do I need it?
Hreflang tells search engines which language you're using on a page and helps serve the right version to users. It prevents duplicate content issues across language variants and ensures Spanish speakers see Spanish versions, French speakers see French versions, etc.
Do I need hreflang if I only have English content?
If you have one English site serving all countries, you don't need hreflang. But if you have separate en-US, en-GB, and en-AU versions with regional differences (pricing, spelling, products), hreflang is essential to target the right audience.
Where do I add hreflang tags?
Add hreflang link tags in the <head> section of your HTML, or add them to your XML sitemap, or return them via HTTP headers. The HTML method is most common and easiest to implement for most sites.
Do all pages need hreflang tags?
Yes! Every page with language variants needs the complete set of hreflang tags. It's not just for the homepage - blog posts, product pages, and all content with translations need hreflang.
What is x-default and do I need it?
x-default is a fallback for users whose language doesn't match your specified variants. It typically points to a language selector or your default international version. It's recommended but not required.
What does bidirectional linking mean?
Every page must reference all other language variants AND itself. If page A links to page B, then page B must link back to page A. All variants must have the identical complete hreflang set.
Can I use relative URLs in hreflang?
No! Hreflang requires absolute URLs including protocol and domain. Use https://example.com/page not /page. This is a common mistake that causes hreflang to fail.
How do I test my hreflang implementation?
Use Google Search Console's International Targeting report to check for errors. Also use hreflang testing tools, inspect page source to verify tags are present, and test from different countries to see correct versions appear.
Why are my hreflang tags being ignored?
Common reasons: missing bidirectional links, using relative instead of absolute URLs, incorrect language codes, linking to 404 pages, or not including self-references. Check Google Search Console for specific errors.
Should language codes be uppercase or lowercase?
Language codes should be lowercase (en, es, fr) and region codes should be uppercase (US, GB, MX). The full code is language-REGION like en-US, not en-us or EN-US.
Can hreflang hurt my SEO?
Incorrect hreflang implementation can cause problems, but correct implementation only helps. The biggest risk is implementation errors causing Google to ignore the tags or serve wrong versions to users.
How long does hreflang take to work?
Google needs to recrawl and reprocess your pages, which can take 2-6 weeks. Changes appear gradually as Google re-indexes pages. Monitor Google Search Console for confirmation hreflang is working.

Related tools

Pro tip: pair this tool with Meta Tags Generator and Title Tag Analyzer for a faster SEO workflow.