How do I manage my translation glossary?

4 min readBeginner

A glossary defines how specific terms should be translated across all languages. When the AI translates, it follows your glossary to ensure consistent terminology throughout your product.

Why use a glossary?

Without a glossary, the AI might translate "Workspace" as "Çalışma Alanı" in one place and "İş Alanı" in another. A glossary enforces consistency:

Source term Turkish French Spanish
Workspace Çalışma Alanı Espace de travail Espacio de trabajo
Dashboard Pano Tableau de bord Panel
Pipeline Pipeline Pipeline Pipeline

Adding glossary terms

  1. Go to your project → AI Context tab → Glossary
  2. Click Add Term
  3. Fill in:
    • Source term — the word or phrase in your source language
    • Translation — how it should be translated in each target language
    • Context (optional) — when this translation applies
    • Case sensitive — whether matching should be exact case
  4. Click Save

Managing terms

On the glossary page you can:

  • Edit — click a term to update its translations
  • Delete — remove a term from the glossary
  • Filter — search through your terms
  • Clear all — remove all glossary entries (requires confirmation)

How the AI uses the glossary

When translating, the AI receives your glossary as context. It will:

  1. Identify glossary terms in the source text
  2. Use the specified translation for each term
  3. Maintain grammatical correctness around the term
  4. Apply the term consistently across all translations in the batch

What to put in your glossary

Do include:

  • Product and feature names
  • Technical terms specific to your domain
  • Terms with multiple valid translations (pick one)
  • Brand-specific vocabulary

Don't include:

  • Common words with obvious translations
  • Full sentences (use guidelines instead)
  • Terms that should stay in English everywhere (put these in guidelines)

Glossary vs. guidelines

Use the glossary for specific term → translation mappings. Use guidelines for general rules and style instructions. They work together — guidelines set the overall approach, the glossary enforces individual terms.

Next steps