# Permission Groups

Using the `Permission groups`, you can assign a user to a particular group and a user inherits all the permissions granted to the group.

The advantage of the `Permission groups` is to define a set of privileges like create, edit, or delete for the given set of resources that can be shared among the users within the group.

{% hint style="info" %}
The [User permissions](/operator-guide/authorization/user-permissions.md) section for `Specific permissions` contains a drop-down list of all existing groups for which a user has an access. This is an optional field and more than one groups can be selected for a user.
{% endhint %}

***

## Add Group

Go to **Global Configurations** → **Authorization** → **Permissions groups** → **Add group**.

![](https://devtron-public-asset.s3.us-east-2.amazonaws.com/images/global-configurations/permission-group/add-group-db.jpg)

Enter the `Group Name` and `Description`.

![](https://devtron-public-asset.s3.us-east-2.amazonaws.com/images/global-configurations/permission-group/create-group-db.jpg)

You can either grant [super-admin](/operator-guide/authorization/user-permissions.md#role-based-access-levels) permission to a user group or specific permissions to manage access for:

* [Helm Apps](#helm-apps-permissions)
* [Kubernetes Resources](#kubernetes-resources-permissions)

### Helm Apps Permissions

In `Helm Apps` option, you can provide access to a group to manage permission for Helm apps deployed from Devtron or outside Devtron.

Provide the information in the following fields:

![](https://devtron-public-asset.s3.us-east-2.amazonaws.com/images/global-configurations/permission-group/group-helmapp-permdb.jpg)

| Dropdown                             | Description                                                                                                                                                                                                                                                                                                                                                                |
| ------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Project**                          | <p>Select a project from the drop-down list to which you want to give permission to the group. You can select only one project at a time.<br>Note: If you want to select more than one project, then click <code>Add row</code>.<br></p>                                                                                                                                   |
| **Environment or cluster/namespace** | <p>Select the specific environment or <code>all existing environments in default cluster</code> from the drop-down list.<br>Note: If you select <code>all existing + future environments in default cluster</code> option, then a user gets access to all the current environments including any new environment which gets associated with the application later.<br></p> |
| **Application**                      | <p>Select the specific application or all applications from the drop-down list corresponding to your selected Environments.<br>Note: If <code>All applications</code> option is selected, then a user gets access to all the current applications including any new application which gets associated with the project later<br>.</p>                                      |
| **Role**                             | <p>Select one of the <a href="#role-based-access-levels">roles</a> to which you want to give permission to the user:</p><ul><li><code>View only</code></li><li><code>View & Edit</code></li><li><code>Admin</code></li></ul>                                                                                                                                               |

You can add multiple rows for Devtron app permission.

Once you have finished assigning the appropriate permissions for the groups, Click **Save**.

### Kubernetes Resources Permissions

In `Kubernetes Resources` option, you can provide permission to view, inspect, manage, and delete resources in your clusters from [Resource Browser](/user-guide/resource-browser.md) in Devtron. You can also create resources from Resource Browser.

{% hint style="info" %}
Only super admin users will be able to see `Kubernetes Resources` tab and provide permission to other users to access `Resource Browser`.
{% endhint %}

To provide Kubernetes resource permission, click `Add permission`.

![](https://devtron-public-asset.s3.us-east-2.amazonaws.com/images/global-configurations/permission-group/group-resource-permdb1.jpg)

On the `Kubernetes resource permission`, provide the information in the following fields:

![](https://devtron-public-asset.s3.us-east-2.amazonaws.com/images/global-configurations/user-access/user-permission/group-resource-permdb2.jpg)

| Dropdown          | Description                                                                                                                                                                                                            |
| ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Cluster**       | <p>Select a cluster from the drop-down list to which you want to give permission to the user. You can select only one cluster at a time.<br>Note: To add another cluster, then click <code>Add another</code>.<br></p> |
| **Namespace**     | Select the namespace from the drop-down list.                                                                                                                                                                          |
| **API Group**     | Select the specific API group or `All API groups` from the drop-down list corresponding to the K8s resource.                                                                                                           |
| **Kind**          | Select the kind or `All kind` from the drop-down list corresponding to the K8s resource.                                                                                                                               |
| **Resource name** | Select the resource name or `All resources` from the drop-down list to which you want to give permission to the user.                                                                                                  |
| **Role**          | <p>Select one of the <a href="#role-based-access-levels">roles</a> to which you want to give permission to the user and click <code>Done</code>:</p><ul><li><code>View</code></li><li><code>Admin</code></li></ul>     |

You can add multiple rows for Kubernetes resource permission.

Once you have finished assigning the appropriate permissions for the groups, Click **Save**.

***

## Edit Permissions Group

You can edit the permission groups by clicking the `downward arrow.`

![](https://devtron-public-asset.s3.us-east-2.amazonaws.com/images/global-configurations/permission-group/edit-group-db.jpg)

Edit the permission group.

![](https://devtron-public-asset.s3.us-east-2.amazonaws.com/images/global-configurations/permission-group/edit-perm-group.jpg)

Once you are done editing the permission group, click **Save**.

***

## Delete Permissions Group

If you want to delete a particular permission group, click the delete icon.

![](https://devtron-public-asset.s3.us-east-2.amazonaws.com/images/global-configurations/permission-group/delete-group-db.jpg)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.dashboard.devtron.ai/operator-guide/authorization/permission-groups.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
