diff --git a/docs/admin/users/groups-roles.md b/docs/admin/users/groups-roles.md
index 77dd35bf9dd89..17c0fc8b5b8b9 100644
--- a/docs/admin/users/groups-roles.md
+++ b/docs/admin/users/groups-roles.md
@@ -31,6 +31,30 @@ Roles determine which actions users can take within the platform.
A user may have one or more roles. All users have an implicit Member role that
may use personal workspaces.
+## Custom Roles (Premium) (Beta)
+
+Starting in v2.16.0, Premium Coder deployments can configure custom roles on the
+[Organization](./organizations.md) level. You can create and assign custom roles
+in the dashboard under **Organizations** -> **My Organization** -> **Roles**.
+
+> Note: This requires a Premium license.
+> [Contact your account team](https://coder.com/contact) for more details.
+
+
+
+Clicking "Create custom role" opens a UI to select the desired permissions for a
+given persona.
+
+
+
+From there, you can assign the custom role to any user in the organization under
+the **Users** settings in the dashboard.
+
+
+
+Note that these permissions only apply to the scope of an
+[organization](./organizations.md), not across the deployment.
+
### Security notes
A malicious Template Admin could write a template that executes commands on the
diff --git a/docs/images/admin/users/roles/assigning-custom-role.PNG b/docs/images/admin/users/roles/assigning-custom-role.PNG
new file mode 100644
index 0000000000000..271f1bcae7781
Binary files /dev/null and b/docs/images/admin/users/roles/assigning-custom-role.PNG differ
diff --git a/docs/images/admin/users/roles/creating-custom-role.PNG b/docs/images/admin/users/roles/creating-custom-role.PNG
new file mode 100644
index 0000000000000..a10725f9e0a71
Binary files /dev/null and b/docs/images/admin/users/roles/creating-custom-role.PNG differ
diff --git a/docs/images/admin/users/roles/custom-roles.PNG b/docs/images/admin/users/roles/custom-roles.PNG
new file mode 100644
index 0000000000000..14c50dba7d1e7
Binary files /dev/null and b/docs/images/admin/users/roles/custom-roles.PNG differ
pFad - Phonifier reborn
Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.
Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.
Alternative Proxies:
Alternative Proxy
pFad Proxy
pFad v3 Proxy
pFad v4 Proxy