# Custom roles

You can now include specific collections when managing a role. Follow the steps below to create a new role and control what collections it has access to.

#### Create a new Role

1. Go to **Settings** > **Roles**
2. Click on `Create new role` button

<figure><img src="/files/CCZ8G4oh20L8oDa6EQdY" alt=""><figcaption></figcaption></figure>

#### Modify access for a custom role

{% @arcade/embed url="<https://app.arcade.software/share/z4rfS2zV48Mr4D3pxmwn>" flowId="z4rfS2zV48Mr4D3pxmwn" %}

#### **1. Change the Role Settings**

1. Go to your **Settings > Roles.**
2. Find and click the role you want to update (e.g., **JUICE\_SHOP\_APIS**).
3. Search and select the list of API Collections you want to include in the role.

#### **2. Assign a Permission Level (Optional)**

1. Use the dropdown next to **Guest** (or the default permission) to choose the appropriate permission level.
2. This controls what actions role members can perform on the selected collections.

#### **3. (Optional) Set as Default Invite Role**

* If you want any new users invited under this role to automatically have these permissions, check the **Default invite role** option.

***

#### **Best Practices & Tips**

* **Review Permissions**: Before finalizing, confirm that the permission level is correct for each collection to avoid granting excessive access.
* **Name Roles Clearly**: If you manage multiple roles, use a clear naming convention (e.g., **API-Only**, **View-Only**, etc.) to distinguish them easily.
* **Default Role**: Be cautious when setting a default invite role—any newly invited user will automatically inherit those permissions.

This new feature streamlines role management by allowing you to pick exactly which collections each role can access.

If you have any questions or encounter issues, don’t hesitate to contact our support team.


---

# 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.akto.io/account-management/custom-roles.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.