seo-hreflang

Audit and validate hreflang implementations across HTML, HTTP headers, and XML sitemaps.

Updated Mar 20, 2026
One-click install
npx skills add https://github.com/bolun-ben-ship/RightClickAI-seo-workspace --skill seo-hreflang-bolun-ben-ship
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: seo-hreflang
Source: https://github.com/bolun-ben-ship/RightClickAI-seo-workspace/tree/main/seo-workflow/seo-hreflang
Command: npx skills add https://github.com/bolun-ben-ship/RightClickAI-seo-workspace --skill seo-hreflang-bolun-ben-ship

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Hreflang and international SEO can be error-prone and hard to audit across multiple languages and regions. Incorrect hreflang tags can reduce visibility and create poor user experiences across locales.

Core Features & Use Cases

  • Validate self-referencing hreflang tags and ensure the self URL matches the canonical URL.
  • Ensure bidirectional return tags across all language variants (A↔B).
  • Enforce a single x-default and proper ISO language (ISO 639-1) and region (ISO 3166-1) codes.
  • Generate hreflang implementations for HTML link tags, HTTP headers, or XML sitemaps.
  • Support cross-domain hreflang setups with consistent protocols and canonical alignment.

Quick Start

Audit your site's hreflang setup and generate correct hreflang tags for HTML, HTTP headers, or sitemaps.

Frequently Asked Questions about seo-hreflang

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

FAQPage Schema
How do I audit hreflang tags across multiple domains for international SEO?

To audit hreflang tags for international SEO, validate self-referencing tags, bidirectional return links, a single x-default, and ISO language codes across HTML, HTTP headers, and XML sitemaps. This ensures proper regional targeting across cross-domain setups.

Why does my hreflang implementation fail validation when using cross-domain setups?

Hreflang validation often fails in cross-domain setups due to protocol inconsistencies, missing bidirectional return tags, or canonical URL misalignment. Enforcing matching protocols and ensuring A↔B return links resolves these international SEO targeting errors.

Does hreflang validation work for XML sitemaps and HTTP headers?

Yes, hreflang validation works across HTML link tags, HTTP headers, and XML sitemap-based deployments. It checks self-referencing URLs, x-default enforcement, and proper ISO 639-1 language and ISO 3166-1 region codes regardless of the implementation method.

What is the best way to generate correct hreflang tags for multilingual sites?

The best way to generate hreflang tags for multilingual sites is to enforce self-referencing URLs matching canonical tags, bidirectional return links, and a single x-default. This prevents regional targeting errors across HTML, HTTP headers, or sitemaps.

Do I need a self-referencing hreflang tag if my canonical URL is already set?

Yes, a self-referencing hreflang tag is required even with a canonical URL set. The self URL must match the canonical URL exactly to ensure proper bidirectional return tag validation and avoid international SEO visibility issues.

When do I need to use x-default in my hreflang implementation?

You need a single x-default in your hreflang implementation to specify a default page for unmatched language or region users. Enforcing exactly one x-default alongside proper ISO codes ensures correct multilingual site routing and regional targeting.