Organizations often need to localize applications for regional language variations that are not available out of the box. Constellation allows you to extend the list of supported languages exposed through the Localization Wizard by overriding the language list data transform in your application layer.
This article explains how to add a custom language dialect so that it appears as a selectable language in the Constellation Localization Wizard.
Overview
The Localization Wizard retrieves its list of available languages from the following data transform:
Embed-Language.pyLanguageList
To add a custom language or dialect, specialize this data transform in your implementation layer and append a new entry to the existing language list.
Once the change is saved, the new language becomes available in the Localization Wizard without requiring any additional configuration.
Step 1: Specialize the Language List Data Transform
Locate the following rule:
Embed-Language.pyLanguageList
Create a specialized version of this data transform in your application layer.
This ensures your customization is isolated from the base application and remains upgrade-friendly.
Screenshot 1: Specializing
Embed-Language.pyLanguageList
Step 2: Append a New Language Entry
Within the specialized data transform, append a new page to the existing results list:
.pxResults()
Populate the following properties:
| Property | Description |
|---|---|
pyLanguage |
Language code or locale identifier |
pyDescription |
Display name shown in the Localization Wizard |
Example:
.pxResults().pyLanguage = sv-FI
.pxResults().pyDescription = Swedish (Finland)
This adds a new language option that will be displayed in the Localization Wizard.
Screenshot 2: Appending a new language entry in the data transform
Step 3: Save and Check In the Rule
Save and check in the specialized data transform.
No additional rule configuration is required.
Step 4: Open the Localization Wizard
Navigate to the Localization Wizard in App Studio.
When the wizard loads, it executes Embed-Language.pyLanguageList and displays all entries returned in .pxResults.
Your newly added language should now appear alongside the out-of-the-box languages.
Screenshot 3: Localization Wizard before the change
Screenshot 4: Localization Wizard after the change showing the newly added language
Validation
To verify the configuration:
- Open the Localization Wizard.
- Create a new localization package.
- Open the language selection dropdown.
- Confirm that the newly added language is available.
- Select the language and proceed with localization.
If the language appears in the dropdown, the configuration was successful.
Important Notes
Locale Format Requirements
The value specified in pyLanguage must follow the standard locale format:
language-region
Examples:
- en-GB
- en-AU
- fr-CA
- sv-FI
- pt-BR
Dialect Support Limitation
Pega supports a language code with a maximum of one regional dialect qualifier.
Supported:
sv-FI
en-GB
fr-CA
pt-BR
Not Supported:
sv-FI-CUSTOM
en-US-TX
fr-CA-QUEBEC
In other words, a locale can contain:
[LangCode] -[Region]
but should not contain additional dialect segments beyond the region code.
Using unsupported locale formats may prevent the language from being recognized correctly by the Localization Wizard and other localization components.
Summary
Adding a custom language dialect to the Constellation Localization Wizard is a straightforward customization:
- Specialize
Embed-Language.pyLanguageList. - Append a new page to
.pxResults(<APPEND>). - Provide
pyLanguageandpyDescription. - Save the rule.
- Verify that the language appears in the Localization Wizard.
This approach provides a simple and upgrade-friendly mechanism for supporting additional regional language variants in Constellation applications.