> For the complete documentation index, see [llms.txt](https://documentation.botghost.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.botghost.com/custom-commands-and-events/actions/role-actions/add-roles-to-all-users.md).

# Add Roles to All Users

<figure><img src="/files/5oU8I75LE7EpsrLbV5V2" alt=""><figcaption></figcaption></figure>

Add a role to all members of a server. You can specify role IDs and users affected in specific ways.

{% hint style="warning" %}
The bot must have the Manage Roles permission and a higher position than the role your trying to assign via the bot.
{% endhint %}

## Roles Selector

Click the "+" icon to select the server roles you want to add to all users.&#x20;

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

## **Additional Roles**

In this field you can add additional roles in the form of plain role IDs only. This field is commonly used to add specific role IDs / [variables](/custom-commands-and-events/variables.md). As the field description states, each role ID or variable must be separated by a comma.

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

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

## Reason

This is an optional field. In this field you can input a reason why you are adding a role to everyone in the server. This reason will be shown in your server's audit log. [Variables](/custom-commands-and-events/variables.md) can also be used in this field.

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

## Server ID

In this optional field you can enter the ID of a server that you want to run the action in. This way, you can target servers without triggering a command or event in there. [Variables](/custom-commands-and-events/variables.md) can also be used in this field.&#x20;

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

## Bot Filtering

In this selection menu you can enter whether or not you want the bot to ignore other bots, meaning the role will not be added to bots in your server.&#x20;

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

{% hint style="danger" %}
This action will add the selected roles to ALL users in the server. This operation cannot be undone and may take time for large servers. Use with caution.
{% endhint %}
