Tags can be attached to keys with meaningful labels to always keep them well organized. Generally, tags are useful to track which keys belong to a certain feature or section of a project to allow translating and reviewing more efficiently.
Allowed characters for tag names are letters, numbers, and the underscore and dash characters. Tag names with spaces or invalid characters will be normalized by removing the spaces or replacing the invalid character with an underscore.
There are several methods to add new tags to existing projects:
Tagging keys upon file upload
Provide a single or multiple tags to the relevant field. Tags are automatically added to all additional keys (or updated) in the uploaded file.
If uploading a .CSV or .XLSX file, tags can be assigned to individual keys via a separate column in the file:
-
Click on the Proceed to preview button in the page.
The page is displayed.
-
Select the label from the drop-down menu above the relevant column in the preview.
-
Click on Import at the bottom left to finish uploading the tagged keys.
Tagging keys manually
-
From the page of the project, click
for the key requiring tagging.
The window opens.
-
Type one or multiple keys in the field.
-
Click on Save to apply the changes.
The same procedure can also be performed in the translation editor through the feature.
Batch tagging keys
-
From the page of the project, select multiple keys.
-
Type a single or multiple tags in the input field at the top of the key list.
-
Click on Add tags.
All tags are added to the selection of keys.
The same procedure can also be performed in the translation editor through available batch actions.
Adding single tags
Single or multiple tags can also be added without yet assigning them to keys. To add tags, click the Add tag button on the page of the project.
Repairing tags
To replace an unwanted tag with a new one and ensure all keys are only in the newly created tag, re-upload the file with the correctly specified tag.
In the UI:
-
During upload, select to overwrite existing data with content from a localization file. Ensure the latest changes are downloaded before uploading again.
-
To prevent any keys from being automatically tagged with an
upload-tag, select .
In the config file:
-
Use the
- update_translationsand- skip_upload_tagsoptions.
This will add the new tag to the keys and the unwanted tag can then be removed from the upload using the batch action.
Use the tags page of the project to manage relevant tags. To enter the tags page, select More/Tags tab from the project page.
The tags page allows to search for tags in the list, filter them by specific types (system or custom) and sort them in various ways.
Click on at the right of the selected tag to edit its name.
Click on at the right of the selected tag to delete it. Use the same option at the top of the tag list to delete a selection of tags.