Grammarly Passive Voice: What the Flag Means (2026)
November 11, 2026 · 9 min read
Grammarly Passive Voice: What the Flag Means and How to Check It
A Grammarly passive voice alert is a style suggestion, not a grammar error. It means the checker found a form of "be" plus a past participle and thinks an active sentence might read more clearly. This guide shows how that detection works, why it misfires, and how to check a draft in four tools.
What Grammarly's Passive Voice Misuse Alert Actually Means
Writers who ask about it online usually quote the alert as "passive voice misuse". The word "misuse" scares people into thinking they broke a rule. They didn't. Grammarly's own passive voice checker page says plainly that passive voice isn't a grammatical mistake.
A quick recap of the grammar: in a passive sentence, the subject receives the action instead of doing it. "The report was approved by the board" is passive. "The board approved the report" is active. Our guide to active vs passive voice covers the grammar in full.
In plain terms, the Grammarly passive voice misuse alert says: this sentence hides or delays the actor, so consider putting the actor first. Grammarly can't know whether you hid the actor on purpose. Only you can.
How Passive Voice Checkers Find a Passive Sentence
Pattern-based checkers hunt for one construction, which the UNC Writing Center sums up as a form of "to be" plus a past participle:
am / is / are / was / were / be / been / being
+ past participle (approved, written, made, sent)
+ optional "by" phrase naming the actor
Grammarly doesn't publish its exact rule. Its checker page says only that its AI analyzes your writing in real time. A simple passive voice finder, like the one in our readability checker, matches the pattern directly. Ours also counts "get" forms ("got fixed") and allows an adverb in between ("was quickly approved").
You can double-check any flag with a common rule of thumb: add "by zombies" after the verb. If the sentence still makes sense, it's passive.
The report was approved (by zombies). passive
Mistakes were made (by zombies). passive
She was tired (by zombies). not passive
Why Does Grammarly Flag Sentences That Are Grammatically Correct?
A well-formed passive sentence is grammatically correct, so the flag doesn't mean "wrong". The better question is whether the flag is even accurate. Any checker that leans on the be-plus-participle pattern makes two kinds of errors.
False positives happen when a past participle works as an adjective. "She was tired" and "Our team is interested in the results" match the pattern, but nobody did anything to anyone. "The store is closed on Sundays" describes a state, not an action.
Misses happen when the passive doesn't fit the pattern. An irregular participle that isn't on the tool's word list slips through. A passive built without "be" also escapes, as in "We had the API key rotated last week."
We ran these sentences through the same pattern our readability checker uses:
| Sentence | Pattern result | Actually passive? |
|---|---|---|
| The report was approved by the board. | Flagged | Yes |
| Mistakes were made. | Flagged | Yes, actor hidden |
| She was tired after the release. | Flagged | No, adjective |
| The store is closed on Sundays. | Flagged | No, a state |
| The server was shut down at midnight. | Missed | Yes |
| We had the API key rotated last week. | Missed | Yes, no "be" |
Every checker built on a pattern, Grammarly's included, has the same blind spots in some form. Treat every tool's count as an estimate.
How to Check for Passive Voice in Grammarly
Grammarly checks as you type in its editor, browser extension and desktop apps. Passive sentences get an underline and a suggestion card, and in the Grammarly Editor those cards sit on the right side of the screen. When the card offers an active rewrite, click Accept and Grammarly applies it to your text. Click Dismiss to keep your sentence.
Read every proposed rewrite before you accept it. An active sentence has to name an actor, and the wrong actor changes your meaning.
Two settings change how often the Grammarly passive voice card appears. As of November 2026, Grammarly's support docs say both need a Pro, Plus, Business or Education plan:
- Document domain. Under Goals in the Grammarly Editor, the Academic domain makes suggestions around passive voice, while Casual and Creative don't flag it.
- Turn off suggestions like this. Open More Actions on a passive voice card and pick that option to stop the alerts entirely.
How Do You Look for Passive Voice in Word and Hemingway?
Microsoft Word's Editor treats style checks as refinement rules that you switch on or off yourself. Microsoft's grammar and spelling help page gives this path:
- Open Editor on the Home tab.
- Select Grammar under Corrections, then Options.
- Set Writing Style to Grammar & Refinements and pick the rules you want.
Microsoft's page doesn't list the rules by name, so scan the list for a passive voice entry and tick it. The settings apply to every document you edit, not just the open one. Editor also needs an internet connection and Intelligent Services switched on (File > Options > General).
Hemingway takes a visual approach. It highlights passive voice in blue, as one of three "weakeners" alongside adverbs and qualifiers. It shows one combined weakener count, and View details splits out the passive voice number.
| Tool | How passive voice shows up |
|---|---|
| Grammarly | An underline and a suggestion card |
| Word Editor | A flag in the Editor pane, once the rule is on |
| Hemingway | A blue highlight inside the weakener count |
| Our readability checker | A sentence count and a dotted underline |
Checking Passive Voice in a Markdown Draft for Free
If you write in Markdown, pasting a README into Grammarly or Word drags along headings, link syntax and code. Our free readability checker strips Markdown syntax before it analyzes the prose. It runs in your browser.
To check passive voice there:
- Replace the sample text with your draft, Markdown and all. Ignore markdown syntax is on by default.
- Read the Passive voice (est.) figure, which counts the sentences that look passive.
- Scroll to the sentence view. Possible passive sentences carry a dotted underline, and hovering over one shows a "possible passive voice" note.
The same panel also reports readability scores. Know its limits, though: it's an English-only heuristic, it flags "She was tired" like any pattern matcher, and it doesn't rewrite anything. It points at sentences; you decide what happens to them.
Should You Fix Every Passive Voice Flag?
No. A checker only sees a pattern, so sort each flag before you touch the sentence:
| What the flag points at | Example | What to do |
|---|---|---|
| An adjective after "be" | She was tired after the release. | Dismiss it, since it isn't passive |
| A passive with an unknown or irrelevant actor | The server was restarted overnight. | Keep it |
| A passive where the result matters most, or your field expects it | The samples were stored at 4 degrees. | Keep it |
| A passive that hides who has to act | The config file must be edited. | Rewrite it |
We prefer active voice in setup steps and READMEs, because the reader needs to know who acts: them or the software. We don't aim for a percentage target. Fix the flags where a hidden actor would confuse the reader and leave the rest.
For the pages those sentences live in, our guide to writing documentation in Markdown covers structure and templates, and the Markdown style guide handles file-level conventions. Don't expect markdownlint to help here, since it checks Markdown syntax, not prose.
How to Rewrite a Flagged Sentence in Active Voice
No passive voice corrector can rewrite reliably on its own, because fixing a sentence means knowing who did what. Here's the three-step method we use instead:
- Find the actor. Look for the "by" phrase, or ask who performed the action.
- Make the actor the subject. Move it to the front of the sentence.
- Pick a direct verb. Drop the "be" form and use the main verb in its active tense.
Before: The release was delayed by a failing test.
After: A failing test delayed the release.
Before: The config file must be edited before you deploy.
After: Edit the config file before you deploy.
Before: Errors are logged to the console.
After: The app logs errors to the console.
The second example shows a trick for instructions: the actor is the reader, so the imperative ("Edit...") is the active version.
Grammarly Passive Voice Questions, Answered
A Grammarly passive voice flag is a prompt to look again, not a verdict. Check whether the sentence is really passive, then decide whether the hidden actor helps or hurts the reader. For Markdown drafts, paste your text into the free readability checker to see which sentences look passive. Then revise them in the Markdown editor, which runs in your browser with no account needed.