Skip navigation

Adding languages

Every project has a single default language. After a project manager adds a language in the project settings, content contributors will have the ability to translate content items into the new language.

See how to add languages inside the appOpens in a new window.

Table of contents

    Adding a language

    To add a new language to your project:

    1. From the app menu, choose Project settings .
    2. Under Project settings, choose Localization.
    3. Type a name for the language into the Language name field. For example: French (France).
    4. Set a unique codename for the language. For example: fr-FR.
    5. Click Save.

    You can now create content items in the French (France) language variant.

    A screenshot of adding a language inside the app.

    Use the same process to add other languages.

    Tip: You can reorder your languages by dragging and dropping them.

    Language codenames

    After you first add a language, the language name is used as its codename, with spaces replaced by underscores. Using the example above, the codename would be French_-_FranceWe recommend that you use short and easily identifiable codenames for your languages, such as en-US  or fr-FR.

    Language fallbacks

    For each language, you can set a fallback language. A fallback language is used when retrieving content via the Delivery API from your project.

    You can use language fallbacks to set up fallbacks among regional variants of a language, for example, en-US (American English) and en-GB (British English).

    Learn more about the logic behind language fallbacks.

    What's next?

    Now that you have defined a new language for your project: