Tone Detector
Tone is key to effective communication, and Grammarly can detect the tone of messages and help with striking the right note. If you turn on the tone detector feature for the Grammarly Text Editor Plugin, your users will see emojis reflecting the tones detected in their text, so they can be confident they sound the way they intend.
The tone detector feature is only available for apps on the Plus plan. Learn moreopen in new window about our plans.
How it works
If you’re familiar with the tone detectoropen in new window in other Grammarly product offerings, the Grammarly Text Editor Plugin feature operates in much the same way.
The tone detector is located to the immediate left of the Grammarly button by default. It uses an emoji to show the top tone that Grammarly has detected in the text. When the user hovers over the tone detector, the name of the tone appears.

Clicking on the tone detector reveals additional tones detected (up to three tones in total) as well as their intensity.

Keep in mind the following:
- The tone detector will not appear for very short pieces or very long pieces of text, as Grammarly requires at least 120 characters (a few sentences) to detect tone.
- The tone detector will not activate for text over 2500 characters in length.
- The tone detector will only activate when an editor receives focus.
- If multiple editors are present on the page, the tone detector reflects the in-focus editor only.
- Your users can turn tone detection on or off at any time from the Grammarly button menu.
- Grammarly can detect dozens of different tones, and the exact list may evolve over time.
You can try out the tone detector in our demo. Make sure the editor is in focus and contains at least a few sentences of text.
Configuration
To activate or deactivate the tone detector, use the toneDetector configuration option. To change the default position of the tone detector relative to the Grammarly button, use the tonePosition configuration option.
Note that Grammarly's writing suggestions may sometimes include improvements to the tone of specific text. Navigate to the Delivery category in the demo and click on Tone for an example. Writing suggestions about tone are entirely independent of the tone detector feature.