Administration Guide

Preparing a Localization Dictionary

To prepare a localization dictionary for another language, use one of existing Self Service Portal localization dictionaries as a template. Localization dictionaries are stored in the Alloy Navigator installation folder, typically at the following path:

C:\Program Files\Alloy Software\Alloy Navigator 2022\

If you have an existing Self Service Portal instance, you can also find localization dictionaries in the localization folder under the folder where your SSP files are stored:


NOTE: For instruction on viewing the physical path of Self Service Portal installation folder, see Physical Path to Self Service Portal Files.

The localization dictionary is a JSON file which include local attributes and localization dictionary entries.


Local attributes are the values of the Formats key which is structured as follows:

  "Formats": {
    "Id": "es-ES",
    "Description": "Spanish - Spain, International Sort",
    "NumberGroupSeparator": ".",
    "NumberDecimalSeparator": ",",
    "NumberGroupSeparatorDisplay": ".",
    "NumberDecimalSeparatorDisplay": ",",
    "ShortDatePattern": "d/m/Y",
    "ShortDatePatternDisplay": "dd/MM/yyyy",
    "ShortTimePattern": "G:i:s",
    "ShortTimePatternDisplay": "H:mm:ss",
    "DurationFormat": "%HH% h %NN% min",
    "DurationFormatLessHour": "%N% min"

The Formats key takes its values from the nested object consisting of key-vlaue pairs defining local attributes.

NOTE:The language-region pair code in the id key must be a valid Windows Language Code Identifier (LCID). You can find the list of available language codes at


Localization dictionary entries are the values of the Terms key which is structured as follows:

  "Terms": [
    "text": ""
    "text": "Agregar una nota"
    "text": "Ya existe un usuario con este nombre."

The Terms key takes its values from the nested array consisting of a number of objects. Each object defines a localization dictionary entry and structured as follows:



  • key value defines a interface element (field, message, caption, text, etc.) that you want to localize.
  • text value defines a localized version for the interface element.

For example, the object below defines the localized title of the Announcements page in the SSP:

    "text": "Anuncios"

NOTE: The keys for the fields that have the same localized version for all forms begin with "FIELDS.COMMON">.

The name of the localization dictionary file for the new language must be in the following format:


Example: tr-TR.json