Bulk.find.delete.txt

==================
Bulk.find.delete()
==================

.. default-domain:: mongodb

.. contents:: On this page
   :local:
   :backlinks: none
   :depth: 1
   :class: singlecol

Definition
-----------

.. method:: Bulk.find.delete()

   Adds a multiple document delete operation to a bulk operations list.
   Use the :method:`Bulk.find()` method to specify the condition that
   determines which documents to remove. 
   
   ``Bulk.find.delete()`` deletes all matching documents. To remove the
   first matching document, see :method:`Bulk.find.deleteOne()`.

Compatibility
-------------

This command is available in deployments hosted in the following
environments: 

.. include:: /includes/fact-environments-atlas-only.rst

.. include:: /includes/fact-environments-atlas-support-all.rst

Syntax
------

The command has the following syntax:

.. code-block:: javascript

   Bulk.find( <filter document> ).delete()

For details on the ``find()`` method see: :method:`Bulk.find()`

Example
-------

Create the ``music`` collection:

.. code-block:: javascript

   db.music.insertMany( [
      { artist: "DOA", genre: "punk" },
      { artist: "Rick Astley", genre: "pop" },
      { artist: "Black Flag", genre: "punk" },
      { artist: "Justin Bieber", genre: "pop" }
   ] )

The following example:

- Initializes a :method:`Bulk()` operations builder.
- Searches for the genre ``pop``.
- Deletes ``pop`` music from the collection. 

.. code-block:: javascript

   var bulk = db.music.initializeOrderedBulkOp();
   bulk.find( { "genre": "pop" } ).delete();
   bulk.execute()

To delete only the first matching document, use
:method:`Bulk.find.deleteOne()` instead.