--- title: "Create & Manage Custom Roles" slug: "create-manage-custom-roles" description: "This article will show you how to create a new custom Role." updated: 2026-07-21T17:36:12Z published: 2026-07-21T17:36:12Z canonical: "www.civicplus.help/create-manage-custom-roles" --- > ## Documentation Index > Fetch the complete documentation index at: https://www.civicplus.help/llms.txt > Use this file to discover all available pages before exploring further. # Create & Manage Custom Roles Roles in the HCMS are used to define [permissions](/civicplus-help-center/docs/permissions-for-roles) for Groups, Clients, and Workflows. This article will show you how to create a new custom Role. As soon as the custom role is saved, it can be found in dropdowns in: - [Clients](/civicplus-help-center/docs/add-manage-clients) - [Groups](/civicplus-help-center/docs/manage-group-permissions) - [Workflows](/civicplus-help-center/docs/) - Group and Client dropdowns in [Permission Sets](/civicplus-help-center/docs/assign-permission-sets-to-groups-and-clients) > [!NOTE] > Important Note > > In order for the custom role to function properly, you will need to add it to an existing workflow or [create a new workflow](/civicplus-help-center/docs/create-modify-workflows) for the role. ## Create a Custom Role > [!TIP] > Who can use this feature? > > Owner [Embedded content](https://www.iorad.com/player/1577513/HCMS--How-to-Add-a-Role-Practice-Tutorial) 1. [Sign in to the HCMS](/civicplus-help-center/docs/sign-in-to-the-hcms) 2. Navigate to **Settings** and then select **Roles**![Settings menu highlighting Roles.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Settings,%20Roles%20-%20HCMS.png?sv=2026-02-06&spr=https&st=2026-11-21T21%3A32%3A15Z&se=2026-11-21T22%3A32%3A15Z&sr=b&sp=r&sig=%2BlymegOFjHhwyhr0HXAXvn%2FbfEH0S9xEj7VkDhGCMFU%3D) 3. At the bottom of the Roles screen, add your **role name** to the text box![Interface showing role management with an input field for entering role names.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Role%20Name%20-%20HCMS.png?sv=2026-02-06&spr=https&st=2026-11-21T21%3A32%3A15Z&se=2026-11-21T22%3A32%3A15Z&sr=b&sp=r&sig=aSk9uzEuI0CMYoXmkIP54odmf2SvuadwsDji4nAjyfc%3D) 4. Click the **Add Role** button![User interface showing role assignment with 'Events Manager' and 'Add role' button.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Add%20Role%20-%20HCMS.png?sv=2026-02-06&spr=https&st=2026-11-21T21%3A32%3A15Z&se=2026-11-21T22%3A32%3A15Z&sr=b&sp=r&sig=yeFc7xT9Z5YOaDHHbk3Y%2FhDYiC9HOWEGrbO%2BdJzgqKA%3D) 5. Click the **gear icon** next to your new role and add [permissions](/civicplus-help-center/docs/permissions-for-roles) for the role by typing in the box and selecting the **+** button![Settings menu for managing event types with highlighted content type options.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Role%20Permissions%20-%20HCMS.png?sv=2026-02-06&spr=https&st=2026-11-21T21%3A32%3A15Z&se=2026-11-21T22%3A32%3A15Z&sr=b&sp=r&sig=tUKdJJdrZwwZGEbKCe%2F4TSNhEu5T1Q9xcVX8VflfmuY%3D) > [!WARNING] > **Note**: > > All roles will need to have the **common** permission which gives access to the HCMS App. The Content Types listed will be specific to your HCMS app. Learn more about the available permissions by viewing our [Permissions for Roles article](/civicplus-help-center/docs/permissions-for-roles). 6. Once all of the applicable permissions have been added, click the **Save** button![Events Manager interface showing options to save and manage event types.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Save%20Role%20Permissions%20-%20HCMS.png?sv=2026-02-06&spr=https&st=2026-11-21T21%3A32%3A15Z&se=2026-11-21T22%3A32%3A15Z&sr=b&sp=r&sig=%2FLfOrbVXrf7hZ76mfsT3Qoomh9bcDtk0wJdudR4A62E%3D) 7. The new role can now be assigned to [Groups](/civicplus-help-center/docs/manage-group-permissions) or [Clients](/civicplus-help-center/docs/add-manage-clients) 8. You will also need to [create a workflow](/civicplus-help-center/docs/create-modify-workflows) for the role or add the role to an existing workflow![Workflow settings for events, including content types and status options for management.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Role%20Workflow%20-%20HCMS.png?sv=2026-02-06&spr=https&st=2026-11-21T21%3A32%3A15Z&se=2026-11-21T22%3A32%3A15Z&sr=b&sp=r&sig=jAeaMocnNTUUZnNFVNPFXlt1%2BDnjDJ05rTRdT1Wi%2F6g%3D) --- ## Remove a Custom Role > [!NOTE] > Important Notes > > - Default Roles (Author, Developer, Owner, Publisher, Reader) cannot be removed > - When you remove the role, you remove all permissions associated with that custom role 1. [Sign in to the HCMS](/civicplus-help-center/docs/sign-in-to-the-hcms) 2. Navigate to **Settings** and then select the **Roles** menu option ![Settings menu highlighting Roles.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Settings,%20Roles%20-%20HCMS.png?sv=2026-02-06&spr=https&st=2026-11-21T21%3A32%3A15Z&se=2026-11-21T22%3A32%3A15Z&sr=b&sp=r&sig=%2BlymegOFjHhwyhr0HXAXvn%2FbfEH0S9xEj7VkDhGCMFU%3D) 3. Click the **Delete** (trash can) icon next to the Role you want to remove![List of user roles with corresponding client and user counts, highlighting the delete option.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Delete%20Role%20-%20HCMS.png?sv=2026-02-06&spr=https&st=2026-11-21T21%3A32%3A15Z&se=2026-11-21T22%3A32%3A15Z&sr=b&sp=r&sig=RNm%2Fx413U1jfdZXNeJIdrzbhiUW8IPa0JOhEBbSFYWE%3D) 4. Click the **Yes** button in the pop-up that asks, **Do you really want to delete the role**?![Confirmation dialog asking to delete a role with Yes and No options.](https://cdn.us.document360.io/17dc564a-8310-4f61-b929-1bd73b36e158/Images/Documentation/Delete%20Role%20Confirmation%20-%20HCMS.png?sv=2026-02-06&spr=https&st=2026-11-21T21%3A32%3A15Z&se=2026-11-21T22%3A32%3A15Z&sr=b&sp=r&sig=YZFpJZ5pxKw2XTW%2BilvKjy4k%2FUERFCWPekAMcGivYPU%3D) --- ## Additional Resources - [Permissions for Roles](/civicplus-help-center/docs/permissions-for-roles) - [Roles Overview and Default Roles](/civicplus-help-center/docs/hcms-roles-overview) Application. A program that performs a particular task or set of tasks.