read  source  history 

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


Updates the first document in a collection that meets the filter criteria.
More information can be found in the corresponding entry of the [[https://docs.mongodb.com/manual/reference/method/db.collection.updateOne/index.html|MongoDB Manual]].


[[[@cG

<collection>.updateOne(<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.updateOne({ salary: { $gt: 700000 }}, { $set: { bonus: 50000 }});

]]]

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



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