db.dropAllUsers()
Definition
db.dropAllUsers(writeConcern)
Removes all users from the current database.
Important
mongosh Method
This page documents a
mongosh
method. This is not the documentation for database commands or language-specific drivers, such as Node.js.For the database command, see the
dropAllUsersFromDatabase
command.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:FieldTypeDescriptionwriteConcern
documentOptional. The level of write concern for the operation. See Write Concern Specification.
The
db.dropAllUsers()
method wraps thedropAllUsersFromDatabase
command.
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 }