Labels for Organizing Content

Organizing, categorizing, and filtering content

Labels are a method of categorizing your phrases in the Localize dashboard. You can use labels to filter your phrases in the phrases dashboard and when ordering translations.

Create a Label

To create a new label in the dashboard, scroll to the bottom of the labels block and select the "+ Create label" link.

Enter the label name and select 'Create label'.

Note: You can also create a label by creating a Label Trigger.

Edit a Label

To edit an existing label, select the gear icon next to the label in the list.

Make your changes and select 'Save label'.

Delete a Label

To delete an existing label, select the gear icon next to the label in the list.
Select 'Delete label', then click OK in the warning dialog.
This will remove the label from all phrases to which it was added.

Add a Label to a Phrase

To add a label to a single phrase in the dashboard, select the drop-down at the top-right of the phrase, then select the checkbox next to the desired label.

Bulk Add a Label to Multiple Phrases

Search for a phrase (or apply a filter)

Select all phrases (or just the ones that you want)

Apply the appropriate label

Example Use Case: Ordering translations

You can use labels to filter your phrases when ordering professional translations.
With labels, you simply...

Navigate to the Orders tab:

Filter by label:
Select the desired label from the list

...and Place an order!

Label Triggers & Actions

Label Triggers are conditions under which phrases get tagged with a label automatically.

1) HTML 'data-localize' Attributes
2) A search filter -- (future feature request)
2) Content from a domain URL -- (future feature request)

HTML data-localize Attributes

<HTML ELEMENT data-localize="TYPE-YOUR-LABEL-HERE">

Simply add the data-localize= attribute to any HTML element and then input your label name in double quotes, with no spaces.

For example: <div data-localize="Documentation">

Multiple Labels

You can add multiple labels to any one HTML element, including <meta> tags and your <title> tag.

For example: <div data-localize="Documentation auto-approve">
This will add 2 labels to the phrase(s) contained in the div: 'Documenation' and 'auto-approve'

Reserved Labels

Reserved Labels have been pre-designated for given actions.

Auto Approve
Adding the attribute data-localize="autoapprove" or data-localize="auto-approve" to an HTML element applies the label 'auto-approve' to phrases within that HTML parent element. When phrases within that element are sent to the translation engine, the phrases are put directly into the Published bin, without further input from you, and labelled with "auto-approve".

Note: This also applies to <meta> tags in the header of your HTML page.

Label Actions automatically apply when a phrase gets added to a label. Currently, we have four:

Approve (as described above)
Block -- (under development)
Ignore -- (under development)
Delete -- (under development)

All label customization, including triggers and actions, may be found in the gear icon.

Labels for Organizing Content


Organizing, categorizing, and filtering content

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.