seo-hreflang

Validate hreflang configurations across HTML, HTTP headers, and XML sitemaps.

Updated Jun 6, 2026
One-click install
npx skills add https://github.com/dereknguyen269/Codex-SEO --skill seo-hreflang-dereknguyen269
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: seo-hreflang
Source: https://github.com/dereknguyen269/Codex-SEO/tree/main/skills/seo-hreflang
Command: npx skills add https://github.com/dereknguyen269/Codex-SEO --skill seo-hreflang-dereknguyen269

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

hreflang and international SEO audit, validation, and generation. Detects common mistakes, validates language/region codes, and generates correct hreflang implementations. Use when user says "hreflang", "i18n SEO", "international SEO", "multi-language", "multi-region", or "language tags".

Core Features & Use Cases

  • Detects language and region variants across pages
  • Validates ISO language (ISO 639-1) and region (ISO 3166-1) codes
  • Generates HTML link tags, HTTP headers, or XML sitemap entries
  • Verifies self-referencing and return tags, and ensures a single x-default per set
  • Provides a structured validation report and implementation plan

Quick Start

Provide the site URL (or local directory) to audit its hreflang coverage and generate correct tags for all locales.

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 for international SEO errors?

Validate hreflang tags by checking self-referencing tags, bidirectional return tags, and x-default configurations across HTML, HTTP headers, and XML sitemaps to prevent multi-language indexing errors.

What is the correct format for hreflang language and region codes?

Hreflang language and region codes must follow ISO 639-1 for language and ISO 3166-1 for region rules, ensuring protocol consistency and canonical URL alignment across multi-region sites.

How do I generate hreflang annotations for XML sitemaps and HTML?

Generate hreflang annotations by creating HTML link tags, HTTP headers, or XML sitemap entries that enforce cross-domain correctness and ensure a single x-default per locale set.

Why are my hreflang return tags causing indexing issues?

Hreflang indexing issues occur when bidirectional return tags are missing, canonical URLs are misaligned, or protocol consistency fails across multi-language site implementations.

Does hreflang validation work for cross-domain multi-language sites?

Hreflang validation works for cross-domain multi-language sites by verifying protocol consistency, canonical URL alignment, and bidirectional return tags across HTML, HTTP header, and XML sitemap implementations.