Contentful: What determines which languages are available during project submission?

Introduction

When you run the XTM Connect – Contentful plugin, to submit content for translation in XTM Cloud, you can make other configuration settings for your XTM Cloud project. You do so in the Add content panel, on the left-hand side. Apart from selecting an XTM customer or an XTM Template, you can also select a source and target language combination.


General rule

It is important to know that the source and target languages listed and available in these dropdowns do not depend on which languages have been selected in a specific XTM project template but on which customized languages have been configured in Contentful, for a particular environment (Settings → Environment settingsLocales).

IMPORTANT!

Take note of the Default label: this is always assigned to one language only. The default language is the language in which the source content is created, in Contentful. For this reason, when creating a locale, ensure that the Allow empty fields for this locale checkbox is deselected so that the source content is always there. 

On the other hand, as you might have already noticed, all the target languages "can be published empty". This is because you do not need any content in the target language fields at the start, since the translation is yet to come from XTM Cloud. For this reason, ensure that you have selected the Allow empty fields for this locale checkbox for target locales.

XTM Connect – Contentful takes whatever languages have been configured for a particular environment in Contentful and completely ignores the languages selected in an XTM Cloud project template.

For example, if a selected environment has the following languages:

  • English (United Kingdom), Polish and German (Germany),

and a selected project template has:

  • Source: English (United States) and

  • Target: Polish, Spanish (Spain),

the only languages available in the XTM Connect – Contentful plugin will be English (United Kingdom), Polish and German (Germany). All of them can be selected either as source or target languages.

NOTE!

Contentful languages do not have to be mapped with their XTM Cloud counterparts – they have their own language codes (for instance: ca, pl-PL). However, during content submission to XTM Cloud, XTM Connect – Contentful replaces the Contentful languages codes with XTM Cloud language codes on the fly, according to corresponding XTM Cloud language.

NOTE!

Contentful languages do not have to be mapped with their XTM Cloud counterparts – they have their own language codes (for instance: ca, pl-PL). However, during content submission to XTM Cloud, XTM Connect – Contentful replaces the Contentful languages codes with XTM Cloud language codes on the fly, according to corresponding XTM Cloud language.