---
title: "Create Custom Roles"
description: "Learn how to create custom roles in Contentstack to align permissions with team duties, ensuring compliance and effective access management."
url: "https://www.contentstack.com/docs/administration/create-custom-roles"
product: "Contentstack"
doc_type: "guide"
audience:
  - developers
  - admins
version: "current"
last_updated: "2026-07-13"
---

# Create Custom Roles

Custom roles define organization-level (product-level) permissions for a Contentstack product when the default roles do not match a team's responsibilities. You create custom roles through Administration, select the permission categories that apply to the product, and choose the actions each role can perform.

Use custom roles to align access with internal responsibilities and compliance requirements, such as granting view-only access to one product area while restricting another.

## Prerequisites

*   [Contentstack account](https://www.contentstack.com/login/)
*   Organization [Owner or Admin](/docs/administration/about-administration-roles) permissions

## What You Will Learn

*   How to create an organization-level custom role for a product.
    
*   Where custom roles become available after creation.
    

## Create a Custom Role

To create a custom organization-level role, log in to your Contentstack account and perform the steps given below:

1.  Navigate to **Administration** through the "App Switcher", then click the **Roles** tab to view roles.
2.  Click **\+ New Role**.![New Role button on the Roles page](https://assets.contentstack.io/spaces/am51d76353d996c1fe/assets/am610bb094e57628c4/b4e5c25f85fd96aa4279fbb1/Create_Roles_1.png?locale=en-us)
3.  Enter a **Name** and a **Description**.
4.  Under **Choose a Product**, select the product the role applies to, such as **CMS**, **Assets**, or **Administration**.![Choose a Product selection on the New Role page](https://assets.contentstack.io/spaces/am51d76353d996c1fe/assets/am0c1b315c82a3ffc4/6c518da3cc6cdcd2bb3ae194/Create_Roles_2.png?locale=en-us)
5.  Review the permission categories available for the selected product. The categories vary by product. For example, Assets includes Spaces, Fields, Asset Types, Users, Roles, and Languages.
6.  For each category, click **\+ Select Permissions**, or click the vertical ellipsis and select **Manage Permissions**.
7.  In the permissions side panel, select the required actions for the category, such as **View**, **Create**, **Edit**, or **Delete**.![Permissions side panel with action selections](https://assets.contentstack.io/spaces/am51d76353d996c1fe/assets/amd5ed9777f7afb5d6/7a162e9d12fbcc1cc93a9914/Create_Roles_3.png?locale=en-us)
8.  Click **Save**.
    
    **Tip**: Configure permissions only for the areas this role should access. Leave other categories unselected to restrict access.
    
9.  Click **Create Role**.![Create Role button confirming the new custom role](https://assets.contentstack.io/spaces/am51d76353d996c1fe/assets/am21ee0c8220302ff9/73ef0171f0857889904ecd99/Create_Roles_4.png?locale=en-us)

The custom role is created and appears on the Roles listing page with a Custom tag.

## Where Custom Roles Are Available

After you create an organization-level custom role, it becomes available for selection when you:

*   Invite new users.
*   Edit an existing user's organization-level roles for that product.

**Note**: Only organization-level (product-level) custom roles can be created through Administration. Project-level custom roles, such as custom stack, space, or AgentOS project roles, must be created from the respective project or its per-product settings page. Project-level custom roles appear in the invitation flow once created, but you cannot create them from Administration.

**Additional Resource**: To assign roles when onboarding users, refer to the [Invite Users to Organization](/docs/administration/invite-users-to-organization) documentation.