# Roles

## Add a Roles to a Category <a href="#adding-roles" id="adding-roles"></a>

To add a role to a category, you need a category created and a role to add.

Adding a role using slash-command:

```
/category add-roles
```

Using context-menu command:

&#x20;   Right-click or hold category message -> Apps -> `Add Roles`

{% hint style="warning" %}
If you don't see some roles in the menu, refresh it with the button and make sure that these roles [can be shown](https://kayfarik.gitbook.io/docs/common-problems#no-roles-in-the-roles-add-menu-or-incorrect-role-error).
{% endhint %}

<details>

<summary>Roles Showing Types</summary>

`Show All except Added`: shows all roles except added to the selected category.

`Show All`: shows all roles, even if they already added to the category.

`Show Unique Only`: shows the roles that haven't been added to any category.

</details>

## Remove a roles from a Category <a href="#removing-roles" id="removing-roles"></a>

Removing a role using slash-command:

```
/category remove-roles
```

Using context-menu command:

&#x20;   Right-click or hold category message -> Apps -> `Remove Roles`

## Edit a Role in a Category <a href="#editing-roles" id="editing-roles"></a>

To edit a single role in a category, use the following command:

```
/role edit
```

and to edit multiple roles easily, use:

```
/role bulk-edit
```

* **Emoji**: An emoji to represent the role, will be shown beside the role in the dropdown/button.
* **Description**: A description of the role that will be displayed below the name in the dropdown.
* **Label**: Custom role option label.

{% hint style="info" %}
Use `{default}` as a `label` option value to delete custom label and use role's name.
{% endhint %}

* **Button Style (Color)**: New role option's button color / style (default: `Gray / Secondary`)
* **Custom Type**: Custom type (behavior) of the role **button**.
* **Custom Secret Code**: Custom **button's** secret code, [same as in a category](https://kayfarik.gitbook.io/docs/categories#category-configuring).
* **Number**: If there are several identical roles in a category, you can specify a number of which you want to edit.

{% hint style="info" %}
You can delete some of the parameters using `-` as a value.
{% endhint %}