diff --git a/en/asgardeo/docs/references/user-management/user-roles.md b/en/asgardeo/docs/references/user-management/user-roles.md
index 0d3339be79..acbceaee46 100644
--- a/en/asgardeo/docs/references/user-management/user-roles.md
+++ b/en/asgardeo/docs/references/user-management/user-roles.md
@@ -2,7 +2,7 @@
Roles determine permissions for accessing Asgardeo resources such as functionalities in the Asgardeo Console and underline REST APIs.
-The following roles, available by default, determine the options available for privileged users in the Asgardeo Console.
+We offer some default roles within the Asgardeo console to tailor the organization administrator’s access, limiting their Console experience to only the resources essential for their role. As an organzation Administrator/Owner, you can the given assign roles to other admins to access the Asgardeo console with limited access.
!!! note
@@ -39,335 +39,284 @@ The following roles, available by default, determine the options available for p
-The following tables elaborate all the permissions enabled for the default roles available for the Asgardeo Console.
+The permissions associated with each role are outlined below. In the table, If a particular permission is not mentioned to a role, administrators with that role will not have access to that section of the Asgardeo Console.
-## Users
-
-
- |
- Administrator |
- Auditor |
- Editor - Applications |
- Viewer - Applications |
- Editor - Users |
- Viewer - Users |
- Editor - Connections |
-
-
- View users |
- ✔️ |
- ✔️ |
- ✔️ |
- ✔️ |
- ✔️ |
- ✔️ |
- ✖️ |
-
-
- Onboard users |
- ✔️ |
- ✖️ |
- ✖️ |
- ✔️ |
- ✖️ |
- ✖️ |
- ✖️ |
-
-
- Update user profiles |
- ✔️ |
- ✖️ |
- ✖️ |
- ✖️ |
- ✔️ |
- ✖️ |
- ✖️ |
-
-
- Delete users |
- ✔️ |
- ✖️ |
- ✖️ |
- ✖️ |
- ✔️ |
- ✖️ |
- ✖️ |
-
-
- View groups |
- ✔️ |
- ✔️ |
- ✔️ |
- ✔️ |
- ✔️ |
- ✔️ |
- ✖️ |
-
-
- Create groups |
- ✔️ |
- ✖️ |
- ✖️ |
- ✖️ |
- ✔️ |
- ✖️ |
- ✖️ |
-
-
- Update and delete groups |
- ✔️ |
- ✖️ |
- ✖️ |
- ✖️ |
- ✔️ |
- ✖️ |
- ✖️ |
-
-
- View assigned users to groups |
- ✔️ |
- ✔️ |
- ✔️ |
- ✔️ |
- ✔️ |
- ✔️ |
- ✖️ |
-
-
- Assign users to groups |
- ✔️ |
- ✖️ |
- ✖️ |
- ✖️ |
- ✔️ |
- ✖️ |
- ✖️ |
-
-
+??? example "Administrator"
-
+ Administrator has read/write access to all the resources in the Asgardeo Console
-## Roles
+??? example "Auditor"
+
+ Auditor has read-only access to all the resources in the Asgardeo Console
-
-
- |
- Administrator |
- Auditor |
- Editor - Applications |
- Viewer - Applications |
- Editor - Users |
- Viewer - Users |
- Editor - Connections |
-
-
- Create roles |
- ✔️ |
- ✖️ |
- ✔️ |
- ✖️ |
- ✔️ |
- ✖️ |
- ✖️ |
-
-
- Delete roles |
- ✔️ |
- ✖️ |
- ✔️ |
- ✖️ |
- ✔️ |
- ✖️ |
- ✖️ |
-
-
- Update role settings |
- ✔️ |
- ✖️ |
- ✔️ |
- ✖️ |
- ✔️ |
- ✖️ |
- ✖️ |
-
-
- Onboard users to roles |
- ✔️ |
- ✖️ |
- ✔️ |
- ✖️ |
- ✔️ |
- ✖️ |
- ✖️ |
-
-
- Onboard groups to roles |
- ✔️ |
- ✖️ |
- ✔️ |
- ✖️ |
- ✔️ |
- ✖️ |
- ✖️ |
-
-
- View roles |
- ✔️ |
- ✔️ |
- ✔️ |
- ✔️ |
- ✔️ |
- ✔️ |
- ✖️ |
-
-
- View users and groups assigned to roles |
- ✔️ |
- ✔️ |
- ✔️ |
- ✔️ |
- ✔️ |
- ✔️ |
- ✖️ |
-
-
+??? example "Editor - Applications"
-
+
+
+ Resources |
+ Sub-section |
+ Read/Write access |
+ Read access only |
+
+
+ Applications |
+ ️ |
+ ✔️ |
+ ️ |
+
+
+ Connections |
+ ️ |
+ ️ |
+ ✔️ |
+
+
+ API Resources |
+ ️ |
+ ✔️ |
+ |
+
+
+ Branding |
+ ️ |
+ ✔️ |
+ ️ |
+
+
+ User Management |
+ Users️ |
+ ️ |
+ ✔️ |
+
+
+ User Management |
+ Groups️ |
+ ️ |
+ ✔️ |
+
+
+ User Management |
+ Roles |
+ ️✔ |
+ ️ |
+
+
+ User Attributes & Stores |
+ Attributes |
+ ️ |
+ ️✔ |
+
+
+ User Attributes & Stores |
+ Attributes >> Scopes |
+ ️️✔ |
+ |
+
+
+ Organizations |
+ ️ |
+ ️ |
+ ✔️ |
+
+
+ Login & Registration |
+ ️ |
+ ️✔ |
+ ️ |
+
+
+ Actions |
+ ️ |
+ ️✔ |
+ ️ |
+
+
+ Events |
+ ️ |
+ ️✔ |
+ ️ |
+
+
+ Logs |
+ ️Diagnostic logs |
+ |
+ ️✔️ |
+
+
-## Applications
-
-
- |
- Administrator |
- Auditor |
- Editor - Applications |
- Viewer - Applications |
- Editor - Users |
- Viewer - Users |
- Editor - Connections |
-
-
- View apps and app settings |
- ✔️ |
- ✔️ |
- ✔️ |
- ✔️ |
- ✖️ |
- ✖️ |
- ✖️ |
-
-
- Register, update and delete apps |
- ✔️ |
- ✖️ |
- ✔️ |
- ✖️ |
- ✖️ |
- ✖️ |
- ✖️ |
-
-
+??? example "Viewer - Applications"
-
+
+
+ Resources |
+ Sub-section |
+ Read/Write access |
+ Read access only |
+
+
+ Applications |
+ ️ |
+ ️ |
+ ✔️ |
+
+
+ Connections |
+ ️ |
+ ️ |
+ ✔️ |
+
+
+ API Resources |
+ ️ |
+ ️ |
+ ✔ |
+
+
+ Branding |
+ ️ |
+ ️ |
+ ️✔ |
+
+
+ User Management |
+ Users️ |
+ ️ |
+ ✔️ |
+
+
+ User Management |
+ Groups️ |
+ ️ |
+ ✔️ |
+
+
+ User Management |
+ Roles |
+ |
+ ️️✔ |
+
+
+ User Attributes & Stores |
+ Attributes |
+ ️ |
+ ️✔ |
+
+
+ User Attributes & Stores |
+ Attributes - Scopes |
+ ️️ |
+ ✔ |
+
+
+ Organizations |
+ ️ |
+ ️ |
+ ✔️ |
+
+
+ Login & Registration |
+ ️ |
+ ️ |
+ ️✔ |
+
+
+ Actions |
+ ️ |
+ ️ |
+ ️✔ |
+
+
+ Events |
+ ️ |
+ ️ |
+ ️✔ |
+
+
+ Logs |
+ ️Diagnostic logs |
+ |
+ ️✔️ |
+
+
+
-## Connections
-
-
- |
- Administrator |
- Auditor |
- Editor - Applications |
- Viewer - Applications |
- Editor - Users |
- Viewer - Users |
- Editor - Connections |
-
-
- View connections and connection settings |
- ✔️ |
- ✔️ |
- ✔️ |
- ✔️ |
- ✖️ |
- ✖️ |
- ✖️ |
-
-
- Create, update and delete connections |
- ✔️ |
- ✖️ |
- ✖️ |
- ✖️ |
- ✖️ |
- ✖️ |
- ✔️ |
-
-
+??? example "Editor - Users"
-
+
+
+ Resources |
+ Sub-section |
+ Read/Write access |
+ Read access only |
+
+
+ User Management |
+ Users️ |
+ ️✔ |
+ ️ |
+
+
+ User Management |
+ Groups️ |
+ ✔️ |
+ ️ |
+
+
+ User Management |
+ Roles |
+ ️✔ |
+ ️ |
+
+
+
+
+
+??? example "Viewer - Applications"
+
+
+
+ Resources |
+ Sub-section |
+ Read/Write access |
+ Read access only |
+
+
+ User Management |
+ Users️ |
+ |
+ ️️✔ |
+
+
+ User Management |
+ Groups️ |
+ |
+ ️️✔ |
+
+
+ User Management |
+ Roles |
+ ️ |
+ ️️✔ |
+
+
+
+
+??? example "Editor - Connections"
+
+
+
+ Resources |
+ Sub-section |
+ Read/Write access |
+ Read access only |
+
+
+ Connections |
+ |
+ ✔ |
+ ️️ |
+
+
+
-## Attributes and scopes
-
-
- |
- Administrator |
- Auditor |
- Editor - Applications |
- Viewer - Applications |
- Editor - Users |
- Viewer - Users |
- Editor - Connections |
-
-
- View attributes |
- ✔️ |
- ✔️ |
- ✔️ |
- ✔️ |
- ✖️ |
- ✖️ |
- ✔️ |
-
-
- Create, update and delete new attributes |
- ✔️ |
- ✖️ |
- ✖️ |
- ✖️ |
- ✖️ |
- ✖️ |
- ✖️ |
-
-
- View scopes |
- ✔️ |
- ✔️ |
- ✔️ |
- ✔️ |
- ✖️ |
- ✖️ |
- ✔️ |
-
-
- Add new attributes to scopes |
- ✔️ |
- ✖️ |
- ✔️ |
- ✖️ |
- ✖️ |
- ✖️ |
- ✖️ |
-
-
- Update and delete scopes |
- ✔️ |
- ✖️ |
- ✔️ |
- ✖️ |
- ✖️ |
- ✖️ |
- ✖️ |
-
-
-