Definition
db.dropAllUsers(writeConcern)Removes all users from the current database.
Important
mongosh Method
This page documents a
mongoshmethod. This is not the documentation for database commands or language-specific drivers, such as Node.js.For the database command, see the
dropAllUsersFromDatabasecommand.For MongoDB API drivers, refer to the language-specific MongoDB driver documentation.
Warning
The
db.dropAllUsers()method removes all users from the database.The
db.dropAllUsers()method takes the following arguments:Field Type Description writeConcerndocument
Optional. The level of write concern for the operation. See Write Concern Specification.
The
db.dropAllUsers()method wraps thedropAllUsersFromDatabasecommand.
Compatibility
This method is available in deployments hosted in the following environments:
Important
This command is not supported in MongoDB Atlas clusters. For information on Atlas support for all commands, see Unsupported Commands.
- MongoDB Enterprise: The subscription-based, self-managed version of MongoDB
- MongoDB Community: The source-available, free-to-use, and self-managed version of MongoDB
Behavior
Replica set
If run on a replica set, db.dropAllUsers() is executed using "majority" write concern by default.
Required Access
You must have the dropUser action on a database to drop a user from that database.
Example
The following db.dropAllUsers() operation drops every user from the products database.
use products
db.dropAllUsers( {w: "majority", wtimeout: 5000} )The n field in the results document shows the number of users removed:
{ "n" : 12, "ok" : 1 }