Docs Menu
Docs Home
MongoDB Manual
/ /

User-Defined Roles

On this page

  • Role Management Interface
  • Scope
  • Centralized Role Data

MongoDB provides a number of built-in roles. However, if these roles cannot describe the desired set of privileges, you can create new roles.


You can configure custom database roles in the UI for deployments hosted in MongoDB Atlas. To learn more, see Configure Custom Database Roles.

To add a role, MongoDB provides the db.createRole() method. MongoDB also provides methods to update existing user-defined roles. For a full list of role management methods, see Role Management.

When adding a role, you create the role in a specific database. MongoDB uses the combination of the database and the role name to uniquely define a role.

Except for roles created in the admin database, a role can only include privileges that apply to its database and can only inherit from other roles in its database.

A role created in the admin database can include privileges that apply to the admin database, other databases or to the cluster resource, and can inherit from roles in other databases as well as the admin database.

MongoDB stores all role information in the system.roles collection in the admin database

Do not access this collection directly but instead use the role management commands to view and edit custom roles.


Built-In Roles


Manage Users and Roles