$pullAll (Remove All Given Values)
Last updated: 2026-10-09
$pullAll (Remove All Given Values)
$pullAll removes from an array every element equal to any value in the given list. `{ $pullAll: { tags: ['spam', 'ads'] } }`. Unlike $pull, $pullAll supports equality matching only — no conditions — but accepts many values at once, while $pull supports conditions (use $in inside $pull for multi-value).
| Category | Update Array |
|---|---|
| MongoDB Version | 1.0+ |
| Example Language | mongosh (Shell) |
📝 Syntax
{ $pullAll: { <array field>: [ <value1>, <value2>, ... ] } }⚙️ Parameters
| array field | The array field to clean. |
|---|---|
| values list | The values to remove; equality match only. |
Returns：The update result
▶ Example
Run the commands below in your local mongosh (requires a running mongod):
// $pullAll: remove several tags at once
// Equality match only
db.articles.updateOne(
{ _id: 1 },
{ $pullAll: { tags: ['spam', 'ads'] } }
)Output：
// Every spam and ads entry is removed from tags📌 Notes
- Equality matching only; no conditions
- Accepts many values at once, complementing $pull
- Values not present are silently ignored
🏷️ Related Tags
💡 Related Cases
More hands-on cases coming soon.
📚 Related Tutorials
❓ FAQ
QWhat is the difference between $pullAll and $pull?
A$pullAll removes many exact values; $pull supports conditions one at a time (use $in for many).
QDoes $pullAll support conditions?
ANo, equality match only.
QHow do I remove several values at once?
A$pullAll: { tags: ['a', 'b'] }.
