Hreflang Tags

30-60 minAdvanced

Implement hreflang for multi-language/region stores to serve correct versions to international users.

Prerequisites

  • Multi-Storefront or custom implementation
  • Access to theme files
Advanced

Manual Implementation

Add hreflang tags to theme.

1

Edit Head Section

1

Edit templates/layout/base.html or head.html

2

Add hreflang link tags for each language version

Example
<link rel="alternate" hreflang="en-us" href="{{siteurl}}/product" />
<link rel="alternate" hreflang="en-gb" href="https://uk.yourstore.com/product" />
<link rel="alternate" hreflang="x-default" href="{{siteurl}}/product" />
2

Use Handlebars Logic

1

Create logic to generate correct URLs per page

2

Ensure all versions have reciprocal links

Verification Checklist

Pro Tips

  • Always include x-default for fallback
  • Use absolute URLs in hreflang attributes
  • Ensure reciprocal linking (A links to B, B links to A)