Docs Menu

Docs HomeDevelop ApplicationsMongoDB Manual


On this page

  • Definition
  • Behavior


mongosh Method

This is a mongosh method. This is not the documentation for Node.js or other programming language specific driver methods.

In most cases, mongosh methods work the same way as the legacy mongo shell methods. However, some legacy methods are unavailable in mongosh.

For the legacy mongo shell documentation, refer to the documentation for the corresponding MongoDB Server release:

For MongoDB API drivers, refer to the language specific MongoDB driver documentation.

Drops the specified index or indexes (except the index on the _id field) from a collection.

You can use the method to:

  • Drop all but the _id index from a collection.

  • Drop a specified index from a collection. To specify the index, you can pass the method either:

    • The index specification document (unless the index is a text index in which case, use the index name to drop):

      db.collection.dropIndexes( { a: 1, b: 1 } )
    • The index name:

      db.collection.dropIndexes( "a_1_b_1" )


      To get the names of the indexes, use the db.collection.getIndexes() method.

  • Drop specified indexes from a collection. (Available starting in MongoDB 4.2). To specify multiple indexes to drop, pass the method an array of index names:

    db.collection.dropIndexes( [ "a_1_b_1", "a_1", "a_1__id_-1" ] )

    If the array of index names includes a non-existent index, the method errors without dropping any of the specified indexes.


    To get the names of the indexes, use the db.collection.getIndexes() method.

The db.collection.dropIndexes() method takes the following optional parameter:

string or document or array of strings

Optional. Specifies the index or indexes to drop.

To drop all but the _id index from the collection, omit the parameter.

To drop a single index, specify either the index name, the index specification document (unless the index is a text index), or an array of the index name. To drop a text index, specify the index name or an array of the index name instead of the index specification document.

To drop multiple indexes (Available starting in MongoDB 4.2), specify an array of the index names.

The db.collection.dropIndexes() is a wrapper around the dropIndexes command.

The db.collection.dropIndexes() command cannot drop ready indexes if there are any in-progress index builds.

  • In versions 4.4.0-4.4.4 of MongoDB, this logic was not true due to a bug.

Starting in MongoDB 4.2, the dropIndexes() operation only kills queries that are using the index being dropped. This may include queries considering the index as part of query planning.

Prior to MongoDB 4.2, dropping an index on a collection would kill all open queries on the collection.

Changed in version 4.2.

db.collection.dropIndexes() obtains an exclusive lock on the specified collection for the duration of the operation. All subsequent operations on the collection must wait until db.collection.dropIndexes() releases the lock.

Prior to MongoDB 4.2, db.collection.dropIndexes() obtained an exclusive lock on the parent database, blocking all operations on the database and all its collections until the operation completed.

If the method is passed an array of index names that includes a non-existent index, the method errors without dropping any of the specified indexes.

You cannot drop the default index on the _id field.

To drop a text index, specify the index name instead of the index specification document.

New in version 4.4: If an index specified to db.collection.dropIndexes() is still building, dropIndexes() attempts to abort the in-progress build. Aborting an index build has the same effect as dropping the built index. Prior to MongoDB 4.4, dropIndexes() would return an error if the collection had any in-progress index builds.

For replica sets, run dropIndexes() on the primary. The primary aborts the index build and creates an associated "abortIndexBuild" oplog entry. Secondaries which replicate the "abortIndexBuild" oplog entry abort the in-progress index build and discard the build job. See Index Build Process for detailed documentation on the index build process and the specific timing for terminating an in-progress index build.

The indexes specified to dropIndexes() must be the entire set of in-progress builds associated to a single createIndexes or db.collection.createIndexes() operation. To drop a specific index out of a set of related in-progress builds, wait until the index builds complete and specify that index to dropIndexes()

For example, a createIndexes / createIndexes() operation creates three indexes. Assuming all three index builds are in-progress, dropIndexes() must specify all three indexes to abort the index builds and drop the indexes.

Use currentOp to identify the index builds associated to a createIndexes / createIndexes() operation. See Active Indexing Operations for an example.

Starting in version 4.4, MongoDB adds the ability to hide or unhide indexes from the query planner. By hiding an index from the planner, users can evaluate the potential impact of dropping an index without actually dropping the index.

If after the evaluation, the user decides to drop the index, the user can drop the hidden index; i.e. you do not need to unhide it first to drop it.

If, however, the impact is negative, the user can unhide the index instead of having to recreate a dropped index. And because indexes are fully maintained while hidden, the indexes are immediately available for use once unhidden.

For more information on hidden indexes, see Hidden Indexes.

←  db.collection.dropIndex()db.collection.ensureIndex() →

On this page