Create a role

This is an Early Access feature. To enable it, go to Settings > Features in the Okta Admin Console and turn on Custom Administrator Roles.

Before you begin

Start this task

  1. In the Admin Console, go to Security > Administrators.

  2. Go to the Roles tab. The Roles tab displays a list of previously created standard and custom admin roles.

  3. Click Create new role. The Create new role page opens.

  4. In the Role name field, enter the name of the role. We recommend that you choose a name that’s self-explanatory about the permissions it includes.

  5. Optional. In the Role description field, enter a short description of the role.

  6. Select the required user permissions and group permissions. See About role permissions. Currently, permissions are limited to user, group, and app permissions only. See Best practices for creating a custom role assignment.


    Follow the instructions in the UI tool tips for creating more efficient roless.

  7. Click Save role. You can see the role you created listed on the Roles tab.

Next step

Create an admin assignment using a role

Related topics

About role permissions

Best practices for creating a custom role assignment