---
title: "Manage roles and grants | Proofline Help"
description: "Use roles to define what people can do, then grant those roles to people or teams in the organization."
url: https://proofline.sh/help/roles/
---

[Help center](/help/)

# Manage roles and grants

Use roles to define what people can do, then grant those roles to people or teams in the organization.

[![The Roles page with one custom role, Release engineer, and the Create custom role action.](/help-images/roles-light.png)](/help-images/roles-light.png)

Assign a role with the permissions the person needs. Fictional demo workspace.

## Create a custom role

1.  Open **Settings → People → Roles**.
2.  Choose **Create custom role**.
3.  Name the role for the responsibility it represents. The name must differ from every built-in role and every other active role, ignoring capitalization.
4.  Select the capabilities needed for that responsibility.
5.  Save the role.

Capability groups support selecting the whole group or individual capabilities. Check partial selections before saving.

Roles derived from GitHub membership cannot be assigned through a manual grant.

## Grant access

Open the role's grants. Choose **Person** or **Team**, then search by GitHub login or team name. Select the recipient and grant the role.

A grant changes what that recipient can do in this organization. It does not grant repository access in GitHub.

## Remove or inspect access

When a recipient no longer needs a grant, choose **Revoke** beside it. Check the recipient in the confirmation dialog, then choose **Revoke grant**. Once revoked, the grant stops authorizing requests immediately.

Archiving a role stops its grants from authorizing requests, so saving an archive asks you to confirm it first. An archived role's page says it is archived. To find an archived role, select **Show archived** under **Settings → People → Roles**. To restore it, clear the archive option and save. Use **View change history** to inspect recorded changes.

If another session changes the role while you edit, review the current settings before replacing or saving your draft.

## Role administration tasks

-   [Create a custom organization role](/help/create-a-custom-organization-role/)
-   [Grant an organization role to a GitHub team](/help/grant-an-organization-role-to-a-github-team/)
-   [Revoke one organization role grant](/help/revoke-one-organization-role-grant/)
-   [Archive or restore an organization role](/help/archive-or-restore-an-organization-role/)
-   [Recover an organization role edit conflict](/help/recover-an-organization-role-edit-conflict/)
-   [Trace a change to a custom role](/help/trace-a-change-to-a-custom-role/)

## Related guides

-   [Assign seats](/help/seats/)
-   [Inspect the audit log](/help/audit-log/)
-   [Manage API tokens in the console](/help/api-tokens/)
