Add Custom Languages in Assets
Custom languages in Assets allow teams to model languages, regional variants, or internal language definitions that fall outside supported formats. Custom languages are created globally at the Asset Management level and once added, become available across spaces and workspaces for asset localization.
To add custom languages, log in to your Contentstack account and perform the steps below:
- Open Asset Management and navigate to Settings > Languages.
- Click + New Language.
- Select Create Custom Language.
- Enter the following details:
- Language Name: A descriptive name for the custom language.
- Language Code: A unique code that identifies the language.
- Fallback Language: Select a language to source content when localized content is unavailable.
- Click Add to create the custom language.
The newly created custom language becomes available for assignment to workspaces. Refer to the Add Languages to a Workspace document to get started with asset localization.
Note
- The combination of language code and locale or country code must remain unique across Assets.
- Language codes must be between 2 and 12 characters long.
- Language codes must start with a letter and can include only letters, numbers, and hyphens (-).
- Once created, a custom language code cannot be modified.
- A fallback language ensures continuity by serving content from another language when localized content does not exist.
Best Practices
- Use clear and consistent language codes that reflect regional or business needs (e.g., en-internal or fr-ca-marketing).
- Define fallback languages thoughtfully to avoid missing or broken localized asset delivery.
- Limit custom languages to genuine use cases to keep localization management clean and scalable.