--- 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%3A21Z&se=2026-11-21T22%3A32%3A21Z&sr=b&sp=r&sig=IytHowYwBol8Yc9E2pGM2McUpOGH%2FL5%2BwRUDU7L8mHA%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%3A21Z&se=2026-11-21T22%3A32%3A21Z&sr=b&sp=r&sig=m1qnfeU1osoW9k05h4rKrY%2BicZ%2FW58Jskhj8F0Z3hfg%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%3A21Z&se=2026-11-21T22%3A32%3A21Z&sr=b&sp=r&sig=m5FeColiGFN9EZbTLAvPb1qjt5ZnODO0nmXdNNvkqbA%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%3A21Z&se=2026-11-21T22%3A32%3A21Z&sr=b&sp=r&sig=dQrHRLkrfuJP%2Fcm0848cWmyIHGIxbugHz92F2l9KC6k%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%3A21Z&se=2026-11-21T22%3A32%3A21Z&sr=b&sp=r&sig=mXYT%2FYKSeKUSzXEbr%2Fk1xSRk6BKN1nuaOXEkrgD7P38%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%3A21Z&se=2026-11-21T22%3A32%3A21Z&sr=b&sp=r&sig=tVMowygSAMBpj%2FPHoKpXH2hUyqoLI5oafZqa9bIqlbU%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%3A21Z&se=2026-11-21T22%3A32%3A21Z&sr=b&sp=r&sig=IytHowYwBol8Yc9E2pGM2McUpOGH%2FL5%2BwRUDU7L8mHA%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%3A21Z&se=2026-11-21T22%3A32%3A21Z&sr=b&sp=r&sig=mA0UOHIRIhteOhMtfe9lxDMbEd3K27KQFNrQ0Qjj9bE%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%3A21Z&se=2026-11-21T22%3A32%3A21Z&sr=b&sp=r&sig=CdLbk5S93%2FrvDs9F2h8IeYnIFawJ7lQaZaA4NWwwP9E%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.