Technical SEO
How to add hreflang tags correctly
Add a link rel="alternate" hreflang element for every language or regional variant, including a self-reference, on every page in the cluster — and add x-default for the fallback. Every page must list every other, or the cluster is ignored.
Before you start
- Genuinely distinct regional or language versions
- Access to the page templates
The steps
-
Step 1: Confirm you actually need it
Only for genuinely different language or regional versions. Near-identical pages differing by a swapped city name are doorway pages, not an hreflang cluster.
-
Step 2: List every variant
With its language code, and region code where the region genuinely differs.
-
Step 3: Add the tags to every page
Each page lists every variant including itself. Omitting the self-reference invalidates the cluster.
-
Step 4: Add x-default
Pointing at the fallback for anyone whose language and region you do not target.
-
Step 5: Use absolute canonical URLs
Matching the canonical tag on each page exactly. A mismatch breaks the association.
-
Step 6: Check reciprocity
If A points at B, B must point back at A. One-directional references are discarded.
-
Step 7: Validate after deploying
Search Console’s international targeting report reports errors in the live implementation.
The most common reason it does nothing
Non-reciprocal tags. Adding hreflang to a new regional page without updating the existing ones to point back means the cluster is not recognised at all, and the effort produces no effect whatsoever.
English-only sites usually do not need it
If your UK and Canadian pages differ only in currency and a few examples, hreflang is unlikely to help and may create duplicate-content confusion. It earns its place when the content genuinely differs by market — different prices, terms, regulations or language.
The background behind this
hreflang, and the honest answer that most sites do not need it covers the reasoning in about 2 minutes — free, ungated, written from client work.
Who wrote this
Anas Bin Masud builds e-commerce sites and does technical SEO for businesses in the UK, Canada, Ireland and Pakistan. These procedures are the ones I run on client work, written down rather than invented — including the ones where the honest answer is that the fix is not available on your current hosting.