Palash_Sarkar
ServiceNow Employee

Overview

 
It has been confirmed that, following an upgrade to the Yokohama or Australia release, the guest user’s language preference no longer takes precedence when determining the UI language displayed on the login page. This behavioral change results from newly introduced logic for handling the session language.
 
Unauthenticated-user-login-page-ui-language.png

 

A common ServiceNow Internationalization (i18n) question is how to control the language shown on the login page — the screen an unauthenticated user sees before signing in. The correct, supported way to do this is to set the System Default Language through the glide.sys.language property.

This behavior is by design: the guest user's language should NOT be changed. Setting the language on the guest account is a hack/workaround and should be avoided. Because the login page — and every user without a user role — inherits the system default, the glide.sys.language property is the single correct control point. Customers should be made aware that manipulating the guest account to force a login-page language is not a supported approach.

In a Customer Portal, administrators can provide a language selector on the pre-login page through customization. By default, unauthenticated users see the portal UI in the system default language. If users need to select a different language before authentication, administrators can implement a custom language selector. 

Need to add a Language Selector for your portal (including external and non-authenticated users?) - ...

 

When an unauthenticated user selects a language, the preference is stored in a browser cookie and applied to subsequent visits to the login page. Cookie-based locale handling for unauthenticated sessions was enhanced in the Tokyo release.

 

The Recommended Best Practice 

This article demonstrates the correct approach with a concrete use case: making the login screen display in Japanese.

Use Case Scenario

Goal: All unauthenticated users hitting the login page should see it in Japanese, regardless of browser settings.

Guest user's current preferred_language: English (the out-of-box default)

Target result: Login page renders in Japanese, consistently and predictably — without altering the guest account.

 

Step 1: Set the System Default Language Property

Property: glide.sys.language
Value: ja

Screenshot 0008-07-03 at 18.56.17.png

Navigate to System Properties and set this value. This is the ultimate fallback used across all release versions — it should always be configured explicitly to your target language.

 

Step 2: Leave Guest User's Preferred Language System (日本語)

Table: sys_user
User: guest
Field: Preferred Language
Value: (blank)

Screenshot 0008-07-03 at 18.59.46.png

Navigate to User Administration → Users → guest, open the record, and select the Language field System (日本語)which is blank appear in the list view.

Why the guest user must stay blank: - Changing the guest user's language is an unsupported hack. The by-design mechanism for the login-page language is glide.sys.language. - Out of the box, the guest user's preferred_language shows English; forcing another code here is exactly the workaround to avoid. - Left blank, the guest user falls back to glide.sys.language, so the login page always follows your system default — one setting to maintain, and it stays correct even if the system default changes later.

 

Step 3: Delete Conflicting sys_user_preference Records

Table: sys_user_preference
Condition: name = 'user.language' AND user IS NULL
Action: Delete all matching records

Screenshot 0008-07-03 at 19.21.18.png

In the Navigator enter sys_user_preference.listOpen User Preferences table and filter on Name = user.language and User is empty, and delete any records found.

Why: This system-wide preference can override the guest user's setting on some releases, and is a frequent source of unpredictable login-language behavior after upgrades. Removing it leaves only two clear control points: the guest user record and the system property.

 

Result: No guest-account hack → the login page resolves to glide.sys.language (ja) → it renders in Japanese for every unauthenticated visitor, on every release.


Why This Is the Best Practice

  • Supported and by design: glide.sys.language is the intended control for the login-page language. No workarounds on the guest account.
  • Simple resolution path: system default → login page. No competing preference records or hacked accounts to reason about.
  • Release-independent: Works the same on Yokohama, Australia, and later, without depending on cookie logic or preference precedence.
  • Easy to maintain: One property is your single source of truth for the unauthenticated experience.

Troubleshooting: Login Page Still Not in Japanese

  1. Check guest user record — confirm preferred_language is blank, not "English."
  2. Check glide.sys.language — confirm value is ja.
  3. Check for leftover preference records — filter sys_user_preference for name='user.language', user is empty; delete any found.
  4. Clear cache and retest — go to the Navigation filter (top-left search bar), enter cache.do, and press Enter. Then retest in an incognito window.
  5. Confirm the Japanese language pack is installed and active under System Definition → Languages.
Version history
Last update:
Thursday
Updated by: