# Configuring custom permission sets

{% hint style="info" %}
**Required global permission:** Manage custom permission sets
{% endhint %}

You can create custom global and dataset permission sets.

A custom permission set allows you to have more precise control over global, dataset, and guided redaction permissions.

For example, you might want a dataset permission set that allows a user to manage the files but not share or delete the dataset, or a guided redaction permission set that only allows a user to review redactions.

For global permissions, you might want a global permission set that allows a user to manage access to any dataset, but not manage Textual users.

## **Creating a custom permission set** <a href="#custom-permission-set-create" id="custom-permission-set-create"></a>

To create a custom permission set:

1. On the permission sets list, click the create permission set button.
2. On the permission set details panel, in the **Permission Set Name** field, type the name for the new permission set.\
   \
   Permission set names must be unique for that permission set type (global, dataset).
3. Select the permissions to grant to the permission set.\
   \
   If a permission checkbox is checked, then the permission is granted to the permission set.\
   \
   If a permission checkbox is not checked, then the permission is not granted to the permission set.
4. To save the new permission set, click **Save**.
5. For a global permission set, Textual prompts you to configure access to the new permission set.\
   \
   To display the access management panel for the permission set, click **Manage User Access**.\
   \
   To not manage access at that time, click **Skip**.

## **Editing a custom permission set** <a href="#custom-permission-set-edit" id="custom-permission-set-edit"></a>

You cannot make any changes to a built-in permission set.

For a custom permission set, you can change the permission set name and adjust the assigned permissions.

To edit an existing custom permission set:

1. On the permission sets list, click **Settings**.
2. On the permission set details panel, update the permission set configuration.
3. Click **Save**.

## **Deleting a custom permission set** <a href="#custom-permission-set-delete" id="custom-permission-set-delete"></a>

You can delete a custom permission set. You cannot delete a built-in permission set.

You cannot delete a permission set that is assigned to any users or groups. Before you can delete the permission set, you must remove the assignment.

To delete a custom permission set:

1. On the permission sets list, click **Settings**.
2. On the permission set details panel, click **Delete Permission Set**.
3. On the confirmation panel, click **Confirm**.


---

# 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.tonic.ai/textual/textual-install-administer/user-access-textual/textual-permissions/permission-sets-custom.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.
