Hreflang Cluster Auditor

Review supplied hreflang pages, alternate tags and return references in editable rows.

On-device No sign-up Free to use

Audit alternates controls

?

Up to 500 pages and 5,000 links. Enter extracted page or sitemap evidence; language syntax is reviewed without guessing content language.

Processed in your browser. Your inputs stay on this device.

Showing an example. Change the fields, then use audit alternates to update it.

Result

Showing an example.

Find the absent French-to-English return in two supplied page declarations.

2 pages; 3 alternate references; 1 finding.

Loading the tool. Your result will appear here.

https://usefreetools.net/hreflang-cluster-auditor · 20 November 2026

Was this helpful?

How to use Hreflang Cluster Auditor

  1. Add page URLs in the row editor, with language | URL lines or pasted alternate link tags for each page. Use advanced JSON for declarations with nested metadata.
  2. Include each target page when its declarations are available. The tool resolves relative targets against the supplied source URL but never fetches either page.
  3. Preview self-reference, return-link and repeated-language findings. Target evidence absent means no target record was supplied; Return reference absent means the supplied target record has no link back.
  4. Download the updated cluster record if needed. Check language codes, equivalent content and actual responses separately before changing live annotations.

Example: Hreflang Cluster Auditor

Find the absent French-to-English return in two supplied page declarations.

You add
Page alternate declarations (JSON): [ { "url": "https://example.test/en", "alternates": [ { "lang": "en", "url": "/en" }, { "lang": "fr", "url": "/fr" } ] }, { "url": "https://example.test/fr", "alternates": [ { "lang": "fr", "url": "/fr" } ] } ]
You get
2 pages; 3 alternate references; 1 finding.

Options

Alternate evidence
An unentered target remains unknown. It is not assumed to contain a reciprocal link.
Language labels
The limited syntax check accepts simple language/region forms and x-default. It does not establish that a code or translation is correct.
Page alternate declarations (JSON)
Up to 500 pages and 5,000 links. Enter extracted page or sitemap evidence; language syntax is reviewed without guessing content language.

Supported inputs and limits

  • Up to 500 pages, 100 alternates per page and 5,000 references.
  • The limited syntax screen accepts two/three-letter language shapes, an optional two-letter/numeric region and x-default.
  • Script subtags such as zh-Hant are flagged for review here; a syntax finding is not a complete language-code verdict.
  • Relative references are resolved for supplied comparisons, not approved as production hreflang markup.
  • No fetching, live status, translation-equivalence or indexing test.
More details

Nested metadata can remain in advanced JSON.

Where your input is processed

This tool does not upload your inputs. See the limits for anything saved on your device.

Reciprocity is only one part of a language cluster

A return link can exist even when two pages are not equivalent translations. Compare actual content and live response behavior separately. Keep page URLs with the exported edges so the observed declarations can be checked again when a cluster changes.

Questions about Hreflang Cluster Auditor

Is x-default a language?

It is treated as a fallback label in the supplied declarations.

Does a missing return mean the live page is wrong?

The target evidence may be incomplete; check or supply its declarations.

Are language codes certified?

No. The report reviews a limited syntax subset without validating every code.

Page updated · Project managed by Tony Hines · Report a problem with Hreflang Cluster Auditor