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 app.

Table of contents

    Adding a language

    To add a new language to your project:

    1. From the app menu, choose Project settings {@icon-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.

    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_-_France~}We 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).

    If you want to know more about the logic behind language fallbacks, learn the details in our Developer Hub.

    What's next?

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