Introducing style guides from Grammarly Business

The style guide feature allows you to create custom rules that tailor Grammarly to your organization’s unique writing style.

Note: The ability to manage the style guide is available to Grammarly Business admin users only.

Getting started 

  1. To create rules, go to the Style Guide page of the Admin panel. You can add new rules one by one (+ New Rule button) or upload several rules at once from a CSV file (Import Rules button):
    Import_rules__New_rule.png
  2. To get a better understanding of how it works, we suggest that you start by clicking the + New Rule button. Here you will see the three parts that make up a rule:
    • Original text - an incorrectly spelled word or phrase that you’d like to change (Tip: you can press Tab to enter several instances).
    • Change to - a substitute for the original text. Check No text change if there is no substitute for the original text.
    • Explanation of the rule - some context for your team to understand the suggestion.
      Company_name.png
  3. Once the necessary fields are filled out, click Add to include the new rule in your style guide.
  4. Add as many rules as you wish, then activate the style guide by toggling the corresponding switch:
    Enable_Latest.gif
  5. That’s it! Your team members will now see suggestions from the style guide as they type:
    in-line_alert_copy.png

Note: Style guide suggestions are not available in the Grammarly Keyboard at this time.

How to add rules in bulk

We also offer an option to upload rules as a CSV file. To do this, please follow these simple steps:

  1. Go to the Style Guide page, click the Import Rules button, and download the CSV file with your existing rules:
    Upload_in_bulk.gif
  2. Open the downloaded file and populate it with your new rules of choice. It is important to keep the original formatting of the file intact.
  3. Save the edited file and upload it by clicking Proceed to upload in the same menu.

Note: If you’re having trouble uploading the file, please make sure that it does not contain non-English characters and try again.

Can I see how often the rules are being used?

To check the number of times each rule was viewed, accepted, and ignored, simply go to the Style Guide page and click on any rule:
Rule_stats.png

How can I change the style guide logo?

The style guide logo appears on all suggestion cards from the style guide. To upload your custom image, go to the Style Guide page and click the + button next to the name of the style guide:
Upload_logo_LATEST.gif

Can I limit the style guide suggestions to certain websites?

You can specify a list of URLs where you'd like the style guide suggestions to appear. You may find this useful if your style guide is geared toward external communication (for example, writing publicly on Twitter) but less important for internal communication (for example, Slack messages).

To create an allowed list, visit the Style Guide page, click the gear icon, and choose Only on the following websites:Whitelist_URLs.gif

Add the URLs for websites where you would like your style guide suggestions to appear and confirm the selection by clicking save URL settings. On all other websites, style guide suggestions will be hidden unless the user clicks the green G icon in the lower right corner of the text field.

Formatting tips:

  • google.com (no “www”): Use this format to include all associated URLs, including www.google.com, mail.google.com, docs.google.com, etc.
  • docs.google.com: Use this format to include only the page found at a specific URL.

How do I come up with new rules?

  • Take a moment to brainstorm some common writing issues among your team members. These might include customer or product names that are often miswritten, special terms that get used incorrectly, or words that your company prefers not to use.
  • When you specify the original text, consider adding a few versions of it if your team tends to miswrite it in different ways.
  • When setting up a new rule, be sure to account for all forms of the word or phrase, including plurals and different tenses.
  • As you and your team begin interacting with the suggestions generated by your custom rules, you’ll likely want to make adjustments. Remember, you can change, add, or delete a rule at any time!

Example rules

These are some example categories of rules to include in your style guide.

Product or company names

Original text Change to Explanation of the rule
Acmeco AcmeCo This is the preferred spelling of our company name.

Always capitalized (or lowercase) terms

Artificial Intelligence artificial intelligence If you spell out artificial intelligence, don’t capitalize the a and i.

Abbreviations

ML machine learning Always spell out machine learning.
& and Always spell out and.
BTW, btw by the way Avoid using abbreviations in correspondence with the clients

Jargon to avoid

synergy, synergies   This term doesn’t resonate with customers. Avoid in public-facing material.

Terms with specific uses

smartphone, smartphones   Use “smartphone” only when talking about phones specifically. When talking about phones and tablets, use “mobile device.”

Preferred terminology

employee team member “Team member” is our preferred term
employees team members “Team member” is our preferred term
Was this article helpful?
Have more questions? Submit a request