Docs Home → Develop Applications → MongoDB Manual
db.grantPrivilegesToRole()![](/docs/v4.4/assets/link.svg)
On this page
Definition![](/docs/v4.4/assets/link.svg)
db.grantPrivilegesToRole(rolename, privileges, writeConcern)
Grants additional privileges to a user-defined role.
Important
mongo Shell Method
This page documents a
mongo
method. This is not the documentation for database commands or language-specific drivers, such as Node.js. To use the database command, see thegrantPrivilegesToRole
command.For MongoDB API drivers, refer to the language-specific MongoDB driver documentation.
The
db.grantPrivilegesToRole()
method uses the following syntax:db.grantPrivilegesToRole( "< rolename >", [ { resource: { <resource> }, actions: [ "<action>", ... ] }, ... ], { < writeConcern > } ) The
db.grantPrivilegesToRole()
method takes the following arguments:ParameterTypeDescriptionrolename
stringThe name of the role to grant privileges to.privileges
arrayThe privileges to add to the role. For the format of a privilege, seeprivileges
.writeConcern
documentOptional. The level of write concern for the modification. ThewriteConcern
document takes the same fields as thegetLastError
command.The
db.grantPrivilegesToRole()
method can grant one or more privileges. Each<privilege>
has the following syntax:{ resource: { <resource> }, actions: [ "<action>", ... ] }
Behavior![](/docs/v4.4/assets/link.svg)
Replica set![](/docs/v4.4/assets/link.svg)
If run on a replica set, db.grantPrivilegesToRole()
is executed using
"majority"
write concern by default.
Scope![](/docs/v4.4/assets/link.svg)
Except for roles created in the admin
database, a role can only
include privileges that apply to 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.
Required Access![](/docs/v4.4/assets/link.svg)
You must have the grantRole
action on the database a privilege targets in order to
grant the privilege. To grant a privilege on multiple databases or on the
cluster
resource, you must have the grantRole
action on
the admin
database.
Example![](/docs/v4.4/assets/link.svg)
The following db.grantPrivilegesToRole()
operation grants two
additional privileges to the role inventoryCntrl01
, which exists on the
products
database. The operation is run on that database:
use products db.grantPrivilegesToRole( "inventoryCntrl01", [ { resource: { db: "products", collection: "" }, actions: [ "insert" ] }, { resource: { db: "products", collection: "system.js" }, actions: [ "find" ] } ], { w: "majority" } )
The first privilege permits users with this role to perform the
insert
action on all collections of
the products
database, except the system collections. To access a system collection, a
privilege must explicitly specify the system collection in the resource
document, as in the second privilege.
The second privilege permits users with this role to perform the
find
action on the
product
database's system collection named system.js
.