User guide

2. Glossaries

A glossary tells the model which translation to use for a term.

1

In the workspace, click Glossary.

Step 1
Step 1
2

The Glossary tab opens with one row per glossary.

Step 2
Step 2

2.1 Open a glossary

1

Click the arrow at the left of the glossary row.

2

The terms of the glossary open below the row.

Steps 1–2
Steps 1–2

2.2 The buttons on a glossary row

1

On/off switch: makes this glossary the active one.

2

Pencil: rename the glossary.

3

Review duplicates: terms stored more than once.

4

Duplicate glossary: makes a full copy.

5

Export CSV: downloads the glossary.

6

Delete: removes the glossary.

Steps 1–6
Steps 1–6

2.3 Create a glossary

1

Click New Glossary.

2

Click Enter Manually. (Upload File creates the glossary from a CSV or XLSX file.)

Steps 1–2
Steps 1–2
3

Type a name.

4

Choose the domain.

5

Choose the source language and the target language.

6

Type a description (optional).

7

Click Create Glossary.

Steps 3–7
Steps 3–7
8

The new, empty glossary appears in the list.

Step 8
Step 8

2.4 Add terms

1

Click the arrow of the glossary to open it.

2

Type the source term.

3

Type the target term.

4

Type a note (optional).

5

Press Enter or click +.

Steps 1–5
Steps 1–5
6

The term is added as Approved and the term count goes up (here 4 terms).

Step 6
Step 6

2.5 Edit a term and choose its usage

Usage tells the model how to treat a translation:

  • Approved: the model must use this translation.
  • Alternative: kept for your reference only; it is never sent to the model.
  • Forbidden: the model is told not to use this translation, and QA flags it.
1

Click the pencil on the term's row.

Step 1
Step 1
2

Change the wording if needed.

3

Choose the usage, for example Forbidden.

4

Click Save term.

Steps 2–4
Steps 2–4
5

The usage is shown in the table (here Forbidden).

Step 5
Step 5

2.6 Import terms into a glossary

1

Open the glossary and click its Import button.

Step 1
Step 1
2

Click Choose file and pick a CSV, XLSX or TBX file.

3

Check the languages.

4

Choose the domain.

5

Click Import.

Steps 2–5
Steps 2–5
6

The new terms are added (here 31 terms). Terms that already exist are not added twice.

Step 6
Step 6

2.7 Create a glossary from a file

1

Click Import at the top of the Glossary tab.

2

Click Choose file and pick the file.

3

Check the languages and the domain.

4

Type the glossary name.

5

Click Import.

Steps 1–5
Steps 1–5

2.8 Sections

Sections group the terms of one glossary, for example Payments.

1

Click + Section.

Step 1
Step 1
2

Type the section name and press Enter (or click the tick).

Step 2
Step 2
3

The section appears next to All and No section. Click it to show only its terms.

Step 3
Step 3

2.9 Bulk actions

1

Tick the terms you want (or the box in the header for the whole page).

2

The bar shows how many terms are selected.

Steps 1–2
Steps 1–2
3

Choose the action, for example Put in a section.

4

Choose the destination (here Payments).

5

Click Apply.

Steps 3–5
Steps 3–5
6

The terms are now in the section.

Step 6
Step 6

2.10 Find and replace

1

Click Find and replace.

2

Type the text to find.

3

Type the replacement.

4

Choose where to search and which terms.

5

Click Preview.

6

Check the change, then click Replace.

Steps 1–6
Steps 1–6

2.11 Recent changes and term history

1

Click Recent changes.

2

Click Undo next to a change to reverse it.

Steps 1–2
Steps 1–2
3

Click the clock icon on a term's row to see its history.

Step 3
Step 3
4

The history lists every version of the term.

Step 4
Step 4

2.12 Merge glossaries

1

Click Merge.

2

Choose the glossary to copy from.

3

Choose the glossary to merge into.

4

Click Merge.

Steps 1–4
Steps 1–4

2.13 Review duplicates

1

Click Review duplicates on the glossary row.

Step 1
Step 1
2

Click Find duplicates.

3

Click Keep this one on the translation you want to keep. Exact copies are removed; different translations are kept as alternatives.

Steps 2–3
Steps 2–3

2.14 Duplicate a glossary

1

Click Duplicate glossary (the copy icon) on the row.

2

The copy appears in the list with "(copy)" in its name.

Steps 1–2
Steps 1–2

2.15 Use a glossary correctly

A glossary works best when every entry is short and unambiguous. Check these points before you translate:

  • Language pair: the glossary must have the same source and target language as the document. An English → Italian glossary is not used for English → French.
  • One approved translation per term. Keep other valid wording as Alternative (it is never sent to the model) and wording to avoid as Forbidden.
  • Enter the term, not a sentence: a word or short phrase as it appears in the source, with the target in its basic form. The model fits it into the sentence (plural, case); check those forms in review.
  • Names, product codes and brands that must not change: enter the same text on both sides, for example ACME-X1 → ACME-X1.
  • Select the glossary where you translate: in the text translator, or in the glossary step of document translation (Use existing glossary).
  • Only the terms that appear in your text are sent with it, so one complete glossary per client and language pair is fine.
  • After translation, the quality checks flag every segment where an approved term is missing. Review those segments in the editor.