Add an x-default hreflang entry

x-default marks the page served when no language or region matches, usually a selector or the global version. Add it to the hreflang set, ensure it returns 200 and is indexable, and never point it at a geolocation redirect. Validate reciprocity with the rest of the set.

mediumIn codeimpact effort

Why this matters

Point unmatched users at a real, indexable fallback.

Get the full breakdown

The extended brief explains when this works, when it does not, and the trade-offs. Join the waitlist and it unlocks for every tip when sign-in opens; MCP access is the paid part.

Join the waitlist

Before you start

  • An existing hreflang set
  • A language selector or global page

How to apply it

  1. Choose the fallback page

    Pick a page that serves unmatched users: a language selector or the global version. Confirm it returns 200 and is indexable.

    Check: The chosen x-default URL returns 200 and does not carry noindex.

  2. Add the annotation everywhere

    Add hreflang=x-default to every variant's set, and include the x-default page in its own set. Keep absolute URLs.

    Check: Every variant's annotation set contains exactly one x-default entry with the same target.

  3. Validate reciprocity

    Run a reciprocity check across the full set and confirm the x-default target links back to all variants.

    Check: Validation reports zero missing return links for the x-default target.

Get the prompt for your agent

A ready-to-paste prompt for your agent that implements this tip and verifies the result in your repo.

Join the waitlist

Source: seo-mcp playbook · curated entry · report an error

Framework notes

nextjs-app

Add `'x-default'` to the `alternates.languages` map, pointing at the selector or global route.

wordpress

Multilingual plugins usually add x-default when configured; verify the generated head rather than adding a manual tag that could duplicate.

Official references

Let your agent apply this + 161 more tips.

Pre-order — $19