What it Checks
A locale-adaptive page serves different content at the same URL depending on the visitor's language or country. Googlebot mostly crawls from the US without an Accept-Language header, so it may only ever see one version.
The tool first makes a default request: no Accept-Language, from this server. It then requests the URL once per language you chose, and, when proxies are configured, once per country and per country and language combination. Each response is compared with the default one on six points: the status, the final URL after redirects, the html lang, the Content-Language header, the title and the visible text. Any difference makes the page locale-adaptive.
Text is compared by similarity, not exactly: the share of three-word sequences both versions have. Below 90% the content counts as different, so a date, a counter or a rotating banner doesn't make a page locale-adaptive on its own.
It also reports whether the server sends Vary: Accept-Language, and each response's Content-Language header and number of hreflang annotations.
Run a Test
- Paste the URL.
- Pick the languages.
en-US,fr,de,esandjaare selected by default. - Pick the user agent (a browser by default) and, if the server has proxies, countries.
- Press Test. The verdict reads Locale-adaptive. or Not locale-adaptive.
Options
- User agent. Chrome on Windows by default, as a visitor would arrive. Choose Googlebot to see what Google's crawler gets: some sites only adapt for browsers, and some refuse requests that claim to be Googlebot from another network.
- Languages. Up to 15 language codes. Each is sent as
Accept-Language: fr-CA,fr;q=0.9(the code, then its base language). - Countries. Up to 10, only those with a proxy configured on the server in
LOCALE_PROXIES. Without proxies the field reads Server location only and every request comes from this server; the language tests still work.
A test makes at most 60 requests: the default, plus each language, plus each country with and without each language.
Reading the Result
- Variations: the number of requests besides the default, and how many languages and countries they covered.
- Different: how many variations got another status, redirect, language, title or text than the default.
- User agent: the one the requests were sent as. When the default request answers 202 or an error status (a bot check or a refusal), the verdict says so: every variation may then be the same block page.
- Vary header: whether any response declares
Vary: Accept-Language. - Responses: one row per request, marked default, same, different (with what differs) or failed, with the share of text it has in common with the default, the status, final URL,
html langand title. Expand a row for its redirects,Content-Language,Vary, word count, hreflang count and, when the text differs, a sample of the words only in this version and only in the default one.
Good to Know
- Short pages change their similarity quickly: on a page of 40 words, one changed line can drop it under 90%. Check the word samples before concluding.
- Pages are read as HTML, without running JavaScript. Content switched by scripts in the browser is not seen.
- Linking language versions: the hreflang guide.
API
POST /api/locale-adaptive
Send the URL, the languages and the countries as arrays of codes, and optionally the user-agent id (chrome-windows by default, googlebot-smartphone for Google's crawler). A country without a configured proxy is refused with an error, and so is a test with no language and no country.
curl -X POST https://plumb.reacthive.dev/api/locale-adaptive \
-H "content-type: application/json" \
-d '{
"url": "https://www.example.com/",
"languages": ["en-US", "fr"],
"countries": [],
"agent": "chrome-windows"
}'{
"url": "https://www.example.com/",
"agent": "Chrome (Windows Desktop)",
"rows": [
{
"language": "",
"country": "",
"status": 200,
"finalUrl": "https://www.example.com/",
"redirects": [],
"contentLanguage": "",
"vary": "Accept-Encoding",
"htmlLang": "en",
"title": "Example",
"textHash": "3f2a91c0d4",
"words": 812,
"hreflang": 0,
"similarity": null,
"differences": [],
"added": [],
"removed": [],
"error": null
},
{
"language": "fr",
"country": "",
"status": 200,
"finalUrl": "https://www.example.com/fr/",
"redirects": ["302 → https://www.example.com/fr/"],
"contentLanguage": "fr",
"vary": "Accept-Encoding",
"htmlLang": "fr",
"title": "Exemple",
"textHash": "b81e07a6f2",
"words": 905,
"hreflang": 0,
"similarity": 0.08,
"differences": ["redirect", "html lang", "Content-Language", "title", "content"],
"added": ["Bienvenue", "Découvrez"],
"removed": ["Welcome", "Discover"],
"error": null
}
],
"adaptive": true,
"adaptiveCount": 1,
"failed": 0,
"baseFailed": false,
"varyLanguage": false
}