Check explainer · v1

Hreflang across sites: missing return links

Automated

Last reviewed

Hreflang reciprocity is a two-site promise. When the partner in your cluster never links back, the crawl can see the gap but cannot fix the promise — it reports it for review.

How this check works

For hreflang pairs inside the crawl, the check looks for the return link on the counterpart page. A missing return link is reported as pending review rather than a failure: the counterpart may be another property or another company’s site, and only a human can confirm whose side is broken and which side to change.

What does a failure look like?

A multi-market site that ships hreflang to its regional domains while the regional sites never shipped the return set; partner-marketplace clusters where only one side maintained the tags — the crawl names the counterpart so the conversation starts from evidence.

How to fix it, step by step

  1. Confirm ownership of the counterpart: if it is yours, add the return link there.
  2. If a partner owns it, hand them the exact URL pair and the missing tag to implement.
  3. Re-run the crawl after both sides are updated and confirm the item clears.

What does a pass or fail look like?

Good

Every in-crawl hreflang pair carries both directions of the link.

Fail

A de-DE page lists an en-GB counterpart; the counterpart never lists back — reported for review with both URLs named.

Frequently asked questions

Why is a missing return link not a failure?

Because the counterpart’s page is outside this site’s control in the common case. The crawl can prove the gap exists but not which side must change or whether the partner intends the cluster at all — so it defers to a human instead of failing on an assumption.

What is hreflang reciprocity?

The requirement that every page in a language cluster links to every other page in it — A names B, and B names A. One-directional tags are ignored for the stand-in direction, which is exactly what the missing return link costs.

How is this different from the hreflang validator?

The single-URL validator checks one page’s hreflang set for validity and self-reference. This crawl rule measures the matrix between pages, where the missing half of a pair is only visible site-wide.

This rule is one of the checks the audit runs. Run the full site audit

Free preview; no account needed.

Visdenda check explainers · one page per published ruleHreflang return links · v1