GUIDES

How to Implement Hreflang: A Complete International SEO Guide22-Minute Expert Guide by Jason Langella

Learn how to implement hreflang correctly - from the link rel alternate hreflang syntax for English versions to XML sitemap implementation for large international sites. Step-by-step guides for WordPress, Shopify, and enterprise CMS platforms with debugging tools and common mistake prevention.

By Jason Langella · 2025-01-11 · 22 min read

Understanding Hreflang Implementation

For comprehensive technical optimization strategies, explore our [complete Technical SEO Audit guide](/resources/technical-seo-audit-guide). Hreflang annotations help search engines understand the relationship between different language version and regional versions of your content. Each hreflang tag tells search engines which page targets a specific language and region combination. Proper implementation ensures users see the appropriate alternate version for their language and location, improving user experience and preventing duplicate content issues across international seo sites.

When You Need Hreflang

Hreflang is appropriate when you have:

The same content translated into multiple languages
Region-specific versions of content (UK vs US English)
Combined language and regional targeting

You do not need hreflang for:

Single-language, single-country sites
Different products for different countries
Completely different content between regions

Hreflang Syntax and Values

Understanding correct syntax prevents implementation errors.

Basic Syntax

The hreflang attribute uses ISO language and optional country codes in a link rel alternate hreflang pattern:

```html

```

Language Codes

Use ISO 639-1 two-letter language codes for each version of the page:

en (English - used for every english version)
es (Spanish)
fr (French)
de (German)
zh (Chinese)

Region Codes

Optionally add ISO 3166-1 Alpha-2 country codes to distinguish between english speaking regions or other regional variants:

en-US (English for United States - the english page for US users)
en-GB (English for United Kingdom)
es-MX (Spanish for Mexico)
zh-CN (Chinese for China)

X-Default Value

The x-default value indicates a fallback or language selector page:

```html

```

Use x-default for:

Pages that detect user language
Language selection pages
Default version when no other match exists

Implementation Methods

Three methods exist for implementing hreflang.

HTML Link Elements (Head Section)

Add hreflang annotations to the head section of each page:

```html

```

HTTP Headers

For non-HTML files (PDFs, etc.), use http headers to declare hreflang annotations:

```

Link: ; rel="alternate"; hreflang="en",

; rel="alternate"; hreflang="es"

```

XML Sitemap

Include hreflang in your xml sitemap for large-scale international seo deployments:

```xml

https://example.com/page/

```

Critical Implementation Rules

Hreflang requires specific rules for proper function.

Reciprocal Linking

Every page must reference all alternates, including itself:

Page A must link to A, B, and C
Page B must link to A, B, and C
Page C must link to A, B, and C

Missing reciprocal links cause hreflang to be ignored.

Self-Referencing

Each page must include itself in hreflang:

```html

```

Canonical Consistency

Hreflang URLs should match canonical URLs:

Do not hreflang to non-canonical versions
Canonical and hreflang should point to same URL
Avoid conflicts between these signals

Absolute URLs

Always use absolute URLs with protocol:

```html

```

Common Implementation Patterns

Different site structures require different approaches.

Subdirectory Structure

For sites using subdirectories by language:

```

example.com/ (English)

example.com/es/ (Spanish)

example.com/fr/ (French)

```

Subdomain Structure

For sites using subdomains:

```

en.example.com (English)

es.example.com (Spanish)

fr.example.com (French)

```

ccTLD Structure

For country-code top-level domains:

```

example.com (US)

example.co.uk (UK)

example.de (Germany)

```

How to Implement Hreflang on WordPress

WordPress is the most common CMS for international sites, and several approaches exist to implement hreflang correctly depending on your multilingual plugin choice.

Using WPML (WordPress Multilingual Plugin): WPML automatically generates hreflang annotations in the HTML head section for all translated pages. After installing WPML and configuring your language settings, the plugin handles reciprocal linking, self-referencing, and x-default annotations automatically. Verify the output by viewing page source and searching for "hreflang" - WPML occasionally generates incorrect annotations when posts are only partially translated. In WPML Settings > Languages, ensure "SEO" options have hreflang enabled and set your default language as the x-default target.

Using Polylang: Polylang generates hreflang annotations natively when languages are properly configured. Navigate to Languages > Settings > URL modifications and select your preferred URL structure (subdirectory is recommended for most sites). Polylang inserts hreflang link elements in the head section automatically. One common issue: Polylang does not add x-default by default - install the "Polylang Hreflang" add-on or add x-default manually via the wp_head hook.

Manual WordPress implementation: For sites without multilingual plugins, add hreflang via the wp_head action hook in your theme's functions.php file. This approach requires maintaining a mapping array of page IDs to their language variants and generating the appropriate link elements programmatically. While more complex, it provides maximum control over the output.

How to Implement Hreflang on Shopify

Shopify's native international features (Shopify Markets) handle hreflang automatically when you configure market-specific domains or subfolders. When using Shopify Markets with subfolders (e.g., /en-gb/, /fr/), the platform generates hreflang annotations in the HTML head section for all published pages across active markets.

Key configuration steps for Shopify:

1. Navigate to Settings > Markets and create markets for each target country/language

2. Assign subfolders or domains to each market

3. Translate content using Shopify Translate & Adapt app or a third-party translation app

4. Verify hreflang output by viewing page source on product, collection, and content pages

Common Shopify hreflang issues: Shopify generates hreflang only for pages that exist in both markets. If a product is not available in a specific market, no hreflang annotation is generated - which is correct behavior. However, if you unpublish a product in one market without removing the translation, orphaned hreflang references can persist temporarily. Monitor via Google Search Console's International Targeting report.

How to Implement Hreflang via XML Sitemap (Recommended for Large Sites)

*Continue reading the full article on this page.*

Key Takeaways

This guides article shares hands-on strategies for SEO pros, marketing directors, and business owners. Use them to improve organic search and AI visibility across Google, ChatGPT, Perplexity, and other platforms.
The methods here follow Google E-E-A-T guidelines, Core Web Vitals standards, and GEO best practices for 2026 and beyond.
Companies that pair technical SEO with strong content, authority link building, and structured data see lasting organic growth. This growth becomes measurable revenue over time.

HreflangInternational SEOMulti-LanguageTechnical SEO

About the Author: Jason Langella is Founder & Chairman at SEO Agency USA, delivering enterprise SEO and AI visibility strategies for market-leading organizations.