Skip to main content

XTM Connect – Contentful 1.11

Translating a single content item directly, in XTM Cloud

In XTM Connect, you can send a single content item for translation directly, in XTM Cloud, in either full screen or sidebar mode. The only difference between the two procedures is how you access XTM Connect.

To send a single content item for translation directly, in XTM Cloud, in full-screen mode:
  1. First, access XTM Connect in full screen mode.

  2. Select the Add content tab.

  3. Select the entry (content item) that you want to send to XTM Cloud for translation.

  4. At the bottom of the content items list, specify these settings, for the translation project:

    UI element

    Description

    XTM Customer dropdown list

    Select the Customer for which this translation will be performed. Customers are defined in XTM Cloud.

    XTM Template dropdown list

    Select the XTM template that is to be applied for this translation project. XTM templates are configured in XTM Cloud. All settings in XTM templates are applied in XTM Connect.

    Translation settings section

    Source language dropdown list

    Select the translation project source language.

    Target languages dropdown list

    Select the translation project target languages.

    Project name

    Enter the project name. A default project name consisting of [Prefix]_[Contentful entry name]_[optional requester email address] will initially be inserted. It will be overwritten by your entry, if you make one.

    Description

    Enter the project description.

    Continuous project section

    Active XTM projects (optional) dropdown list

    If you want to update a translation of an existing text (for example, to bring it up to date after changes to the source text), select the relevant translation project from the dropdown. This is known as "resending a translation to XTM Cloud".

    Due date (optional) date finder

    If you want to set a due date for the translation, use the date finder to do so.

    Manage references button

    Select this button to specify which of the relevant entry's references are to be translated and which are not. When you do so, the Manage references popup is displayed. In the popup:

    • select referenced entries that are to be send for translation. To do so, select the checkbox to the left of their name. By default, all references are selected for translation.

    • deselect the reference(s) that are not to be sent for translation. To do so, clear the checkbox to the left of their name.

    • if the same entry has been referenced multiple times, all subsequent occurrences are marked with the sync-solid.svg icon. Each occurrence will be selected or deselected for translation.

    • use the Clear all or Select all button at the top of the popup to select or deselect all referenced entries for the relevant item.

    • once you have selected or deselected all the relevant references, select the Save button at the bottom of the popup.

    • to stop managing references without saving changes, select the Cancel button at the bottom of the popup.

    Contentful limitations to displaying references

    If an entry has over 1,000 references, these references will not be displayed, in Contentful. This means you also cannot display them in the Manage references popup and select the relevant ones for translation. However, you can create a project for such an entry and send all its +1,000 references for translation, in XTM Cloud.

    If an entry has fewer than 1,000 references, but they are nested over 10 levels deep, references below the 10th level are only marked with the plus_brand_refreshed.svg more label, in the Manage references popup. To see them, you need to display their immediate parent entry. If you create a project for an entry with +10 levels of nesting:

    • without using the Manage references popup to select any references – all references, including the ones below the 10th level, will be sent for translation in XTM Cloud.

    • using the Manage references popup to select some references – only the references that you have actively selected will be sent for translation in XTM Cloud. If you select the 10th level of nesting, references below that level will NOT be sent for translation.

    Administrators can limit the level of nested references that will be displayed and can be selected by the Translation requesters in the Manage references popup. For details, see Administrator panel – Settings (manage references).

    Note

    You can exclude all hyperlinked entries and their references from the translation project scope for all projects created in your XTM Connect – Contentful instance. To do so, contact XTM Support and ask our team to make the necessary setting.

    To request support

    Visit our Support Portal.

    Entry grouping dropdown list

    This setting is not used for single items.

  5. At the bottom of the screen, on the right, select the Send for translation button.

    Result: a screen message confirms that you have sent the content item direct to XTM Cloud, for translation.

  6. To close the message, select the icon on the right. You return to the Add content tab screen.

To send a single content item for translation directly, in XTM Cloud, in sidebar mode:
  1. First, select the required content item (known in XTM Cloud as an "entry").

  2. Access XTM Connect in sidebar mode.

  3. Select the Add content tab.

  4. Specify these settings, for the translation project:

    UI element

    Description

    XTM Customer dropdown list

    Select the Customer for which this translation will be performed. Customers are defined in XTM Cloud.

    XTM Template dropdown list

    Select the XTM template that is to be applied for this translation project. XTM templates are configured in XTM Cloud. All settings in XTM templates are applied in XTM Connect.

    Translation settings section

    Source language dropdown list

    Select the translation project source language.

    Target languages dropdown list

    Select the translation project target languages.

    Project name:

    Enter the project name. A default project name consisting of [defined prefix]_[Contentful entry name]_[optional requester email address] will initially be inserted. It will be overwritten by your project name, if you enter one.

    Description

    Enter the project description. A default description consisting of the [URL path to the entry] + [entry name/names] will initially be inserted. It will be overwritten by your description, if you enter one.

    Continuous project section

    Active XTM projects (optional) dropdown list

    If you want to update a translation of an existing text (for example, to bring it up to date after changes to the source text), select the relevant translation project from the dropdown. This is known as "resending a translation to XTM Cloud".

    Due date (optional) date finder

    If you want to set a due date for the translation, use the date finder to do so.

    Manage references button

    Select this button to specify which of the relevant entry's references are to be translated and which are not. When you do so, the Manage references popup is displayed. In the popup:

    • select referenced entries that are to be send for translation. To do so, select the checkbox to the left of their name. By default, all references are selected for translation.

    • deselect the reference(s) that are not to be sent for translation. To do so, clear the checkbox to the left of their name.

    • if the same entry has been referenced multiple times, all subsequent occurrences are marked with the sync-solid.svg icon. Each occurrence will be selected or deselected for translation.

    • use the Clear all or Select all button at the top of the popup to select or deselect all referenced entries for the relevant item.

    • once you have selected or deselected all the relevant references, select the Save button at the bottom of the popup.

    • to stop managing references without saving changes, select the Cancel button at the bottom of the popup.

    Contentful limitations to displaying references

    If an entry has over 1,000 references, these references will not be displayed, in Contentful. This means you also cannot display them in the Manage references popup and select the relevant ones for translation. However, you can create a project for such an entry and send all its +1,000 references for translation, in XTM Cloud.

    If an entry has fewer than 1,000 references, but they are nested over 10 levels deep, references below the 10th level are only marked with the plus_brand_refreshed.svg more label, in the Manage references popup. To see them, you need to display their immediate parent entry. If you create a project for an entry with +10 levels of nesting:

    • without using the Manage references popup to select any references – all references, including the ones below the 10th level, will be sent for translation in XTM Cloud.

    • using the Manage references popup to select some references – only the references that you have actively selected will be sent for translation in XTM Cloud. If you select the 10th level of nesting, references below that level will NOT be sent for translation.

    Note

    You can exclude all hyperlinked entries and their references from the translation project scope for all projects created in your XTM Connect – Contentful instance. To do so, contact XTM Support and ask our team to make the necessary setting.

    To request support

    Visit our Support Portal.

    Submit as one source file checkbox

    This setting is not used for single items.

  5. At the bottom of the screen, on the right, select the Send for translation button.

    Result: a screen message confirms that you have sent the content item direct to XTM Cloud for translation.

  6. To close the message, select the icon on the right. You return to the Add content tab screen.