dropUser (Drop User)
Last updated: 2026-10-09
dropUser (Drop User)
dropUser deletes a user from the database. The user can no longer authenticate immediately, and the action is irreversible (recreate with createUser). In mongosh call db.dropUser('username'). Confirm the user is no longer needed first. Requires userAdmin or root.
| Category | User Authentication |
|---|---|
| MongoDB Version | 1.0+ |
| Example Language | mongosh (Shell) |
📝 Syntax
db.dropUser("<username>")
db.runCommand({ dropUser: "<username>" })⚙️ Parameters
| user | The username to remove |
|---|
Returns：Returns { ok: 1 } on success
▶ Example
Run the commands below in your local mongosh (requires a running mongod):
// dropUser: delete a user
use admin
db.dropUser('reader')Output：
{ ok: 1 }📌 Notes
- Irreversible — confirm before dropping
- Existing authenticated connections keep working; new logins fail
- Requires userAdmin or root
🏷️ Related Tags
💡 Related Cases
More hands-on cases coming soon.
📚 Related Tutorials
❓ FAQ
QDo existing connections survive dropping a user?
AAlready-authenticated connections keep working; new logins fail.
QCan a dropped user be restored?
ANo — recreate the user with createUser.
QWhat privileges does this need?
AuserAdmin on the database, or root.
