Adding Terms

Who can use this feature

  • Supported on Pro, Team, and Enterprise plans
  • Only admins can edit Terms. Team members can only view Terms.

What’s in this article


Introduction

With Terms, you can manage, enforce, and share terminology that’s specific to your company. You can use Terms to:

  • Flag when a teammate has misspelled your company’s name or used the wrong verb for a call-to-action, and automatically suggest a replacement
  • Flag words and phrases that are banned – e.g., deprecated products, outdated wording, non-inclusive language
  • Highlight words that need to be used cautiously and give your teammates specific context on how to handle
  • Create a shareable glossary that your whole team can access, not just those with Writer seats

Types of Terms

You can create three types of Terms in Writer: Approved, Don’t use, and Pending.
✅ Approved Terms (and their common mistakes): These are terms that are ok to use – they’re part of your taxonomy (e.g., what you call a feature or service in your product) or word list (words you prefer writing a certain way, like Internet or e-mail).
For each Approved Term, you can add common mistakes. Common mistakes are ways that writers tend to write the term incorrectly.
❌ Don’t Use Terms: Terms that your writers should not use. These might be words that are banned for compliance reasons, deprecated, or extremely sensitive. You can link a Don’t use term to an Approved Term that your team should use instead.

Pending Terms: Terms that are waiting for sign off from your team before they can officially be labeled as Approved or Don’t use.

Using Terms

How does Writer enforce terms for your team? Check out below to see what happens when you’re writing in the Editor or with a Writer extension enabled.

If we find an Approved Term…

Writer will highlight the Approved Term in light blue. You can hover over an Approved Term to see the full description.

If we find a Common Mistake…

Writer will underline Common Mistakes in yellow. You can hover over the mistake to see the suggested replacement. Just select the suggestion in green, and your mistake will be replaced with the Approved Term.

If we find a Don’t use term…

Writer will underline the Don’t use term in yellow. You can hover over the underline to see more details. If the Term has an Approved Term alternative, we’ll suggest that as a replacement. Select the suggestion in green, and your Don’t use term will be replaced.

Pending terms

Since Pending terms are still awaiting approval by your internal team, Writer won’t check for them in your content.

Customizing Terms suggestion cards

Sometimes, using a Term correctly can be context-dependent. Team admins in Writer can use Description and Examples to provide teammates with more context about using the term.

Advanced options

Advanced options in Terms let you get more specific about when a term should be flagged by Writer.

Part of speech

Writer supports four parts of speech: noun, verb, adjective, and adverb. Terms can be added more than once if they are different parts of speech.
A common example is the term “login.” It could be written as “login” when used as a noun, but should be written as “log in” when used as a verb. 

To set up Writer to check for this, simply add “login” as an Approved Term, and select noun. Then, add “login” as a Common Mistake and select verb.
With this all set up, Writer will only flag “login” as a mistake when it’s used as verb.

Case sensitivity

Terms, including common mistakes, can be case sensitive or insensitive. If you select case sensitive, then Writer will only flag a term if the exact casing matches. If the term is not case sensitive, we’ll flag no matter what casing we see in your content. 

If a term is case sensitive, you’ll see two additional options:
  • Capitalize at the start of a sentence (default = on)
    • When switched on, we’ll suggest that you capitalize this term to follow the basic rule of capitalizing at the start of a sentence, even if it’s lowercase in your Terms list
    • When switched off, we won’t suggest you capitalize this term. Make sure you’ve turned this off for any brand names with a lowercase first letter (e.g. “mPharma is the leading digital pharmacy in Ghana...”)
  • Automatically suggest correct capitalizations (default = on)
    •  When switched on, Writer will suggest the correct capitalization to users who are using the wrong capitalization. e.g. if your Term is “Acme Widget” and a user writes “Acme widget,” Writer will suggest the correct capitalization even if you haven’t listed “Acme widget” as a common mistake. 

Enable/disable suggestions

If you’re not ready to start enforcing a term with Writer suggestions in your content, you can always disable this using the enable/disable suggestions toggle.

Managing, organizing, and downloading Terms

Using tags

Tags are a great way to keep Terms organized by use case, team, or category. 

When you’re ready to share and publish your Terms, you can use Tags to specify exactly which Terms to publish.

Downloading Terms

You can download Terms by clicking the download icon in the Terms toolbar. Your Terms will be saved to your Downloads folder as a CSV file. 

Sharing Terms

Once your terms are in Writer, it’s easy to build and publish a Terms list in just a few clicks with our Styleguide feature. Styleguides can be password-protected, but don’t require a Writer seat to access.
In your Styleguide Page Builder, Select a Terms page block . You can either publish all your Terms, or you can select specific Types or Tags to publish.   

Your published Terms will look like this. You’ll be able to filter by Term type or search for a specific term.

Importing Terms

You can import Terms via CSV or XLSX file. Read our guide on importing Terms here.

FAQs

Q: I have a Term that isn’t quite Don’t use, but isn’t Approved either. How do I handle this?

Some teams have terms that are “use only with caution.” For these, depending on the severity of using the term incorrectly, we’d recommend adding context in Description and Example fields to educate your users on where and when it is or isn’t ok to use the term.

Q: Why isn’t my Approved Term isn’t getting highlighted?

Writer will only highlight Approved Terms with a description filled in. We also don’t highlight Approved Terms in our Word or Outlook add-ins.  

Q: Can I add duplicate Terms?

Yes, but they’ll need to be different parts of speech and have unique case sensitivity.

Q: What if I or someone on my team doesn’t want to see my Approved Terms highlighting in blue?

You turn this off for yourself in the Chrome extension menu.

Q: My Terms download has weird symbols when I open it in Excel

If you’re seeing symbols like these {“} when you open your CSV in Excel, check that you are are opening the file with UTF-8 encoding. On MacOS, you can do this by going to Import File → Select UTF-8.

Still need help? Contact Us Contact Us