Docs Menu
Docs Home
/
MongoDB Shell
/

Delete Documents

On this page

  • Delete All Documents
  • Delete All Documents that Match a Condition
  • Delete Only One Document that Matches a Condition
  • Delete Behavior
  • Learn More

The MongoDB shell provides the following methods to delete documents from a collection:

The examples on this page reference the Atlas sample dataset. You can create a free Atlas cluster and populate that cluster with sample data to follow along with these examples. To learn more, see Get Started with Atlas.

To delete all documents from a collection, pass an empty filter document {} to the db.collection.deleteMany() method.

Example

To delete all documents from the sample_mflix.movies collection:

use sample_mflix
db.movies.deleteMany({})

The method returns a document with the status of the operation. For more information and examples, see deleteMany().

Note

If you want to delete all documents from a large collection, dropping with the db.collection.drop() method. and recreating the collection may have faster performance than deleting documents with the db.collection.deleteMany() method. When you recreate the collection, you must also recreate any specified collection parameters such as collection indexes.

You can specify criteria, or filters, that identify the documents to delete. The filters use the same syntax as read operations.

To specify equality conditions, use <field>:<value> expressions in the query filter document.

To delete all documents that match a deletion criteria, pass a filter parameter to the deleteMany() method.

Example

To delete all documents from the sample_mflix.movies collection where the title equals "Titanic":

use sample_mflix
db.movies.deleteMany( { title: "Titanic" } )

The method returns a document with the status of the operation. For more information and examples, see deleteMany().

To delete at most a single document that matches a specified filter (even though multiple documents may match the specified filter) use the db.collection.deleteOne() method.

Example

To delete the first document from the sample_mflix.movies collection where the cast array contains "Brad Pitt":

use sample_mflix
db.movies.deleteOne( { cast: "Brad Pitt" } )

Note

MongoDB preserves a natural sort order for documents. This ordering is an internal implementation feature, and you should not rely on any particular structure within it. To learn more, see natural order.

To learn more about the specific behavior of deleting documents, see Behavior.

Back

Update