How We Determine a Browser Locale
Last modified: October 22, 2024
Overview
cPanel & WHM provides localized login page that allows users to select a locale for their session. Several factors determine the locale that you see when you log in to cPanel, WHM, or Webmail.
cpsrvd service checks
When you log in to the cPanel, WHM, or Webmail interface, the cpsrvd
service uses the following process to determine which locale to display:
- The
cpsrvd
service checks whether a locale query string parameter exists in the URL. If it does, the browser sets thesession_locale
cookie to the same value.- For example, the
https://example.com:2083/login?locale=ru
URL sets the Russian locale in the cPanel interface. - The
session_locale
cookie overrides the account’s configured locale and is valid for one year.
- For example, the
- The
cpsrvd
service checks whether your browser already contains thesession_locale
cookie. If it does, the login interface and the rest of the user’s session uses the specified locale. - If the URL does not specify a locale query string and the browser does not have a
session_locale
cookie, thecpsrvd
service checks whether your browser sent anAccept-Language
header. If it did, thecpsrvd
service uses the first valid locale that corresponds to the value of theAccept-Language
header.Note:Some browsers don’t allow the
Accept-Language
header. - If none of the above steps were able to set a language, the login system uses the Server Locale setting’s value in WHM’s Tweak Settings interface (WHM » Home » Server Configuration » Tweak Settings).
- cPanel & WHM stores this setting in the
/var/cpanel/cpanel.config
file as theserver_locale
variable. - You can customize the language that the system uses to display a customer’s preferred locale in WHM’s Configure Application Locales interface (WHM » Home » Locales » Configure Application Locales).
- cPanel & WHM stores this setting in the
- If your system does not meet any of the above conditions, the login system uses the U.S. English locale (
en
) by default.