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

# Role Management

> Add, remove, create, and mass-assign roles across your server.

ZEON provides comprehensive role management tools, from simple single-user assignments to full-scale mass role operations across your entire member base.

***

## <Icon icon="plus" /> Single Role Operations

Manage roles for individual members.

| Command                                 | Description                                                                                                  |
| :-------------------------------------- | :----------------------------------------------------------------------------------------------------------- |
| `.role add <role> <member>`             | Adds a role to a member.                                                                                     |
| `.role remove <role> <member>`          | Removes a role from a member.                                                                                |
| `.role temp <member> <role> <duration>` | Gives a temporary role that auto-removes after the duration (max `7 days`).                                  |
| `.role create <name>`                   | Creates a new empty role with the specified name.                                                            |
| `.role delete <role>`                   | Permanently deletes a role from the server.                                                                  |
| `.role rename <role> <name>`            | Renames an existing role.                                                                                    |
| `.role colour <role> <colour>`          | Changes a role's color (accepts hex codes like `#FF5733`).                                                   |
| `.role icon <role> [emoji/url]`         | Sets an icon for a role. Accepts emojis, image URLs, or message attachments. Leave empty to remove the icon. |

<Note>
  **Dangerous Role Protection:** ZEON will refuse to assign roles that have dangerous permissions (like Administrator, Ban Members, etc.) to prevent accidental privilege escalation.
</Note>

***

## <Icon icon="users" /> Mass Role Operations

Apply or remove a role from large groups of members at once. These operations show an estimated completion time and require confirmation before executing.

### Adding Roles

| Command               | Description                                   |
| :-------------------- | :-------------------------------------------- |
| `.role humans <role>` | Adds the role to all human (non-bot) members. |
| `.role bots <role>`   | Adds the role to all bot members.             |
| `.role all <role>`    | Adds the role to every member in the server.  |

### Removing Roles

| Command                | Description                                       |
| :--------------------- | :------------------------------------------------ |
| `.rrole humans <role>` | Removes the role from all human members.          |
| `.rrole bots <role>`   | Removes the role from all bot members.            |
| `.rrole all <role>`    | Removes the role from every member in the server. |

### Task Management

| Command            | Description                                                       |
| :----------------- | :---------------------------------------------------------------- |
| `.role taskcancel` | Cancels the currently running mass role operation in this server. |

<Warning>
  Only **one mass role task** can run per server at a time. If you start a new one while another is running, it will be rejected. Use `.role taskcancel` to abort a stuck task.
</Warning>