Docs Menu

Docs HomeMongoDB Manual

dropAllUsersFromDatabase

On this page

  • Definition
  • Required Access
  • Example
dropAllUsersFromDatabase

Removes all users from the database on which you run the command.

Warning

The dropAllUsersFromDatabase removes all users from the database.

The dropAllUsersFromDatabase command has the following syntax:

{ dropAllUsersFromDatabase: 1,
writeConcern: { <write concern> },
comment: <any>
}

The dropAllUsersFromDatabase document has the following fields:

Field
Type
Description
dropAllUsersFromDatabase
integer
Specify 1 to drop all the users from the current database.
writeConcern
document

Optional. The level of write concern for the operation. See Write Concern Specification.

comment
any

Optional. A user-provided comment to attach to this command. Once set, this comment appears alongside records of this command in the following locations:

A comment can be any valid BSON type (string, integer, object, array, etc).

New in version 4.4.

You must have the dropUser action on a database to drop a user from that database.

The following sequence of operations in mongosh drops every user from the products database:

use products
db.runCommand( { dropAllUsersFromDatabase: 1, writeConcern: { w: "majority" } } )

The n field in the results document shows the number of users removed:

{ "n" : 12, "ok" : 1 }
←  createUserdropUser →