How does auto locale work

The Auto Locale feature redirects visitors to the most suitable language version of your website based on their browser’s language preferences.

To enable Auto Locale, go to your site settings, find the Auto Locale section, and toggle it on.

When Auto Locale works

Auto Locale only works on the domain designated as the canonical URL for your website. If you have a custom domain, the feature will function only on that domain.

Similarly, if you’ve set a custom canonical URL using a reverse proxy, Auto Locale will only work when visitors access that URL.

How Auto Locale determines the locale

Auto Locale does not use geolocation. Instead, it relies on the browser’s language settings:

  • Redirects only from the default locale: If a visitor lands on your site’s default locale, Auto Locale checks their browser’s preferred languages and redirects them to a matching locale if available. Visitors who arrive directly at a non-default locale (e.g., mysite.com/fr) are not redirected.

  • Checks preferred languages in order: Auto Locale follows the browser’s language preferences in priority order, starting with the most preferred language.

  • Looks for an exact match: If the browser’s top preference is es-MX, Auto Locale redirects to the es-MX locale if available.

  • Falls back to a general language match: If no regional match exists, Auto Locale redirects to a general language variant (e.g., es-ES or just es).

Still experiencing the issue after following the steps above? Create a support ticket in the Community.