Skip to main content
Custom translation statuses

Learn how to configure, manage, and use custom translation statuses in your project.

Ilya Krukowski avatar
Written by Ilya Krukowski
Updated over a week ago

The custom translation statuses feature is available from the Pro plan and above.

In addition to built-in statuses, contributors can assign additional custom statuses to translations for a more efficient workflow. In this article you'll learn how to work with custom statuses.

Configuring custom translation statuses

To get started with custom translation statuses, proceed to project settings:

Find the Quality assurance section under the General tab and tick the Custom translation statuses option. You can also enable the Allow multiple custom statuses per translation checkbox to allow a translation to have multiple custom statuses at the same time.

Now you'll need to create custom statuses. To achieve that, click the Add status button. You'll be presented with the following dialog:

Enter a title (it's recommended to keep your titles short and concise), choose a color from the dropdown, and then click Save. Repeat this operation to add more statuses.

Once you are ready, don't forget to save the changes:

Assigning custom translation statuses

Once the Custom translation statuses option is enabled, you can add up to 20 custom translation statuses to each translation.

Adding custom statuses one-by-one

Click the Add status button next to your translation (represented as a white circle) and assign one or more statuses (you'll be able to assign multiple statuses if the corresponding option was enabled on the previous step):

Adding custom statuses in bulk

To add custom statuses to multiple translations in one go, perform the following steps:

  • Select the desired translations by ticking checkboxes next to them. A menu with bulk actions should appear.

  • Choose Custom translation statuses: set/unset from the dropdown.

  • Lastly, choose one or more custom translation statuses to add and click Set:

To remove custom statuses from the specific translations, perform the same steps and click Unset.

Please note that this operation will be applied to all languages that are currently displayed in the editor except for the base language. To include the base language, tick the corresponding option in the bulk menu. To learn how to include or exclude other languages, please check the Bulk actions article.

Adding custom statuses during file upload

To add custom statuses to specific translations during file upload:

  • Proceed to the Upload page.

  • Tick the Custom translation statuses option.

  • Choose one or more existing statuses to add.

  • Choose what keys should be assigned with the chosen custom statuses. There are three options: Inserted (the keys that were added to the project during file upload), Updated (the keys that already exist in the project but were updated during the upload), and Skipped (the keys that already exist in the project and were skipped (ignored) during the upload).

Adjusting custom translation statuses

Existing statuses can be edited at any time. To do that, click on the custom statuses next to your translation and then check or uncheck the desired statuses to add or remove them for the given translation:

To edit  titles or colors for custom statuses, proceed to the Project settings > General and find the Quality assurance section. Click on a small pen icon next to the specific custom status:

Notice on CTS permissions

Please note that by default only the project admins can assign or unassign custom translation status to/from translations. However, if you create a new task and enable the Restrict assignees to custom translation statuses option, the assignees will be able to toggle the chosen statuses in the scope of the task. Once the task is closed, the assignees will not be able to toggle the statuses anymore.

Using custom translation statuses

In the case that at least one custom translation status is added in project settings, the custom translation status section will appear next to each translation in the Editor. Statuses are displayed as colored circles.

If no statuses are assigned to the translation, the status section will have an empty (white) circle instead of any colored ones.

Translations can be filtered by custom statuses using Filter:

You can also export translations with a particular translation status. To achieve that, open the Download page, expand the Content to export section, and adjust the Custom translation status option:

Working with custom statuses in tasks

If you create a Translation or Review task, you can restrict assignees to being able to alter only specified statuses. Once a task item is marked as completed, all the statuses selected in the task will be applied.

If the Allow multiple custom status per translation checkbox is not enabled in project settings, only one status can be selected in task options. Otherwise, any amount of custom statuses can be selected.

Did this answer your question?