Glossary & Style Guide

Add / Update Glossary Terms

Once you have created a Glossary in Smartling, you should continue to add and edit Glossary terms. By design, a Glossary is meant to be a "living" document that changes as your content matures and evolves. Therefore, updating the Glossary is encouraged.

This article covers how to add glossary terms via the Dashboard, how to edit existing terms via the Dashboard, and how to perform a bulk-update to your Glossary via a file upload.

If you are a Translator or Editor, you can add glossary terms directly in the CAT Tool.

Add a new Glossary Term 

  1. Go to Account Settings > Linguistic Assets.
  2. Under Assets, click Glossaries.
  3. Click the glossary you want to update.
  4. Click Add Term
    The Add Glossary Term dialog appears.
  5. Fill in the glossary term details.
  6. Click Add Term to finish adding the term to your source glossary.

The term will be added to your source glossary.

Add Language-specific Details

If you have language-specific details for a term, such as a preferred translation or notes, these can be added after the term is created:

  1. On the Glossaries page, click the glossary you want to update.
  2. On the menu next to the Search terms field, select a language.
  3. Click the pencil icon next to the term you want to update.
  4. Click the Translation Details tab.
  5. Enter translation details
  6. Click Save Changes

Repeat this process for other languages as necessary.

Edit a Glossary term in the Dashboard

  1. Go to Account Settings  > Linguistic Assets.
  2. Under Assets, click Glossaries.
  3. Click the name of the glossary to update.
    You'll default to the glossary that applies to your source language but you can toggle to the language of your choice.
  4. Find the glossary term to update and click the pencil icon.
    The Edit Glossary Term dialog appears.
  5. Edit the glossary term and then click Save Changes.

Bulk-Update a Glossary via File Upload 

You can perform a bulk-update to an existing glossary by exporting the existing glossary, updating it locally, and re-importing the updated file. Bulk-updates can include removing terms that are no longer required, simply by removing them from the exported file and selecting the bulk delete checkbox when uploading the updated file.

Only Excel or CSV files are accepted for bulk-update upload

To upload an updated glossary;

  1. Go to Account Settings  > Linguistic Assets
  2. Under Assets, click Glossaries
  3. Click the name of the glossary to update
  4. Go to More > Update Terms From File
  5. Choose the updated glossary file
  6. Bulk Delete: Choose to bulk-delete any existing glossary terms that are not included in the updated glossary file by selecting the checkbox
  7. Click Upload


Glossary Term Details

All fields except for the term itself are optional, but detailed information will help your translators better understand your terminology and create quality translations.

Source Term Details

  • Term: The source language term.
  • Part of Speech: Select from noun, verb, adjective, etc.
  • Definition: Define the source term.
  • Case Sensitive: If checked, only words or phrases with cases matched will be highlighted in the CAT Tool as Glossary terms. For example, if there is a term "Word", then "word" will not be treated as a term.
  • Exact Match: If checked, only words or phrases that match exactly with the terms will be highlighted in the CAT Tool as Glossary terms. This includes hyphenated terms. For example, if "Exact Match" is selected for the term "Walk", then "Walk" and "Walk-about" will be treated as a glossary term but "Walks", "Walking", or "Walked" are not be treated as a term.
  • SEO Term: Used to mark a term that is important for Search Engine Optimization.
  • Do Not Translate: If checked, instructs translators not to translate the term in your content.
  • Variations/Synonyms/Antonyms: Related terms as an aid to translators, but NOT used for matching. For example, if "create" is a Glossary term, you may wish to declare "creates", "creator", or "creating" as variations; "write" or "build" as synonyms and "destroy" as an antonym.
  • Notes: Add any additional information that may be of use to translators.

Translation Details

  • [Language] Translation: The translated term.
  • [Language] Notes: Any additional information on the term. Use this field for notes specific to the current language. General notes should go under the SOURCE TERM DETAILS tab.
  • Lock Translation: If checked, translation resources cannot edit this translation of the term.

Was this article helpful?