---
layout: docs
page_title: roles add-grants - Command
description: |-
The "roles add-grants" command lets you add grants to a role.
---
# roles add-grants
Command: `roles add-grants`
The `roles add-grants` command lets you add grants to a role.
You can specify multiple grants per role.
## Example
This example adds a grant which permits read permissions to a role with the ID `r_1234567890`:
```shell-session
$ boundary roles add-grants -id r_1234567890 -grant "id=*;type=*;actions=read"
```
## Usage
```shell-session
$ boundary roles add-grants [options] [args]
```
### Command options
- `-grant=` - The grants you want to add.
You can specify grants in compact string format or JSON.
If you use JSON, be sure to escape it properly.
You can optionally specify multiple grants.
- `-id=` - The ID of the role you want to add grants to.
- `-version=` The version of the role to add grants to.
If you do not specify a version, the command performs a check-and-set automatically.
@include 'cmd-option-note.mdx'