• Reference >
• mongo Shell Methods >
• User Management Methods >
• db.dropUser()

db.dropUser()

Definition

db.dropUser(username, writeConcern)

Removes the user from the current database.

The db.dropUser() method takes the following arguments:

Parameter	Type	Description
username	string	The name of the user to remove from the database.
writeConcern	document	Optional. The level of write concern for the removal operation. The writeConcern document takes the same fields as the getLastError command.

The db.dropUser() method wraps the dropUser command.

Before dropping a user who has the userAdminAnyDatabase role, ensure you have at least another user with user administration privileges.

Behavior

Replica set

If run on a replica set, db.dropUser() 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.dropUser() operation drops the reportUser1 user on the products database.

copy

use products
db.dropUser("reportUser1", {w: "majority", wtimeout: 5000})

←   db.createUser() db.dropAllUsers()  →

© MongoDB, Inc 2008-present. MongoDB, Mongo, and the leaf logo are registered trademarks of MongoDB, Inc.