generating-hreflanglisted

# Generating & Configuring Hreflang ## Overview Hreflang tells search engines which language and regional version of a page to serve based on the searcher's locale. In multilingual setups, misconfigured hreflang tags cause duplicate content cannibalization, wrong-region SERP rankings, and lost international traffic. Google's hreflang parser is strict and unforgiving: **if alternate links are not bidirectional (reciprocal), Google completely ignores them** [1]. Furthermore, modern AI search engines (ChatGPT, Perplexity, Claude) inspect locale-specific canonicals and alternates to attribute region-specific citations. The job: map alternate URLs, enforce reciprocal linkage and `x-default`, validate language/region codes against ISO standards, and generate clean HTML tags, XML sitemap blocks, or framework metadata. --- ## The Four Non-Negotiable Hreflang Laws 1. **Bidirectional Reciprocity is Mandatory:** - If Page A (`https://example.com/en`) specifies Page B (`https://example.com/es`) as its Spanish alternate, Page B **must** specify Page A as its English alternate. - If reciprocity is broken anywhere in the chain, Google discards the tags for both pages [1]. 2. **Self-Referential Links are Required:** - Every page's alternate set must include an alternate link pointing to itself with its own language tag. 3. **`x-default` Fallback Must Be Defined:** - Always include an `x-default` tag pointing to a generic global landing page, language selector, or default l