Create a language choice for users

  • Release version: Zurich
  • Updated July 31, 2025
  • 1 minute to read
  • Allow users to select the language as a valid option in the language picker or a user record.

    Before you begin

    Role required: admin

    About this task

    You must create a choice record for a new translation in the Choice [sys_choice] table. For more information about this table, see Choice table.

    Procedure

    1. Navigate to All > System Localization > Choices.
    2. Select New.
    3. Enter the following fields.
      Table 1. Choice record fields to select the new language
      Field What to enter
      Table sys_user
      Element preferred_language
      Language Enter an identifier that complies with BCP 47. The identifier can contain a language code or language code followed by a country or region code. For example, tr for Turkish or es-MX for Spanish Mexico.
      Label Enter the name of the new language selection as you want it to appear in the language picker. For example, Mongolian.
      Value Enter an identifier that complies with BCP 47. The identifier can contain a language code or language code followed by a country or region code. For example, tr for Turkish or es-MX for Spanish Mexico.
      Sequence Enter a number to determine what order the option appears in the choice list if you do not want to list choices alphabetically. For example, 5.
      The following record allows a user who is using the Dutch localization of their instance to change languages to Mongolian:
      • Table: User [sys_user]
      • Element: preferred_language
      • Language: nl
      • Label: Mongoolse
      • Value: mn
    4. Select Submit.