diff --git a/doc/source/command-objects/role.rst b/doc/source/command-objects/role.rst
index d26932b1db..9ba149ecbc 100644
--- a/doc/source/command-objects/role.rst
+++ b/doc/source/command-objects/role.rst
@@ -15,6 +15,7 @@ Add role to a user or group in a project or domain
     os role add
         --domain <domain> | --project <project> [--project-domain <project-domain>]
         --user <user> [--user-domain <user-domain>] | --group <group> [--group-domain <group-domain>]
+        --inherited
         <role>
 
 .. option:: --domain <domain>
@@ -58,6 +59,12 @@ Add role to a user or group in a project or domain
 
     .. versionadded:: 3
 
+.. option:: --inherited
+
+    Specifies if the role grant is inheritable to the sub projects.
+
+    .. versionadded:: 3
+
 .. describe:: <role>
 
     Role to add to `<project>`:`<user>` (name or ID)
@@ -110,6 +117,7 @@ List roles
     os role list
         --domain <domain> | --project <project> [--project-domain <project-domain>]
         --user <user> [--user-domain <user-domain>] | --group <group> [--group-domain <group-domain>]
+        --inherited
 
 .. option:: --domain <domain>
 
@@ -156,6 +164,12 @@ List roles
 
     .. versionadded:: 3
 
+.. option:: --inherited
+
+    Specifies if the role grant is inheritable to the sub projects.
+
+    .. versionadded:: 3
+
 role remove
 -----------
 
@@ -167,6 +181,7 @@ Remove role from domain/project : user/group
     os role remove
         --domain <domain> | --project <project> [--project-domain <project-domain>]
         --user <user> [--user-domain <user-domain>] | --group <group> [--group-domain <group-domain>]
+        --inherited
         <role>
 
 .. option:: --domain <domain>
@@ -210,6 +225,12 @@ Remove role from domain/project : user/group
 
     .. versionadded:: 3
 
+.. option:: --inherited
+
+    Specifies if the role grant is inheritable to the sub projects.
+
+    .. versionadded:: 3
+
 .. describe:: <role>
 
     Role to remove (name or ID)