Target generation – most common issues & troubleshooting


This article helps with troubleshooting issues involving target generation. There are three main target generation issues that can occur:

  • Target does not generate at all,

  • Target is generated, but there is an error or warning when you try to open it,

  • Target is generated, but some text is missing or its formatting is incorrect.

Issue description & Solution

Target does not generate at all: inline tags in the wrong place or lack of inline tags

Inline tags can contain text formatting and file structure information, and also custom variables. While they generally can be moved to fit the translation, it is also possible to put them in the wrong place. Misplacing inline tags can cause target file generation to fail.

Solution: First of all, you should check if XTM Cloud is able to give you the reason why. To do this, go to Project Editor → Files → (select the relevant target language) → Target → (click on the red exclamation mark icon).

A message with an error log is displayed. Very often, this message can tell you what exactly is wrong with your file, as in this example:


If the message does not guide you to what is wrong with the file, you can now create a simple TEST project. You need to create a project that is exactly the same as your original one (same customer, language combinations, etc.) and try to generate the target file in it. If the target file still has the same problem, you should also check if any inlines are in the wrong place and try again.

Target is generated but it will not open: inline tags in the wrong place

If inline tags are put in the wrong place, this can also cause the generated target to have incorrect formatting, for some parts to be missing, or for the target to not open at all, and an error is generated.

Solution: To search for inline tags that are in the wrong place, do the following:

  1. Go to Project editor → General info → General info.

  2. Find the QA profile and click the pencil icon to edit it:

  1. Deselect all checkboxes except for the one in the Other section called: Order of inlines is changed or content is missing between inlines in target segment:.

  1. This change will only affect this specific project. Save the General info page.

  2. Open the file in XTM Workbench in "Edit" mode.

  3. Run the QA function for the document, to show only segments with warnings:

  1. Ensure that you check ICE and 100% matches as well:

  1. Once it is finished, review the segments to find any inline tags whose order has been changed, so they are incorrect.

The most common issues with inline tags are:

  • Nested hyperlinks and similar → A hyperlink cannot be nested as it cannot direct to two places at once. This always causes issues in the target file or in target generation. As you can see in the screenshot below, {2} tags are nested within {1}.

This is especially common in DOCX files, in which case the error below occurs when the user attempts to open the file:

  • Text outside of its proper structural bounds → In many files, text can only appear inside specific elements (like <t> text formatting inline tags in XLSX files) and cannot appear in other elements (like in <menucascade> in some types of XML file). If the text is put there, it will either not be displayed in the file (with a warning that something went wrong, and your editor will want to recover as much as it can) or the file will not open at all and an error will be generated.

  • Text moved to different structural bounds in files like DOCX → It is possible to use a style that hides the text and, by default, this text is then not extracted for translation. The inline tags containing the information about this text style can sometimes be moved to a place where they hide the translated text as well.

  1. If the file has been generated correctly after inline tag placement was corrected, it might be good to revert the QA check to the previous unmodified file (in the same place as before):

Target generates ceaselessly: stuck queues

It is most likely that the problem is caused by a stuck queue. The target file generation "cogwheel" will then spin endlessly without any error or other system message. In the vast majority of cases, the problem occurs during peak hours across Cloud-based clients who share common queues for different XTM modules modules.

Solution: Should that occur, open a ticket to the XTM International Support team. In it, include the following information:

  • URL you are using to log into XTM,

  • Company name you are using to log into XTM,

  • Project name or its ID,

  • Affected file name,

  • Affected target language.

Target does not generate at all: problem with headers

There is an error while generating the target file which might indicate that the problem is with headers. If so, the following error message is displayed after you select the red exclamation mark icon:

It is associated with the Initialization error in XTM Workbench (see XTM Workbench – most common issues & troubleshooting).

Solution: As stated in the referenced article, the above issue stems from “deserialization" of files' headers on the back-end side of XTM, which gives two solutions to the problem:

  • Reanalysis of the entire project,

  • Manual repair of the issue by the XTM support team.

In the latter case, open a ticket to the XTM International Support team, including the XTM Workbench instance ID for the affected file in the ticket details (click here for help).

Target does not generate at all: issue with configuration

Sometimes, during the work progress on a project, the configuration that is used for a project might get changed (i.e a config file gets removed), and it can create an error with target generation (usually if the reversor is changed). The error message generated after the attempt to generate the target is then long and difficult to understand.

Solution: In such a case, create a support ticket for the XTM International Support team and provide all the details needed for investigation.