> For the complete documentation index, see [llms.txt](https://docs.countercyclical.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.countercyclical.io/workspace-settings/custom-roles.md).

# Custom Roles

Create tailored roles with fine-grained authorization (FGA) for workspace access and resources.

Custom Roles let workspace administrators define precisely what different users can view, create, edit, and manage. Access them from [**Settings › Permissions › Roles**](https://dashboard.countercyclical.io/settings/workspace/permissions/roles).

See also [Teams](https://docs.countercyclical.io/workspace-settings/teams) and [Managing Workspace Members](https://docs.countercyclical.io/workspace-settings/managing-workspace-members).

### Roles Overview

The **Roles** page displays Countercyclical's standard roles—**Owner, Admin, Member, and Guest**—alongside any custom roles created for the workspace.

Each role shows how many workspace members currently use it. Select **View Permissions** to review the policies associated with a role, or use **Search Roles** to locate a specific role.

### Create a Custom Role

Select **Create Role** to open the Role Builder.

Enter a descriptive **Role Name**, then configure the policies the role should receive. Permissions are grouped into sections such as **Workspace** and **Workspace Resources**, with individual controls underneath.

For example, workspace policies can govern whether the role can:

* View, update, or manage the workspace
* View, invite, or update members
* Create, view, or edit folders
* Access and manage other supported workspace resource types

Select individual policies or broader groups to configure the required level of access. The selected-policy counter shows how many permissions are currently enabled.

### Use Role Templates

Expand **Templates** to start from a predefined permission set rather than configuring every policy manually.

Available templates include **Analyst**, **Associate**, **Portfolio Manager**, **Director**, **CIO**, and **IC Member**. Each represents a different common workspace responsibility and automatically selects an appropriate baseline of policies.

{% hint style="warning" %}
**Review the Template Permissions**

Templates are starting points. Review the selected permissions and adjust them before creating the role.
{% endhint %}

### Create the Role

Once the role has a name and its policies are configured, select **Create Role**.

The new custom role appears alongside the standard workspace roles and displays the number of custom policies assigned to it.

You can then use the role when configuring governed workspace access.

### Manage Custom Roles

Custom roles include additional management actions through the **•••** menu.

Select **Edit Role** to modify the role's configuration, **Duplicate Role** to create another role based on it, or **Delete Role** when it is no longer required.

Use **View Permissions** whenever you need to audit the access currently granted by a role.

### Permission Design

Custom Roles are intended for more granular access control than the standard Guest, Member, and Admin levels.

For example, an organization could create a **Portfolio Manager** role that can view workspace members and manage research resources without granting broader workspace-administration privileges.

When creating roles, grant only the permissions required for the user's responsibilities and review template-selected policies before applying them.

#### Related Pages

{% content-ref url="/pages/09gK08hcM2xARMMqNtzQ" %}
[Managing Workspace Members](https://docs.countercyclical.io/workspace-settings/managing-workspace-members.md)
{% endcontent-ref %}

{% content-ref url="/pages/ar517kRWpvrChZ4MXixT" %}
[Teams](https://docs.countercyclical.io/workspace-settings/teams.md)
{% endcontent-ref %}

{% content-ref url="/pages/ChFsQfp8HPAThQm7tmPz" %}
[Sharing & Embedding](https://docs.countercyclical.io/workspaces/sharing-and-embedding.md)
{% endcontent-ref %}
