Hreflang mastery
The 8 Most Common Hreflang Errors and How to Fix Each
Most hreflang problems fall into eight recurring patterns. Recognising the pattern makes the fix quick instead of a multi-day investigation.
Want to earn a Rankar Academy certificate?
This lesson is free to read in full, with nothing to sign up for. Join the Academy to track your learning, complete courses and sit the certification assessment.
Join the Academy →Search journey
International SEO · Hreflang mastery
Stage 1
Errors one through four
Stage 2
Errors five through eight
Stage 3
this lesson matters
Errors one through four
Missing return tags — page A points to page B but B doesn't point back — is the most common error and invalidates the whole cluster. Incorrect language/region codes, such as using 'uk' instead of the correct 'gb' for the United Kingdom (uk is not a valid ISO 3166-1 code; the correct code is gb), silently fail. Hreflang pointing to non-canonical or redirected URLs confuses Google about which URL is actually meant to rank. Hreflang pointing to a noindexed or blocked URL tells Google to swap to a page it isn't allowed to show, which Google will simply ignore.
Each of these is detectable by crawling your hreflang cluster and cross-checking status codes, canonical tags and robots directives against the declared hreflang targets — this is mechanical work best automated rather than done by eye.
- 1. Missing return tags (one-directional relationships)
- 2. Incorrect ISO codes (uk instead of gb is the classic case)
- 3. Hreflang pointing to redirected or non-canonical URLs
- 4. Hreflang pointing to noindexed/blocked pages
Errors five through eight
Conflicting hreflang and canonical tags — where the canonical points to a different URL than the one being referenced in the hreflang set — causes Google to consolidate the cluster onto the canonical target and effectively strip out the alternates. Missing self-referencing tags, where a page lists alternates but never lists itself, is treated as inconsistent by Google's documentation. Multiple URLs claiming the same hreflang value (two pages both declared as en-us) creates an ambiguous instruction Google can't safely act on. Relative URLs instead of absolute URLs in the href attribute are also a frequent, easy-to-miss bug that breaks the tag entirely.
Fix these systematically: build a validation pass that checks each of the eight patterns against every hreflang cluster on the site, and re-run it after every content or template deployment, not just once at launch.
- 5. Hreflang and canonical tags disagreeing on the target URL
- 6. Missing self-referencing hreflang tag
- 7. Two URLs claiming the same hreflang value
- 8. Relative URLs used instead of absolute URLs in href
Why this lesson matters
Incorrect hreflang implementation directly hinders your international ranking potential and can waste significant crawl budget. Imagine a scenario where you have perfectly translated content for France, Germany, and Spain. Without correct hreflang, Google's algorithms may struggle to understand which page is authoritative for each market, potentially serving the wrong language version to users or splitting link equity across multiple 'duplicate' pages. This leads to lower visibility in search results for specific regions, diluted authority, and a fragmented user experience, ultimately impacting traffic, conversions, and brand perception in crucial international markets.
Conversely, mastering hreflang ensures search engines correctly interpret your international content strategy. Properly implemented, it consolidates link signals, clarifies geopolitical targeting, and improves organic search visibility across all intended locales. Consider a global e-commerce brand launching in Canada, with distinct English (en-CA) and French (fr-CA) versions, alongside their primary US English (en-US) site. Accurate hreflang directs Canadian English speakers to en-CA, French speakers to fr-CA, and US users to en-US. This precision maximises relevant organic traffic to each regional store, enhances user satisfaction by delivering localised experiences, and drives stronger conversion rates, directly boosting international revenue.
Prioritising Hreflang Fixes: The Impact Matrix
When faced with a multitude of hreflang errors, it's crucial to prioritise fixes based on their potential impact and ease of implementation. Not all errors carry the same weight; a missing self-referencing tag on a minor page might be less critical than a widespread misconfiguration affecting your primary market's landing pages. Developing an 'Impact Matrix' helps classify issues by how severely they affect international visibility and how complex they are to resolve, allowing your team to allocate resources effectively and achieve the greatest SEO gains with available capacity.
This strategic approach avoids getting bogged down in low-impact issues while critical problems persist. For instance, a systemic 'return tag missing' error across hundreds of pages in your highest-priority international market (e.g., Germany) should take precedence over a few isolated instances of incorrect language codes on less critical pages. By assessing each error's reach, potential ranking impact, and the development effort required for a fix, you can create a clear roadmap for remediation, ensuring that your international SEO efforts yield tangible improvements rather than reactive, ad-hoc patching.
Key considerations for the Impact Matrix include:
• Severity: Does it prevent indexing for a market or dilute authority?
• Scope: How many URLs/locales are affected?
• Market Value: What is the business priority of the affected market?
• Remediation Effort: How complex is the technical fix?
Do it now
Immediately verify the current hreflang status of your primary international target pages. Use RankTracker's Site Audit tool to initiate a crawl of your international domain(s), then navigate to the 'Localisation' section to review detected hreflang attributes and any reported issues. This will give you an immediate, actionable overview of your current implementation health, pinpointing specific URLs that require attention based on the common error patterns discussed.
Here are your immediate steps:
1. Open RankTracker and select your international project.
2. Run a full 'Site Audit' crawl if not recently performed.
3. Navigate to 'Site Audit' > 'Localisation' > 'Hreflang'.
4. Filter by 'Errors' to see pages with detected issues and begin prioritising based on the Impact Matrix.
Create a project, add keywords page by page, read positions, SERP features, share of voice and competitor gaps.
Key takeaways
- ✓Memorise the eight patterns so audits are fast, not exploratory
- ✓Always check hreflang against canonical and robots directives together
- ✓Use absolute URLs and correct ISO codes without exception
- ✓Re-validate after every deployment, not just at initial launch
Why this lesson matters
This lesson belongs to Hreflang mastery, the part of International SEO where the goal is: write, validate and maintain hreflang so google serves the correct url to the correct market every time.
Read it once, then do it straight away on a real site inside RankTracker. Nothing here is theory for its own sake — every step produces something you can show a client.
Do it now
- 1Open RankTracker with sample data already loaded, so you are not stuck on setup.
- 2Track the keywords from this lesson.
- 3Use RankTracker's hreflang crawl view to list every hreflang cluster on your site and flag any without matching return tags.
