Skip to content
goflag
Documentation
Rule catalogue

hreflang.cluster-incomplete

Every locale the sitemap publishes must appear in the route's hreflang cluster

warningsite-widevendor-spec

Why it matters

Listing a URL in your sitemap is you saying that version exists and should be indexed. Leaving it out of the hreflang cluster then puts it outside the group it belongs to, so it competes with its own translations instead of consolidating with them — which is the one thing hreflang exists to prevent. Google requires every version to list every other, and the sitemap is your own evidence that the missing one is real.

What the finding looks like

The message goflag prints, with example values substituted.

warn hreflang.cluster-incomplete Route /pricing: the sitemap lists es, pt-br but the <head> does not advertise them. The site publishes those versions and leaves them outside the cluster, so they compete with this page instead of consolidating with it.

How to fix it

The catalogue carries no snippet for a site rule: a cross-page rule builds its remedy from what the crawl found, so goflag attaches the fix to the finding itself rather than to the rule. Run it and read the finding.

Says who?

This rule is vendor-spec, and it cites the document below. Nothing here is goflag’s opinion of what a good page looks like — if you disagree with a finding, this is what you are disagreeing with.