Hreflang Tags

30-60 minAdvanced

Implement hreflang tags for multi-language and multi-region stores to help Google serve the correct version to users based on language and location.

Prerequisites

  • Multi-store or multi-website Magento setup
  • Store views configured for different languages/regions
Beginner

Using SEO Extension

Most reliable method via extension.

1

Install Extension

1

Use extensions like Mageworx SEO Suite, Amasty SEO Toolkit, or Mageplaza SEO

2

These automatically generate hreflang based on store view configuration

2

Configure Store Views

1

Go to Stores > All Stores

2

Ensure each language/region has a separate Store View

3

Set correct locale under Stores > Configuration > General > Locale Options for each view

3

Map Hreflang Codes

1

In extension settings, map each store view to its hreflang code

2

Example: en-us, en-gb, de-de, fr-fr

Verification Checklist

Pro Tips

  • Ensure hreflang URLs are absolute, not relative
  • Each page must have reciprocal hreflang links (A links to B, B links to A)
  • Use consistent URL patterns across languages

Common Issues & Fixes

Problem:
Solution: Ensure all language versions link to each other
Problem:
Solution: Use ISO 639-1 language + ISO 3166-1 Alpha 2 region (e.g., en-GB, not en-UK)