> ## Documentation Index
> Fetch the complete documentation index at: https://docs.envzero.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Assigning roles

> Assign roles to users and teams at organization, project, and environment levels in env zero, with cascading permissions and sub-project inheritance rules.

Roles can be assigned at three levels: organization, project, and environment.

## Assigning Organization Roles

Organization roles can be assigned to both individual [users](https://docs.envzero.com/guides/admin-guide/user-role-and-team-management/user-management.md) and [teams](https://docs.envzero.com/guides/admin-guide/user-role-and-team-management/teams.md), and apply across the entire organization (including all projects and environments).

### Assigning Organization Roles to Users

**1. Navigate to Organization Settings**

Go to **Organization Settings** > **Users** tab.

**2. Select User Role**

Locate the user in the table and click the **Role** dropdown for that user.

**3. Choose Role**

Select from the available roles in the dropdown:

* Default roles: [Organization User](https://docs.envzero.com/guides/admin-guide/user-role-and-team-management/default-roles.md#organization-user), [Organization Admin](https://docs.envzero.com/guides/admin-guide/user-role-and-team-management/default-roles.md#organization-admin)
* Custom roles: Any [custom roles](https://docs.envzero.com/guides/admin-guide/user-role-and-team-management/custom-roles.md) created for your organization

> [!NOTE]
>
> **Role Dropdown Organization**: Default roles are listed first, followed by a separator, then custom roles in alphabetical order.

**4. Save Changes**

Click **SAVE** to apply the changes.

![Organization User Role Assignment](https://mintcdn.com/envzero-b61043c8/ngeLWWxxE3C57X-b/images/guides/admin-guide/user-role-and-team-management/org-user-role-assignment.png?fit=max\&auto=format\&n=ngeLWWxxE3C57X-b\&q=85\&s=41a5e370ce84125bae9cefe83e52ea7f)

### Assigning Organization Roles to Teams

**1. Navigate to Organization Settings**

Go to **Organization Settings** > **Teams** tab.

**2. Select Team Role**

Locate the team in the table and click the **Role** dropdown for that team.

**3. Choose Role**

Select from the available roles:

* Default roles: [Organization User](https://docs.envzero.com/guides/admin-guide/user-role-and-team-management/default-roles.md#organization-user), [Organization Admin](https://docs.envzero.com/guides/admin-guide/user-role-and-team-management/default-roles.md#organization-admin)
* Custom roles: Any custom roles created for your organization

**4. Save Changes**

Click **SAVE** to apply the changes.

![Organization Team Role Assignment](https://mintcdn.com/envzero-b61043c8/ngeLWWxxE3C57X-b/images/guides/admin-guide/user-role-and-team-management/org-team-role-assignment.png?fit=max\&auto=format\&n=ngeLWWxxE3C57X-b\&q=85\&s=5cdf07db3bb6d5f2c152d21faa139c2c)

## Assigning Project Roles

Project roles can be assigned to both users and teams and apply to a specific project, all its sub-projects, and all environments within them.

### Assigning Project Roles to Users

**1. Navigate to Project Settings**

Go to **Project Settings** > **Users** tab.

**2. Select User**

Locate the user in the table and check the checkbox in the **Assign** column.

**3. Choose Role**

Click the **Role** dropdown that appears and select from the available roles:

* Default roles: [Project Viewer](https://docs.envzero.com/guides/admin-guide/user-role-and-team-management/default-roles.md#project-viewer), [Project Planner](https://docs.envzero.com/guides/admin-guide/user-role-and-team-management/default-roles.md#project-planner), [Project Deployer](https://docs.envzero.com/guides/admin-guide/user-role-and-team-management/default-roles.md#project-deployer), [Project Admin](https://docs.envzero.com/guides/admin-guide/user-role-and-team-management/default-roles.md#project-admin)
* Custom roles: Any custom roles created for your organization

**4. Save Changes**

Click **SAVE** to apply the changes.

![Project User Role Assignment](https://mintcdn.com/envzero-b61043c8/ngeLWWxxE3C57X-b/images/guides/admin-guide/user-role-and-team-management/project-user-role-assignment.png?fit=max\&auto=format\&n=ngeLWWxxE3C57X-b\&q=85\&s=bbe906f67c685f1f6384928e7a8e449f)

> [!NOTE]
>
> **Important:** You must first select the user using the checkbox in the **Assign** column before you can choose their role.

### Assigning Project Roles to Teams

**1. Navigate to Project Settings**

Go to **Project Settings** > **Teams** tab.

**2. Select Team**

Locate the team in the table and check the checkbox in the **Assign** column.

**3. Choose Role**

Click the **Role** dropdown that appears and select from the available roles:

* Default roles: [Project Viewer](https://docs.envzero.com/guides/admin-guide/user-role-and-team-management/default-roles.md#project-viewer), [Project Planner](https://docs.envzero.com/guides/admin-guide/user-role-and-team-management/default-roles.md#project-planner), [Project Deployer](https://docs.envzero.com/guides/admin-guide/user-role-and-team-management/default-roles.md#project-deployer), [Project Admin](https://docs.envzero.com/guides/admin-guide/user-role-and-team-management/default-roles.md#project-admin)
* Custom roles: Any custom roles created for your organization

**4. Save Changes**

Click **SAVE** to apply the changes.

![Project Team Role Assignment](https://mintcdn.com/envzero-b61043c8/ngeLWWxxE3C57X-b/images/guides/admin-guide/user-role-and-team-management/project-team-role-assignment.png?fit=max\&auto=format\&n=ngeLWWxxE3C57X-b\&q=85\&s=ec02ca89493ea887caca7fc9a38a94e9)

> [!NOTE]
>
> **Important:** You must first select the team using the checkbox in the **Assign** column before you can choose their role.

## Assigning Environment Roles

Environment roles can be assigned to both users and teams and apply only to a specific environment.

> [!NOTE]
>
> **Team Role Assignment Limitation**
>
> Default roles cannot be assigned to teams at the environment level. Teams can only be assigned custom roles at the environment level.

### Assigning Environment Roles to Users

**1. Navigate to Environment**

Go to the **Environment** page and click the **ACCESS** tab.

**2. Select User**

In the **Manage Users** card, locate the user in the table and check the checkbox in the **Assign** column.

**3. Choose Role**

Click the **Role** dropdown that appears and select from the available roles:

* Default roles: [Environment Viewer](https://docs.envzero.com/guides/admin-guide/user-role-and-team-management/default-roles.md#environment-viewer), [Environment Planner](https://docs.envzero.com/guides/admin-guide/user-role-and-team-management/default-roles.md#environment-planner), [Environment Deployer](https://docs.envzero.com/guides/admin-guide/user-role-and-team-management/default-roles.md#environment-deployer), [Environment Admin](https://docs.envzero.com/guides/admin-guide/user-role-and-team-management/default-roles.md#environment-admin)
* Custom roles: Any custom roles created for your organization

**4. Save Changes**

Click **SAVE** to apply the changes.

![Environment User Role Assignment](https://mintcdn.com/envzero-b61043c8/ngeLWWxxE3C57X-b/images/guides/admin-guide/user-role-and-team-management/environment-user-role-assignment.png?fit=max\&auto=format\&n=ngeLWWxxE3C57X-b\&q=85\&s=5b1e0419a9a1f5dc59cb25c69dfd042f)

> [!NOTE]
>
> **Important:** You must first select the user using the checkbox in the **Assign** column before you can choose their role.

### Assigning Environment Roles to Teams

**1. Navigate to Environment**

Go to the **Environment** page and click the **ACCESS** tab.

**2. Select Team**

In the **Manage Teams** card, locate the team in the table and check the checkbox in the **Assign** column.

**3. Choose Role**

Click the **Role** dropdown that appears and select a custom role.

**4. Save Changes**

Click **SAVE** to apply the changes.

![Environment Team Role Assignment](https://mintcdn.com/envzero-b61043c8/ngeLWWxxE3C57X-b/images/guides/admin-guide/user-role-and-team-management/environment-team-role-assignment.png?fit=max\&auto=format\&n=ngeLWWxxE3C57X-b\&q=85\&s=f22e61c29027979427f8732a1f5de458)

> [!NOTE]
>
> **Default Role Limitation**
>
> Default roles ([Environment Viewer](https://docs.envzero.com/guides/admin-guide/user-role-and-team-management/default-roles.md#environment-viewer), [Environment Planner](https://docs.envzero.com/guides/admin-guide/user-role-and-team-management/default-roles.md#environment-planner), [Environment Deployer](https://docs.envzero.com/guides/admin-guide/user-role-and-team-management/default-roles.md#environment-deployer), [Environment Admin](https://docs.envzero.com/guides/admin-guide/user-role-and-team-management/default-roles.md#environment-admin)) cannot be assigned to teams at the environment level. Only custom roles are available for team assignments.

> [!NOTE]
>
> **Important:** You must first select the team using the checkbox in the **Assign** column before you can choose their role.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.