Skip to content

content(hreflang): warn against dropping x-default in multi-locale setups#11

Merged
jdevalk merged 1 commit into
jdevalk:mainfrom
apermo:docs/hreflang-x-default-mistake
May 31, 2026
Merged

content(hreflang): warn against dropping x-default in multi-locale setups#11
jdevalk merged 1 commit into
jdevalk:mainfrom
apermo:docs/hreflang-x-default-mistake

Conversation

@apermo
Copy link
Copy Markdown
Contributor

@apermo apermo commented May 31, 2026

Adds one bullet to the Common mistakes section of the hreflang page.

x-default is the fallback search engines use when no hreflang matches the visitor's locale.
A pattern seen in the wild is emitting it only when a single alternate exists and dropping it
once two or more locales are present — backwards, since the multi-locale case is exactly where a
fallback is needed. The new bullet warns against that.

Platform-agnostic (no implementation named), British English, and updated bumped per the
contribution rules.

Add a common-mistake bullet: some setups emit x-default only when a
single alternate exists, which is backwards. x-default is the fallback
for the multi-locale case.
@jdevalk jdevalk merged commit 6aa975c into jdevalk:main May 31, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants