What are the terms?
Terms refer to microcopy, the small bits of copy in the user interface that help users figure out how to do things:
How does the Terms List work?
First step: open the Vocabulary Tool landing page and select a vocabulary.
For example, select the Default Vocabulary to view all terms within this list.
Opening a vocabulary displays the related Terms list.
The Terms List lays out the terms in a table.
The Terms List table shows:
- Term codes: This hyphenated text signifies what the term is, for example, new-wonderful-term. Each term's code is unique, meaning terms cannot be duplicated.
- Languages: The translations available.
- Last updated: The date and time the term was updated.
The Terms List table also uses colors to show which language each term has been translated into. Here’s a summary of what each color shows:
- Gray -> the term's translation is missing
- Blue -> the term's translation is available
How to detect and manage out-of-date terms?
In a collaborative working space, it happens that different translators edit the same terms, each for their language of responsibility. When that happens, the Terms List highlights it with the warning symbol in the row of the term that had a change:
Entering the term's detail page, you'll find the same warning symbol near to each language that requires a check following term changes:
If you're OK with the changes you see, select Yes, Translations are ok:
Editing terms
Producers can change terms using Term Detail pages in the Vocabulary Tool.
Producers can edit the following details on a Term Detail page:
Further down the same page:
- Term code: The hyphenated copy that signifies what the term is (for example, new-wonderful-term). The terms code can't be changed after creation.
- Standard: Given two versions of a translated term, the standard one doesn't have to fit a specific size on the front-end.
- Short: Unlike the standard translation, the short one must fit a limited size on the front-end.
- Context: It groups terms based on their location on the front-end. E.g., the menu header context groups together all terms to display in the menu header.
- Term type: What the term is — for example, a single word, a combination of words, or a sentence.
- Description: A summary of the term and its job. For example, this term is the headline for the Latest News section on a homepage.
- Screenshot Reference: Producers can add a screenshot showing where the term is on the front-end. For example, a screenshot of an editorial list showing an image of an editorial list's title.
- Translations: Producers can include the terms that appear on the front-end product, in multiple languages. Producers can ask for a new translation by adding translated text to an empty language. Only add text for enabled languages.
How to share the term with other vocabularies?
Select Add to another Vocabulary to share a term with other vocabularies:
Statistics of a vocabulary
The Statistics tab contains data that describes the status of the vocabulary:
The available data includes:
Bulk export of terms
Selecting one or more terms in the Terms List enables the bulk operations toolbar on the bottom page:
Producers can:
-
: Copy the selected terms into an existing destination vocabulary.
Copy into the destination vocabulary succeeds if (both conditions must be true):
- The selected terms have a not-empty translation for the main language of the destination vocabulary.
- The selected terms do not yet exist in the destination vocabulary.
If the vocabulary of the selected terms has a different main language than the destination vocabulary, a warning message notifies the difference and the copy is successful.
-
: Copy the selected terms into a new vocabulary.
-
: Download the selected terms in a CSV file.
Archiving terms
Producers can also archive terms they no longer use on their product. Archiving terms removes them but doesn’t permanently delete them.
Producers can archive terms by:
- Select the three dots icon in the top right corner of the page.
- Select Archive.