Using Glossaries

Glossaries are custom terminology dictionaries that enforce brand-specific translations across all your content.

What are Glossaries?

Glossaries allow you to:

• Preserve brand names - Ensure product names are never translated
• Enforce terminology - Map technical terms to your preferred wording
• Maintain consistency - Keep translations uniform across all content

Creating a Glossary

1. Navigate to Dashboard → Settings → Glossaries
2. Click Create Glossary
3. Enter a name for your glossary (e.g., "Brand Terms")
4. Click Create

Adding Glossary Entries

Each glossary contains entries that define how specific terms should be translated.

1. Open your glossary by clicking on it
2. Click Add Entry
3. Fill in the entry details:
   • Source Term: The original term (e.g., "Acme")
   • Target Term: How it should appear in translations (e.g., "Acme")
   • Target Language: The language this applies to (e.g., "es" for Spanish)

Example Entries

Using Glossaries with API Calls

Glossaries are automatically applied when you include a project_slug in your API request, and that project is associated with a glossary.

curl -X POST https://your-domain.com/api/v1/translate \
  -H "Authorization: Bearer opt_your-token" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Create your Acme workspace",
    "target_lang": "es",
    "workspace": "my-workspace",
    "project_slug": "marketing"
  }'

Best Practices

1. Start small - Begin with your most important brand terms
2. Be specific - Use exact matches for terms you want to control
3. Review regularly - Update glossaries as your terminology evolves
4. Test translations - Verify glossary entries work as expected

Glossary Limits by Plan