Hreflang Validator Reciprocal

Reciprocal hreflang validator

Validates hreflang setup on multilingual sites by building a directed graph of every language tag and catching the issues Google silently rejects: missing reciprocal links, missing x-default fallback, broken ISO/BCP 47 codes, missing self-references, and cross-language canonical conflicts. It parses sitemap blocks, HTML head tags, and crawl exports so the right user sees the right language version.

$15 one-time
Add to a kit →

Prices include 20% VAT. · Forged on real agency work · one-time, no lock-in

  • Type Skill
  • Category Search & AEO
  • Delivery Email · instant
  • License One-time
Run preview
forgehouse, hreflang-validator-reciprocal

Inside the run · no black box

See the actual work before you buy it.

One missing return link and Google quietly discards your entire language cluster. The validator graphs every hreflang edge, hunts non-reciprocal pairs, and checks each code against the format Google actually accepts.

  1. Parses the sitemap's hreflang blocks (with an XXE-safe XML parser) or the HTML head tags into a directed graph, where every hreflang annotation is an edge from one URL to another.
  2. Hunts missing reciprocals: page A points at B but B never points back. It is the single most common error and the one that makes Google discard the entire language cluster.
  3. Validates that every cluster has an x-default fallback and that every page self-references its own URL, both hard requirements Google checks.
  4. Verifies each language code against BCP 47 format: tr-TR with a hyphen passes, while tr_TR with an underscore, a bare country code or wrong casing gets silently ignored by Google.
  5. Catches canonical conflicts, because a page whose canonical points at another language version drops out of the index entirely and takes its hreflang signals with it.
  6. Cross-reads Search Console country-impression data for anomalies (a Turkish page earning most of its impressions from the US means the setup is wrong) and outputs the prioritized fix list.
Use cases · what happens when you plug it in

One power source. 6 lines out.

hreflang-validator-reciprocal · core

core active · 6 lines

  1. Technical SEO audit of a multilingual site (Next.js i18n, WordPress WPML, Webflow)

    ✓ technical seo audit of a
  2. Hreflang regression check after a relaunch or URL migration

    ✓ hreflang regression check
  3. Investigating a Search Console International Targeting warning

    ✓ investigating a search c…
  4. Deciding between sitemap hreflang blocks and HTML head tags at scale

    ✓ deciding between sitemap
  5. Finding reciprocal gaps where A points to B but B never points back

    ✓ finding reciprocal gaps
  6. Cleaning up unnecessary hreflang tags on a single-language site

    ✓ cleaning up unnecessary
Benefits · what you walk away with

Yours to keep.

Drag time forward. Watch what stays.

Forever

That's what owning means.

The rented stack

ai writing tool: subscription

expired · access lost

analytics suite: subscription

expired · access lost

design platform: subscription

expired · access lost

(nothing left)

Your forge

  1. Stop Google from ignoring an entire language cluster because one reciprocal link is missing

    license: perpetual
  2. Keep mismatched-locale users from landing on the wrong language version via x-default

    license: perpetual
  3. Catch the catastrophic cross-language canonical that drops pages from the index

    license: perpetual
  4. Recover lost international organic traffic by fixing tags Google was silently discarding

    license: perpetual

subscriptions expire · deeds don't

What's included · the full manifest

Everything in the box.

Pick a piece up. Watch it work.

Reciprocal graph validator that lists every A-to-B edge missing its B-to-A return

part 01 of 06 · in the box

6 parts · one working system · ships instantly by email

From the field · a real case

This wasn’t written at a desk.

The problem

The fix

The result

Who it's for

This wasn't forged for everyone.

  • Not for you if you'd rather rent a tool than own one.
  • Not for you if you want someone else to run your stack.
  • Not for you if you're happy guessing.
Still here? Good.

SEO specialists and developers running multilingual sites who need hreflang verified correctly so international pages rank and route to the right audience.

then this was forged for you.

Works with

Universal by design: these run in any AI. Delivered in the open Agent Skills + MCP format (native in Claude); ChatGPT, Gemini, Cursor and Copilot adapt the same files their own way.

  • Claude Native format
  • ChatGPT Adapts via open standards
  • Gemini Adapts via open standards
  • Cursor Adapts via open standards
  • Copilot Adapts via open standards
Questions · still in the air

Catch what's on your mind.

the air is clear. nothing between you and the forge.
catch a spark: the forge will answer

  1. Our site is WordPress with WPML, not Next.js. Can it still validate our hreflang?

    Yes. The validator is source-agnostic: it parses sitemap XML blocks, HTML head tags, and crawl exports, so it reads the tags wherever they live, whether that's Next.js i18n, WPML, or Webflow.

  2. How does it catch reciprocity gaps that Search Console never shows me?

    It builds a directed graph of every language tag and lists each A-to-B edge that has no B-to-A return. On top of that it checks x-default coverage per language cluster, validates BCP 47 code formats, and flags canonical-versus-hreflang conflicts per page.

  3. Will it fix the broken tags automatically?

    No. It's a validator: it finds the issues, produces a findings report, and gives you an integration checklist. Applying the fixes in your codebase or CMS is your step.

  4. How is it delivered?

    By email right after purchase: ready to run, downloaded instantly, no setup wait.

  5. One-time or subscription?

    A one-time purchase; no subscription or hidden fees. VAT (20%) is included.

  6. Can I get a refund?

    As a digital product, it can’t be refunded once downloaded. That’s why we show exactly what’s inside and who it’s for, right here.