• Documentation
  • Translation Checks
  • Setting Translation Checks

Setting Translation Checks

Translations missing key elements such as a variable or link could potentially break your website or app. To help prevent this, Transifex automatically checks every translation against a set of conditions. Whenever a condition is not met, e.g. an HTML element is missing, the translator will be shown either a warning or error message telling them what needs to be fixed. Translators can still save a translation when there's a warning. But if there's an error, they'll need to address the issue before they'll be able to save the translation.

Customizing translation checks

Each file format has a set of translation checks on by default. You can change whether a failed check results in an error or warning, or turn off a check all together.

To customize translation checks:

  • Go to your Organization Settings from the main navigation.

  • Click on Translation Checks in the left menu.translation-checks-overview.png#asset:80

  • Click on a file format to see the checks available for that file format.

  • Click on the toggles next to each rule to change whether a check should show a warning, error message, or be off.


  • Hit Save to confirm the changes.

You can always restore the translation check settings by clicking the Set to default checks next to the Save button.

Checking for custom variables

If you use custom variables in your code, you can set up custom translation checks and make sure they are left untouched in the translation. This is done by adding a custom check for a file format, and specifying either the characters your custom variables start and end with or the exact characters your variables consist of.

To do this:

  • Head to the Translation Checks settings page.

  • Click on the file format you want to add custom checks for.

  • Click Set up placeholder delimiters.

  • In the popup:

    • if you provide a start and end value, then the system will try to detect text which starts and ends with the specified words. So, in order to protect variables like {address}, %email%, [username] etc. during the translation process, you will just need to complete the fields "Starts with" and "Ends with" as shown below: 


    • if you want the system to look for exact matches instead (e.g. %ld, %temperature), then you can enter the variable in the "Enter a custom variable" field including all the characters the variable consists of.
  • Click Add placeholder so as to finish adding this check. You can add more if you like by creating more placeholders.



When adding multiple placeholder delimiters, keep in mind that the delimiters are executed in the order they are added.

In the following example both placeholders will be executed. However if the order was reversed then only the first expression would be executed.

Macaque in the trees

Like the default checks, you can change whether a failed check results in an error or warning, or turn it off all together.