A Glossary is a wxrks terminology asset — a set of approved terms and their translations that Augmented Translation, linguists, and reviewers can rely on. This article walks through creating a Glossary from scratch and connecting it to an Organizational Unit and a Project so it actually gets used in translation work.
💡 Who is this for? This guide is for Project Managers and Account Admins who need to create a Glossary and connect it to an Organizational Unit or Project within the wxrks platform.
1. Creating a Glossary
On the sidebar, open Context and click Glossaries. Then click Add Glossary.
Fill in the glossary's basic information, then click Create:
Name: the Glossary's name.
Organization: the Organization that owns this Glossary. Required, and permanent — see the note below.
Languages: every language this Glossary needs a reference for. At least two are required.
Notes: free text for anything about the Glossary's usage or origin.
Domain: an organizational category for the Glossary — marketing, legal, medical, and so on. This is metadata only; it doesn't affect the Glossary's terms or behavior.
Subdomain: a more specific category under the Domain (for example, Digital under Marketing). Also metadata only.
Custom Attributes: optional metadata fields you define yourself, used later to classify and filter the Glossary's terms.
Domain and Subdomain are searchable selects scoped to the Organization you picked — you can select an existing one or type a new value to create it on the fly.
Setting up a Custom Attribute: click Custom Attributes to expand the panel, type an attribute name, choose a type (Single Value, Single Select, or Multi Select), then click Add.
The new attribute appears in a table below, where you can switch a Single Value attribute to render as a boolean toggle (the shuffle icon) or remove it (the trash icon). Once the Glossary is created, these same attributes become fields you can fill in on every term you add to it.
Note: it isn't possible to change a Glossary's Organization after creation. wxrks doesn't support moving foundational asset details like this, to protect data integrity and to stay aligned with SOC 2 Type 2 requirements.
2. Adding terms to your new Glossary
A freshly created Glossary has no terms yet. From its own page you can add them one at a time, or import a batch from a .tbx or .xlsx file via the Import File button.
For the manual flow, see How to add new concepts to glossaries. If you're importing an .xlsx file, its columns need a specific structure — see How to Format Your XLSX File for Glossary Import before you upload. .tbx files generally import without extra formatting.
The Terminology Flow toggle on this page controls whether new terms route through the Terminology Board for review before they're added, and wxrks can also learn terms automatically as translation happens — see Learning Terms. For the full page layout (search, filters, the Actions menu's Edit/Export/Clear/Delete), see All about Glossaries, and for exporting see How to Export a Glossary.
3. Linking a Glossary to an Organizational Unit
A Glossary belongs to an Organization from the moment it's created, but a project can only use it once it's also linked to an Organizational Unit. One Organizational Unit can have multiple Glossaries linked to it. This step needs Account Admin permissions.
Open the Organizational Unit and go to its Context tab. Scroll to the Glossary table and click Add.
Select the Glossary (or Glossaries) to link — only ones already tied to the Organizational Unit's Organization appear here — then click Add Glossary.
Once linked, the Glossary's row gets a Default switch. Turn it on and this Glossary is automatically selected for every new project created under this Organizational Unit — turn it off and it's still available, just not pre-selected. The same row also has Enable Learning Terms (see Learning Terms) and an Advanced Settings gear for further configuration.
4. Linking a Glossary to a Project
With a Glossary linked to an Organizational Unit, any project created under that Unit can use it. When you create a new project, the Glossaries field sits in Step 1 (Configuration), alongside Translation Memory — it's pre-filled automatically if a Default Glossary is set for the Organizational Unit, and you can add more from the ones already linked.
To change which Glossaries a project uses after it's already created, open the project and go to its own Context tab, where a Glossaries section lets you add or remove Glossaries the same way as at the Organizational Unit level.
