Glossary & Style Guide

Important Information for Migrating to the New Smartling Glossary

The New Smartling Glossary is currently in roll-out. If you have yet to be migrated to the new Smartling Glossary, there are a few important notes to bear in mind. This article covers:

What will be migrated?

The following will be fully migrated from the old Glossary to the new Glossary:

  1. All Glossary entries and translations
  2. Specified target languages*
  3. DNT flags
  4. Glossary Custom Fields
  5. Part of speech
  6. Language notes
  7. Term variations
  8. Adding Glossary Terms via the CAT Tool (with permissions)
  9. Request Translation via the Glossary
    • If you have Glossary terms in translation during the migrations from old Glossary to new, this will not be affected by the migration. The only factor to consider is that to locate the strings in the Stings View, you will have to filter for URI: /Glossary. See Translating Glossary Terms with the New Smartling Glossary for more information.

*Any existing Glossaries with no target languages specified will be migrated over to the new Glossary with all languages in the linguistic package. For more information, see Important Changes to the New Smartling Glossary.

What will not be migrated?

The following will not be migrated from the old Glossary to the new Glossary:

  1. SEO flags - deprecated
  2. Synonyms*
  3. Antonyms - deprecated

*Referred to as Term Variations in the New Glossary, but metadata will not be migrated from the old version to new. 

Read ahead to learn how the above can be included in your New Glossary.

What can I do to prepare?

While there is nothing required of you to migrate from the old Glossary to the new Glossary, it may be a good time to preform a Glossary "health-check" to ensure only the most up-to-date and relevant content is ready and available in the new Glossary.

Export your Glossaries

Although this is not essential at all to the migration, it is recommended that you export all of your Glossaries ahead of moving from the old version to the new version. That way, you have a record of all of your termbases, and if anything is missing, you can easily import it once migration is complete.

It might also be useful to export the Glossaries to reapply what will not be migrated to the New Glossary. With an export, you can import any synonyms and antonyms as Language Notes or Term Variations. Furthermore, if you use SEO flags on any terms, an export will help you identify these, and you can then use the new Label Management feature in the New Glossary to label them as such.

Specify target languages

If you are happy to have all languages in your linguistic package included in the new Glossary, skip ahead. However, if you would like your new Glossary to only include specific and relevant languages, you should check the Glossary details.

  1. Go to Account Settings > Linguistic Assets
  2. Under Assets, click Glossaries
  3. Enter a Glossary by clicking a Glossary name
  4. Click Edit Details
    • From here, you can see what languages have been specified for the Glossary, and make amendments where necessary.
  5. To specify target languages, ensure the Only applicable for selected target languages checkbox has been selected and choose the target languages from the dropdown menu
  6. When you're finished, click Save Changes


Collect image references

The new Smartling Glossary allows you to upload image references for each Glossary entry (see below example of an entry in the new Glossary). Start reviewing your termbase and collecting image reference ready to be uploaded once you have been migrated.


Review, revise, reinvigorate

When was the last time you reviewed your Glossary? Has your brand evolved since then? Probably!

Use this opportunity as the perfect time to delve into your termbase and give it new life. After all, it is recommended to review and refine the Glossary every 6 months.

Smartling provides tools to support this task. Quality Checks highlight when glossary compliance was missed. Perhaps linguists need a broader selection of preferred terminology to reduce these errors. Listen to linguists by reviewing Issues relating to Glossary terms.

Watch our Video Tutorial


1. Introduction:
What is a glossary?
How does a glossary work in Smartling? 00:48
2. Demo:
Access your glossary list
Customize your glossary view
View & edit glossary entries
Visual context:
Set DNT (Do Not Translate)
Add approved translations (Multi-directional translations)
Term Variations & Language Notes
Example strings
Add a new glossary entry
Custom fields
Edit & import glossary entries in bulk
Create & import a new glossary
Archive & unarchive glossary entries
Archive & unarchive a glossary

Was this article helpful?