read  source  history 

= update() =
----
[[MongoDB Driver Function Reference]]

Updates all documents in a collection that meet the filter criteria.

//There is no difference in usage and behavior between the update() and updateMany() functions. These functions can be considered synonyms.//


[[[@cG

db.<collection>.update(<filter>, <update>[, <options>])

]]]


**Arguments**

[[[@w

|@t0@r0@c0 <collection> | | The target collection |
| <filter> | | A filter expression using [[https://docs.mongodb.com/manual/reference/operator/|query operators]] |
| <update> | | A BSON document containing the modifications to apply |
| <options> | | A BOSN document specifying options |

]]]


**Options**

[[[@cw

{ upsert: <boolean>, arrayFilters: [<document>], collation: <document>, hint: <document>, }
<<@f:text>>
|@t0@r0@c0 upsert | | Specifies if a document should be created if no document matches (default: false) |
| arrayFilters | | An array of filter documents that determine which array elements to modify for an update operation on an array field. |
| collation | | A document specifying the [[https://docs.mongodb.com/manual/reference/bson-type-comparison-order/#collation|collation]] |
| hint | | A document specifying a [[https://docs.mongodb.com/manual/reference/method/db.collection.deleteMany/#ex-deletemany-hint|hint]] |
<<@/f>>
]]]


**Example**

[[[@cw

db.employees.update({ salary: { $gt: 700000 }}, { $set: { bonus: 50000 }});

]]]

Sets the bonus in all documents from the employee collection with a salary greater than 700000 to 50000.



----
[[Main|home]] | [[MongoDB Driver Function Reference]] | [[MongoDB Driver]]