Labels for Organizing Content

Organizing, categorizing, and filtering content using Labels

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.

System-Generated vs User-Created Labels

User-Created Labels
As a user, you can create your own custom labels to be used for filtering phrases.

System-Generated Labels
When importing new phrases into your dashboard, Localize will automatically add system-generated labels to specific content types. See the System Labels doc for more details.

Label Manager

The Label Manager allows you to easily organize and manage your labels. With the Label Manager you can create/edit/delete labels, hide/show labels, and set the "Auto-approve" checkbox, all in one convenient place.

Learn how to use the Label Manager here...

Create a Label

You can dynamically create labels from within your HTML using a Label Trigger.

To create a new label in the dashboard, select the "Create label" link or button.

  1. Enter the label name
    a. Label names may only contain alphanumeric characters plus the following: - _ . : /# (dash, underscore, period, colon, forward slash, number sign)
  2. (optionally) Add a description for the phrase
  3. (optionally) Select the Automatically approve phrases checkbox if you would like to automatically approve any phrases that contain this label.
  4. (optionally) Select the Never deprecate phrases checkbox if you don't want any phrases with this label to be deprecated.
  5. (optionally) Select the Exclude Phrases from translation orders checkbox if you don't want any phrases with this label to be added to a human translation order.
  6. (optionally) Select the Exclude Phrases from machine translations checkbox if you don't want any phrases with this label to be machine translated.
  7. Select Create label when ready

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

Edit a Label

To edit an existing label, select the settings icon next to the label in the list, or select Edit from the Label Manager.

  1. Make your changes to the label name.
    a. Label names may only contain alphanumeric characters plus the following: - _ . : /# (dash, underscore, period, colon, forward slash, number sign)
  2. (optionally) Add/edit the description for the phrase
  3. (optionally) Select the Automatically approve phrases checkbox if you would like to automatically approve any phrases that contain this label.
  4. (optionally) Select the Never deprecate phrases checkbox if you don't want any phrases with this label to be deprecated.
  5. (optionally) Select the Exclude Phrases from translation orders checkbox if you don't want any phrases with this label to be added to a human translation order.
  6. (optionally) Select the Exclude Phrases from machine translations checkbox if you don't want any phrases with this label to be machine translated.
  7. Select Save label when ready

NOTE: You cannot edit a System-Generated Label.

Delete a Label

To delete an existing label:

  1. Select the settings icon next to the label in the list.
  2. Select Delete label
  3. Click OK in the warning dialog.
    This will remove the label from all phrases to which it was added.

Alternatively, you can select Delete from the Label Manager.

NOTE: You cannot delete a System-Generated Label.

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

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'

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

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

<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">

  • When Localize brings in a phrase with this data-localize attribute attached to it, it will add the "Documentation" label to the phrase.

Image Replacement Phrases

  • If you have enabled the Image Localization feature for your project, all image phrases that are brought into the Localize library will have the lz-image System Label applied to the phrase.

Label Actions

Label Actions are automatically applied when a label gets added to a phrase.

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 they are labelled with "auto-approve".

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

  • This is especially useful if you are using the Backend API to add phrases to Localize.

Never Deprecate

Adding the attribute data-localize="neverdeprecate" or data-localize="never-deprecate" to an HTML element applies the label 'never-deprecate' to phrases within that HTML parent element. When phrases within that element are sent to the translation engine, the phrases are marked so that they will never be auto-deprecated, and they are labelled with "never-deprecate".

Exclude from translation orders

Exclude from machine translations

  • When this rule is enabled on a label, phrases with that label applied will not have machine translations generated automatically.
  • This rule is automatically enabled for all lz-image System Labels

Reserved Labels

Reserved Labels cannot be used when creating User-Created labels. These include:

  • auto-approve, autoapprove
  • never-deprecate, neverdeprecate
  • any System-Generated label
    • lz-*
    • lza-*
    • lzm-*

Updated 9 days ago

Labels for Organizing Content


Organizing, categorizing, and filtering content using Labels

Suggested Edits are limited on API Reference Pages

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