Use a glossary

A glossary is a set of terms with translations, definitions, and notes.

You may find it helpful to use a glossary if your translation contains special or uncommon terms, or is part of a set of documents that should have consistent terminology.

Get started

Create a glossary

Create your glossary as a UTF-8, CSV file. Translator Toolkit requires UTF-8 because the format supports a wide range of languages and characters.

Step 1: 

Using a spreadsheet program that supports UTF-8, such as Google Sheets, enter your glossary terms in the following format:

Glossary format

Header row

  • Locale column(s): Contains a valid code for each locale. For example, "en" for English or "es" for Spanish. At least one locale is required for a glossary.
  • Part of speech column (optional): Only includes the following value: "pos".
  • Description column (optional): Only includes the following value: "description".

Data rows

  • Term column(s): In each row, enter a term that corresponds to the locale in the header. At least one term is required for a row to be valid.
  • Part of speech "pos" column (optional): For each term, enter its part of speech: adjective, adverb, noun, or verb.
  • Description column (optional): Provide any notes for the translator, including the meaning of the terms.

Note: Your glossary can be up to 1MB.

Step 2: 

When you're finished creating your glossary, download it as a CSV file. The CSV file can be uploaded into Translator Toolkit.

Upload a glossary
  1. Go to Translator Toolkit.
  2. In the left menu, click the Tools arrow
  3. Click Glossaries.
  4. Click Upload.
  5. Click Choose a file. Browse and select the glossary file you want to upload, then click Open.
  6. Under "What do you want to call it?" enter a name.
  7. Click Upload glossary.
Upload a new glossary into an existing one

You can upload a new glossary into a glossary that's already in Translator Toolkit. Glossary terms from the uploaded file will be added to your existing glossary.

  1. Go to Translator Toolkit.
  2. In the left menu, click the Tools arrow 
  3. Click Glossaries.
  4. Click to open the glossary you want to add a new glossary to.
  5. Click the Upload entries tab.
  6. Click Choose a file. Select the glossary file you want to upload, then click Open.
  7. Click Upload.
  8. Click Save
Use a glossary to translate 

Step 1: Select a glossary

When you upload a file to translate, you can select the glossary you want to use. 

Or you can attach a glossary to a file that's already uploaded:

  1. Open the file in the Translation editor.
  2. Click File > Properties.
  3. Select a glossary from the drop-down menu, then click OK.

Step 2: Use the glossary to translate

  1. Open the file associated with the glossary.
  2. At the top right of the Translation editor, click Show Toolkit. You'll see a "Glossary" section in the Toolkit.
  3. Start translating your document. As you translate segments, you can see if there are any available glossary matches. When there's a glossary match, the term will be highlighted in your segment.
  4. Hover over the highlighted term to view the translation. To see details like definition and part-of-speech, look at the "Glossary" section of the Toolkit.
Change the glossary you're using

If you start translating a document and realize need to change the glossary you’re using, here’s how:

  1. Open the document in the Translation editor.
  2. Click File > Properties.
  3. Select the glossary you want to use, then click OK.
Share a glossary

You can share a glossary with others. When you share a glossary, it helps ensure accurate and consistent terminology a group translation project. 



Was this article helpful?