seo-hreflang

Validates and generates hreflang tags for multi-language and multi-region websites.

Updated Mar 26, 2026
One-click install
npx skills add https://github.com/LGJ-Jonathan/Jonathan_Global_Claude_Skills --skill seo-hreflang-lgj-jonathan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: seo-hreflang
Source: https://github.com/LGJ-Jonathan/Jonathan_Global_Claude_Skills/tree/main/claude-seo/skills/seo-hreflang
Command: npx skills add https://github.com/LGJ-Jonathan/Jonathan_Global_Claude_Skills --skill seo-hreflang-lgj-jonathan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Incorrect hreflang implementations cause search engines to ignore international targeting signals, sending users to the wrong language or region version of a page. This Skill audits existing hreflang setups, detects common mistakes like missing return tags or invalid language codes, and generates correct implementations. ## Core Features & Use Cases - Hreflang Validation: Checks self-referencing tags, bidirectional return tags, x-default fallbacks, ISO 639-1 language codes, ISO 3166-1 region codes, canonical URL alignment, and protocol consistency. - Tag Generation: Produces hreflang implementations as HTML link tags, HTTP headers, or XML sitemaps depending on site scale and setup. - Use Case: A site with English, French, and German versions has pages indexed in the wrong regions. Run an audit to find that the French pages lack return tags and en-uk is used instead of en-GB, then receive corrected tags ready to deploy. ## Quick Start Audit the hreflang implementation on https://example.com and generate corrected tags for all language versions.

Frequently Asked Questions about seo-hreflang

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate hreflang tags on my website?

Provide a URL and the audit checks self-referencing tags, bidirectional return tags between all language versions, x-default fallback, and language/region code validity. Results are reported in a table showing pass or fail status per language variant with severity ratings.

What are the most common hreflang mistakes?

The most critical errors are missing self-referencing tags and missing return tags, which cause Google to ignore the entire hreflang set. Other frequent issues include invalid codes like `eng` instead of `en` or `en-uk` instead of `en-GB`, and hreflang placed on non-canonical URLs.

Should I use HTML tags, HTTP headers, or XML sitemaps for hreflang?

HTML link tags suit small sites with fewer than 50 variants, HTTP headers work for non-HTML files like PDFs, and XML sitemaps are recommended for large sites or cross-domain setups. Sitemaps centralize management and avoid bloating the page head.

Does hreflang work across different domains?

Yes, hreflang supports cross-domain setups such as example.com and example.de. Both domains must include return tags referencing each other, both should be verified in Google Search Console, and sitemap-based implementation is recommended.

Why is my hreflang being ignored by Google?

Google ignores hreflang sets with missing return tags, missing self-referencing tags, or tags placed on non-canonical URLs. Mixed HTTP/HTTPS URLs and trailing slash mismatches between hreflang and canonical URLs also cause validation failures.