ℹ️ Skipped - page is already crawled
| Filter | Status | Condition | Details |
|---|---|---|---|
| HTTP status | PASS | download_http_code = 200 | HTTP 200 |
| Age cutoff | PASS | download_stamp > now() - 6 MONTH | 4.3 months ago (distributed domain, exempt) |
| History drop | PASS | isNull(history_drop_reason) | No drop reason |
| Spam/ban | PASS | fh_dont_index != 1 AND ml_spam_score = 0 | ml_spam_score=0 |
| Canonical | PASS | meta_canonical IS NULL OR = '' OR = src_unparsed | Not set |
| Property | Value |
|---|---|
| URL | https://developers.google.com/tech-writing/one/active-voice |
| Last Crawled | 2025-12-03 05:08:01 (4 months ago) |
| First Indexed | not set |
| HTTP Status Code | 200 |
| Meta Title | Active voice vs. passive voice | Technical Writing | Google for Developers |
| Meta Description | null |
| Meta Canonical | null |
| Boilerpipe Text | outlined_flag This unit teaches you to distinguish between active and passive voice and convert passive to active for clearer technical writing. Active voice sentences follow the structure: actor + verb + target, while passive voice reverses it or omits the actor. Passive verbs typically use a form of "be" + past participle verb and often include a preposition after the verb. Active voice is generally preferred as it's clearer, more direct, and often shorter than passive voice. Although sometimes used in scientific reports, active voice is encouraged for better clarity even in research writing. The vast majority of sentences in technical writing should be
in active voice. This unit teaches you how to do the following: Distinguish passive voice from active voice. Convert passive voice to active voice because active voice
is usually clearer. First, watch this video, just to get the ball
rolling 1 : Distinguish active voice from passive voice in simple sentences In an active voice sentence, an actor acts on a target. That is,
an active voice sentence follows this formula: Active Voice Sentence = actor + verb + target A passive voice sentence reverses the formula. That is, a passive
voice sentence typically follows the following formula: Passive Voice Sentence = target + verb + actor Active voice example For example, here’s a short, active voice sentence: The cat sat on the mat. Actor: The cat Verb: sat Target: the mat Passive voice examples By contrast, here's that same sentence in passive voice: The mat was sat on by the cat. Target: The mat Passive verb: was sat Actor: the cat Some passive voice sentences omit an actor. For example: The mat was sat on. Actor: unknown Passive verb: was sat Target: the mat Who or what sat on the mat? A cat? A dog? A T-Rex? Readers can only guess.
Good sentences in technical documentation identify who is doing what to whom. Recognize passive verbs Passive verbs typically have the following formula: passive verb = form of be + past participle verb
Although the preceding formula looks daunting, it is actually pretty simple: A form of be in a passive verb is typically one of the
following words:
A past participle verb is typically a plain verb plus the suffix
ed . For example, the following are past participle verbs:
interpreted generated formed Unfortunately, some past participle verbs are irregular; that is, the past
participle form doesn't end with the suffix ed . For example: Putting the form of be and the past participle together yields passive
verbs, such as the following: was interpreted is generated was formed is frozen If the phrase contains an actor, a preposition ordinarily follows the
passive verb. (That preposition is often a key clue to help you spot
passive voice.) The following examples combine the passive verb and
the preposition: was interpreted as is generated by was formed by is frozen by Imperative verbs are typically active It is easy to mistakenly classify sentences starting with an imperative
verb as passive. An imperative verb is a command. Many items in
numbered lists start with imperative verbs. For example, Open and
Set in the following list are both imperative verbs: Open the configuration file. Set the Frombus variable to False . Sentences that start with an imperative verb are typically in active voice,
even though they don't explicitly mention an actor. Instead, sentences
that start with an imperative verb imply an actor. The implied actor
is you . Exercise Mark each of the following sentences as either Passive or Active : MutableInput provides read-only access. Read-only access is provided by MutableInput . Performance was measured. Python was invented by Guido van Rossum in the twentieth century. David Korn discovered the KornShell quite by accident. This information is used by the policy enforcement team. Click the Submit button. The orbit was calculated by Katherine Johnson. Active . MutableInput provides read-only access. Passive . Read-only access is provided by MutableInput. Passive . Performance was measured. Passive . Python was invented by Guido van Rossum in the twentieth
century. Active . David Korn discovered the KornShell quite by accident. Passive . This information is used by the policy
enforcement team. Active . Click the Submit button.
( Click is an imperative verb.) Passive . The orbit was calculated by Katherine Johnson. Distinguish active voice from passive voice in more complex sentences Many sentences contain multiple verbs, some of which are active and
some of which are passive. For example, the following sentence
contains two verbs, both of which are in passive voice: Here is that same sentence, partially converted to active voice: And here is that same sentence, now fully converted to active voice: Exercise Each of the following sentences contains two verbs.
Categorize each of the verbs in the following sentences as either
active or passive. For example, if the first verb is active and
the second is passive, write Active, Passive . The QA team loves ice cream, but the writers prefer sorbet. Performance metrics are required by the team, though I prefer wild guesses. When software engineers attempt something new and innovative, a reward
should be given. Active, Active. The QA team loves ice cream, but the writers
prefer sorbet. Passive, Active. Performance metrics are required by the team,
though I prefer wild guesses. Active, Passive. When software engineers attempt something new
and innovative, a reward should be given. Prefer active voice to passive voice Use the active voice most of the time. Use the passive voice sparingly.
Active voice provides the following advantages: Most readers mentally convert passive voice to active voice.
Why subject your readers to extra processing time? By sticking to
active voice, you enable readers to skip the preprocessor stage and go
straight to compilation. Passive voice obfuscates your ideas, turning sentences on their head.
Passive voice reports action indirectly. Some passive voice sentences omit an actor altogether, which forces
the reader to guess the actor's identity. Active voice is generally shorter than passive voice. Be bold—be active. Scientific research reports (optional material) Passive voice runs rampant through certain scientific research reports.
In those research reports, experimenters and their equipment often
disappear, leading to passive sentences that start off as follows: It has been suggested that... Data was taken... Statistics were calculated... Results were evaluated. Do we know who is doing what to whom? No. Does the passive voice
somehow make the information more objective? No. Many scientific journals have embraced active voice. We encourage
the remainder to join the quest for clarity. Exercise Rewrite the following passive voice sentences as active voice. Only part of
certain sentences are in passive voice; ensure that all parts end up as active
voice: The flags weren't parsed by the Mungifier. A wrapper is generated by the Op registration process. Only one experiment per layer is selected by the Frombus system. Quality metrics are identified by asterisks; ampersands identify bad
metrics. The Mungifier didn't parse the flags. The Op registration process generates a wrapper. The Frombus system selects only one experiment per layer. Asterisks identify quality metrics; ampersands identify bad metrics. Next unit: Clear sentences 1. "Get the ball rolling" is an idiom that
means "to get something started." ↩ |
| Markdown | [Skip to main content](https://developers.google.com/tech-writing/one/active-voice#main-content)
[](https://developers.google.com/tech-writing)
- [Technical Writing](https://developers.google.com/tech-writing)
[For Students](https://developers.google.com/tech-writing/overview)
More
[For Facilitators](https://developers.google.com/tech-writing/for-instructors)
[Doc Resources](https://developers.google.com/tech-writing/resources)
[The Profession](https://developers.google.com/tech-writing/becoming)
[Announcements](https://developers.google.com/tech-writing/announcements)
- [English](https://developers.google.com/tech-writing/one/active-voice)
- [Deutsch](https://developers.google.com/tech-writing/one/active-voice?hl=de)
- [Español](https://developers.google.com/tech-writing/one/active-voice?hl=es)
- [Français](https://developers.google.com/tech-writing/one/active-voice?hl=fr)
- [Indonesia](https://developers.google.com/tech-writing/one/active-voice?hl=id)
- [Português – Brasil](https://developers.google.com/tech-writing/one/active-voice?hl=pt-br)
- [Русский](https://developers.google.com/tech-writing/one/active-voice?hl=ru)
- [中文 – 简体](https://developers.google.com/tech-writing/one/active-voice?hl=zh-cn)
- [日本語](https://developers.google.com/tech-writing/one/active-voice?hl=ja)
- [한국어](https://developers.google.com/tech-writing/one/active-voice?hl=ko)
[Sign in](https://developers.google.com/_d/signin?continue=https%3A%2F%2Fdevelopers.google.com%2Ftech-writing%2Fone%2Factive-voice&prompt=select_account)
- [For Students](https://developers.google.com/tech-writing/overview)
[Overview](https://developers.google.com/tech-writing/overview)
[Technical Writing One](https://developers.google.com/tech-writing/one)
[Technical Writing Two](https://developers.google.com/tech-writing/two)
[Accessibility](https://developers.google.com/tech-writing/accessibility)
[Error Messages](https://developers.google.com/tech-writing/error-messages)
More
[](https://developers.google.com/tech-writing)
- [Technical Writing](https://developers.google.com/tech-writing)
- [For Students](https://developers.google.com/tech-writing/overview)
- [Overview](https://developers.google.com/tech-writing/overview)
- [Technical Writing One](https://developers.google.com/tech-writing/one)
- [Technical Writing Two](https://developers.google.com/tech-writing/two)
- [Accessibility](https://developers.google.com/tech-writing/accessibility)
- [Error Messages](https://developers.google.com/tech-writing/error-messages)
- [For Facilitators](https://developers.google.com/tech-writing/for-instructors)
- [Doc Resources](https://developers.google.com/tech-writing/resources)
- [The Profession](https://developers.google.com/tech-writing/becoming)
- [Announcements](https://developers.google.com/tech-writing/announcements)
- Pre-Class material
- [Introduction (3 min)](https://developers.google.com/tech-writing/one)
- [Just enough grammar (optional) (10 min)](https://developers.google.com/tech-writing/one/just-enough-grammar)
- [Words (10 min)](https://developers.google.com/tech-writing/one/words)
- [Active voice (15 min)](https://developers.google.com/tech-writing/one/active-voice)
- [Clear sentences (10 min)](https://developers.google.com/tech-writing/one/clear-sentences)
- [Short sentences (20 min)](https://developers.google.com/tech-writing/one/short-sentences)
- [Lists and tables (15 min)](https://developers.google.com/tech-writing/one/lists-and-tables)
- [Paragraphs (10 min)](https://developers.google.com/tech-writing/one/paragraphs)
- [Audience (10 min)](https://developers.google.com/tech-writing/one/audience)
- [Documents (10 min)](https://developers.google.com/tech-writing/one/documents)
- [Punctuation (optional) (5 min)](https://developers.google.com/tech-writing/one/punctuation)
- [Markdown (optional)](https://developers.google.com/tech-writing/one/markdown)
- [Summary (1 min)](https://developers.google.com/tech-writing/one/summary)
- On this page
- [Distinguish active voice from passive voice in simple sentences](https://developers.google.com/tech-writing/one/active-voice#distinguish_active_voice_from_passive_voice_in_simple_sentences)
- [Active voice example](https://developers.google.com/tech-writing/one/active-voice#active_voice_example)
- [Passive voice examples](https://developers.google.com/tech-writing/one/active-voice#passive_voice_examples)
- [Recognize passive verbs](https://developers.google.com/tech-writing/one/active-voice#recognize_passive_verbs)
- [Imperative verbs are typically active](https://developers.google.com/tech-writing/one/active-voice#imperative_verbs_are_typically_active)
- [Exercise](https://developers.google.com/tech-writing/one/active-voice#exercise)
- [Distinguish active voice from passive voice in more complex sentences](https://developers.google.com/tech-writing/one/active-voice#distinguish_active_voice_from_passive_voice_in_more_complex_sentences)
- [Exercise](https://developers.google.com/tech-writing/one/active-voice#exercise_1)
- [Prefer active voice to passive voice](https://developers.google.com/tech-writing/one/active-voice#prefer_active_voice_to_passive_voice)
- [Scientific research reports (optional material)](https://developers.google.com/tech-writing/one/active-voice#scientific_research_reports_optional_material)
- [Exercise](https://developers.google.com/tech-writing/one/active-voice#exercise_2)
- [Home](https://developers.google.com/)
- [Technical Writing](https://developers.google.com/tech-writing)
- [For Students](https://developers.google.com/tech-writing/overview)
- [Technical Writing One](https://developers.google.com/tech-writing/one)
Was this helpful?
Send feedback
# Active voice vs. passive voicebookmark\_borderbookmark Stay organized with collections Save and categorize content based on your preferences. content\_copy
- On this page
- [Distinguish active voice from passive voice in simple sentences](https://developers.google.com/tech-writing/one/active-voice#distinguish_active_voice_from_passive_voice_in_simple_sentences)
- [Active voice example](https://developers.google.com/tech-writing/one/active-voice#active_voice_example)
- [Passive voice examples](https://developers.google.com/tech-writing/one/active-voice#passive_voice_examples)
- [Recognize passive verbs](https://developers.google.com/tech-writing/one/active-voice#recognize_passive_verbs)
- [Imperative verbs are typically active](https://developers.google.com/tech-writing/one/active-voice#imperative_verbs_are_typically_active)
- [Exercise](https://developers.google.com/tech-writing/one/active-voice#exercise)
- [Distinguish active voice from passive voice in more complex sentences](https://developers.google.com/tech-writing/one/active-voice#distinguish_active_voice_from_passive_voice_in_more_complex_sentences)
- [Exercise](https://developers.google.com/tech-writing/one/active-voice#exercise_1)
- [Prefer active voice to passive voice](https://developers.google.com/tech-writing/one/active-voice#prefer_active_voice_to_passive_voice)
- [Scientific research reports (optional material)](https://developers.google.com/tech-writing/one/active-voice#scientific_research_reports_optional_material)
- [Exercise](https://developers.google.com/tech-writing/one/active-voice#exercise_2)

## AI-generated Key Takeaways
outlined\_flag
- This unit teaches you to distinguish between active and passive voice and convert passive to active for clearer technical writing.
- Active voice sentences follow the structure: actor + verb + target, while passive voice reverses it or omits the actor.
- Passive verbs typically use a form of "be" + past participle verb and often include a preposition after the verb.
- Active voice is generally preferred as it's clearer, more direct, and often shorter than passive voice.
- Although sometimes used in scientific reports, active voice is encouraged for better clarity even in research writing.
**Estimated Time:** 15 minutes
The vast majority of sentences in technical writing should be in active voice. This unit teaches you how to do the following:
- Distinguish passive voice from active voice.
- Convert passive voice to active voice because active voice is usually clearer.
First, watch this video, just to get the ball rolling[1](https://developers.google.com/tech-writing/one/active-voice#Footnote1):
## Distinguish active voice from passive voice in simple sentences
In an active voice sentence, an actor acts on a target. That is, an active voice sentence follows this formula:
> Active Voice Sentence = actor + verb + target
A passive voice sentence reverses the formula. That is, a passive voice sentence typically follows the following formula:
> Passive Voice Sentence = target + verb + actor
### Active voice example
For example, here’s a short, active voice sentence:
> The cat sat on the mat.
- Actor: The cat
- Verb: sat
- Target: the mat
### Passive voice examples
By contrast, here's that same sentence in passive voice:
> The mat was sat on by the cat.
- Target: The mat
- Passive verb: was sat
- Actor: the cat
Some passive voice sentences omit an actor. For example:
> The mat was sat on.
- Actor: *unknown*
- Passive verb: was sat
- Target: the mat
Who or what sat on the mat? A cat? A dog? A T-Rex? Readers can only guess. Good sentences in technical documentation identify who is doing what to whom.
## Recognize passive verbs
Passive verbs typically have the following formula:
```
passive verb = form of be + past participle verb
```
Although the preceding formula looks daunting, it is actually pretty simple:
- A **form of *be*** in a passive verb is typically one of the following words:
- is/are
- was/were
- A **past participle verb** is typically a plain verb plus the suffix *ed*. For example, the following are past participle verbs:
- interpreted
- generated
- formed
Unfortunately, some past participle verbs are irregular; that is, the past participle form doesn't end with the suffix *ed*. For example:
- sat
- known
- frozen
Putting the form of *be* and the past participle together yields passive verbs, such as the following:
- was interpreted
- is generated
- was formed
- is frozen
If the phrase contains an actor, a preposition ordinarily follows the passive verb. (That preposition is often a key clue to help you spot passive voice.) The following examples combine the passive verb and the preposition:
- was interpreted as
- is generated by
- was formed by
- is frozen by
### Imperative verbs are typically active
It is easy to mistakenly classify sentences starting with an imperative verb as passive. An **imperative verb** is a command. Many items in numbered lists start with imperative verbs. For example, *Open* and *Set* in the following list are both imperative verbs:
1. Open the configuration file.
2. Set the `Frombus` variable to `False`.
Sentences that start with an imperative verb are typically in active voice, even though they don't explicitly mention an actor. Instead, sentences that start with an imperative verb *imply* an actor. The implied actor is **you**.
### Exercise
Mark each of the following sentences as either **Passive** or **Active**:
1. `MutableInput` provides read-only access.
2. Read-only access is provided by `MutableInput`.
3. Performance was measured.
4. Python was invented by Guido van Rossum in the twentieth century.
5. David Korn discovered the KornShell quite by accident.
6. This information is used by the policy enforcement team.
7. Click the Submit button.
8. The orbit was calculated by Katherine Johnson.
[Click the icon to see the answer.]()
1. **Active**. MutableInput provides read-only access.
2. **Passive**. Read-only access is provided by MutableInput.
3. **Passive**. Performance was measured.
4. **Passive**. Python was invented by Guido van Rossum in the twentieth century.
5. **Active**. David Korn discovered the KornShell quite by accident.
6. **Passive**. This information is used by the policy enforcement team.
7. **Active**. Click the Submit button. (*Click* is an imperative verb.)
8. **Passive**. The orbit was calculated by Katherine Johnson.
***
## Distinguish active voice from passive voice in more complex sentences
Many sentences contain multiple verbs, some of which are active and some of which are passive. For example, the following sentence contains two verbs, both of which are in passive voice:

Here is that same sentence, partially converted to active voice:

And here is that same sentence, now fully converted to active voice:

### Exercise
Each of the following sentences contains two verbs. Categorize each of the verbs in the following sentences as either active or passive. For example, if the first verb is active and the second is passive, write **Active, Passive**.
1. The QA team loves ice cream, but the writers prefer sorbet.
2. Performance metrics are required by the team, though I prefer wild guesses.
3. When software engineers attempt something new and innovative, a reward should be given.
[Click the icon to see the answer.]()
1. **Active, Active.** The QA team loves ice cream, but the writers prefer sorbet.
2. **Passive, Active.** Performance metrics are required by the team, though I prefer wild guesses.
3. **Active, Passive.** When software engineers attempt something new and innovative, a reward should be given.
## Prefer active voice to passive voice
Use the active voice most of the time. Use the passive voice sparingly. Active voice provides the following advantages:
- Most readers mentally convert passive voice to active voice. Why subject your readers to extra processing time? By sticking to active voice, you enable readers to skip the preprocessor stage and go straight to compilation.
- Passive voice obfuscates your ideas, turning sentences on their head. Passive voice reports action indirectly.
- Some passive voice sentences omit an actor altogether, which forces the reader to guess the actor's identity.
- Active voice is generally shorter than passive voice.
Be bold—be active.
### Scientific research reports (optional material)
Passive voice runs rampant through certain scientific research reports. In those research reports, experimenters and their equipment often disappear, leading to passive sentences that start off as follows:
- It has been suggested that...
- Data was taken...
- Statistics were calculated...
- Results were evaluated.
Do we know who is doing what to whom? No. Does the passive voice somehow make the information more objective? No.
Many scientific journals have embraced active voice. We encourage the remainder to join the quest for clarity.
### Exercise
Rewrite the following passive voice sentences as active voice. Only part of certain sentences are in passive voice; ensure that all parts end up as active voice:
1. The flags weren't parsed by the Mungifier.
2. A wrapper is generated by the Op registration process.
3. Only one experiment per layer is selected by the Frombus system.
4. Quality metrics are identified by asterisks; ampersands identify bad metrics.
[Click the icon to see the answer.]()
1. The Mungifier didn't parse the flags.
2. The Op registration process generates a wrapper.
3. The Frombus system selects only one experiment per layer.
4. Asterisks identify quality metrics; ampersands identify bad metrics.
**Next unit:** [Clear sentences](https://developers.google.com/tech-writing/one/clear-sentences)
1\. "Get the ball rolling" is an idiom that means "to get something started." [↩](https://developers.google.com/tech-writing/one/active-voice#ref1 "Jump back
to footnote 1 in the text.")
Was this helpful?
Send feedback
Except as otherwise noted, the content of this page is licensed under the [Creative Commons Attribution 4.0 License](https://creativecommons.org/licenses/by/4.0/), and code samples are licensed under the [Apache 2.0 License](https://www.apache.org/licenses/LICENSE-2.0). For details, see the [Google Developers Site Policies](https://developers.google.com/site-policies). Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-03-28 UTC.
Need to tell us more?
\[\[\["Easy to understand","easyToUnderstand","thumb-up"\],\["Solved my problem","solvedMyProblem","thumb-up"\],\["Other","otherUp","thumb-up"\]\],\[\["Missing the information I need","missingTheInformationINeed","thumb-down"\],\["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"\],\["Out of date","outOfDate","thumb-down"\],\["Samples / code issue","samplesCodeIssue","thumb-down"\],\["Other","otherDown","thumb-down"\]\],\["Last updated 2025-03-28 UTC."\],\[\],\["Technical writing should predominantly use active voice. Active voice follows the structure: actor + verb + target, while passive voice reverses this. Passive voice often includes a form of \\"be\\" + past participle, sometimes omitting the actor. Sentences with imperative verbs, like commands, are active and imply \\"you\\" as the actor. Converting passive sentences to active voice enhances clarity, reduces reader processing time, and often results in shorter sentences. Most of the time active voice should be preferred, except for some scientific reporting.\\n"\]\]
- ### Courses
- [Technical writing courses](https://developers.google.com/tech-writing/overview)
- [Facilitator guides](https://developers.google.com/tech-writing/for-instructors)
- ### Resources
- [Additional resources](https://developers.google.com/tech-writing/resources)
- ### The Profession
- [Becoming a technical writer](https://developers.google.com/tech-writing/becoming)
- [Meet some technical writers](https://developers.google.com/tech-writing/becoming/meet)
[](https://developers.google.com/)
- [Android](https://developer.android.com/)
- [Chrome](https://developer.chrome.com/home)
- [Firebase](https://firebase.google.com/)
- [Google Cloud Platform](https://cloud.google.com/)
- [Google AI](https://ai.google.dev/)
- [All products](https://developers.google.com/products)
- [Terms](https://developers.google.com/terms/site-terms)
- [Privacy](https://policies.google.com/privacy)
- [Manage cookies](https://developers.google.com/tech-writing/one/active-voice)
- [English](https://developers.google.com/tech-writing/one/active-voice)
- [Deutsch](https://developers.google.com/tech-writing/one/active-voice?hl=de)
- [Español](https://developers.google.com/tech-writing/one/active-voice?hl=es)
- [Français](https://developers.google.com/tech-writing/one/active-voice?hl=fr)
- [Indonesia](https://developers.google.com/tech-writing/one/active-voice?hl=id)
- [Português – Brasil](https://developers.google.com/tech-writing/one/active-voice?hl=pt-br)
- [Русский](https://developers.google.com/tech-writing/one/active-voice?hl=ru)
- [中文 – 简体](https://developers.google.com/tech-writing/one/active-voice?hl=zh-cn)
- [日本語](https://developers.google.com/tech-writing/one/active-voice?hl=ja)
- [한국어](https://developers.google.com/tech-writing/one/active-voice?hl=ko)
Info
Chat
API |
| Readable Markdown | null |
| Shard | 95 (laksa) |
| Root Hash | 744624608793826895 |
| Unparsed URL | com,google!developers,/tech-writing/one/active-voice s443 |