diff --git a/website/content/docs/commands/roles/add-grants.mdx b/website/content/docs/commands/roles/add-grants.mdx
index 2c18ae9080..023fdff64d 100644
--- a/website/content/docs/commands/roles/add-grants.mdx
+++ b/website/content/docs/commands/roles/add-grants.mdx
@@ -36,7 +36,10 @@ $ boundary roles add-grants [options] [args]
 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=<string>` - The ID of the role you want to add grants to.
+- `-ids=<string>` - The IDs of the roles you want to add grants to.
+You can specify one or more IDs.
+If you specify multiple IDs using text, use commas to separate the IDs.
+If you specify multiple IDs using JSON, use an array.
 - `-version=<int>` The version of the role to add grants to.
 If you do not specify a version, the command performs a check-and-set automatically.
 
diff --git a/website/content/docs/commands/roles/remove-grants.mdx b/website/content/docs/commands/roles/remove-grants.mdx
index 6c362c2711..db31ee3971 100644
--- a/website/content/docs/commands/roles/remove-grants.mdx
+++ b/website/content/docs/commands/roles/remove-grants.mdx
@@ -36,7 +36,10 @@ $ boundary roles remove-grants [options] [args]
 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=<string>` - The ID of the role you want to remove grants from.
+- `-ids=<string>` - The IDs of the roles you want to remove grants from.
+You can specify one or more IDs.
+If you specify multiple IDs using text, use commas to separate the IDs.
+If you specify multiple IDs using JSON, use an array.
 - `-version=<int>` - The version of the role you want to remove grants from.
 If you do not specify a version, the command performs a check-and-set automatically.
 
diff --git a/website/content/docs/commands/roles/set-grants.mdx b/website/content/docs/commands/roles/set-grants.mdx
index 82de90de80..6aac0212af 100644
--- a/website/content/docs/commands/roles/set-grants.mdx
+++ b/website/content/docs/commands/roles/set-grants.mdx
@@ -37,7 +37,10 @@ $ boundary roles set-grants [options] [args]
 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=<string>` - The ID of the role you want to set grants on.
+- `-ids=<string>` - The IDs of the roles you want to set grants on.
+You can specify one or more IDs.
+If you specify multiple IDs using text, use commas to separate the IDs.
+If you specify multiple IDs using JSON, use an array.
 - `-version=<int>` The version of the role to set grants on.
 If you do not specify a version, the command performs a check-and-set automatically.