# Create a role

## Create a role

Create a new Role in the server. You can choose the Role Name, Color, Position, whether or not to display (hoist) the role, and whether or not to allow everyone to @mention the role.

{% hint style="warning" %}
The bot must have Manage Roles permission in order to create a role.
{% endhint %}

## Name

The name of the new role you're creating.

<figure><img src="https://1937909199-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lm_hW5MApY3J0lRhi0M%2Fuploads%2FvOdZODvqlCPSv6Dh1GYr%2F92554BA5-A439-48E5-9A85-238C0B321C4A.jpeg?alt=media&#x26;token=53736dbb-9835-4f24-9d62-8dfe551153b7" alt=""><figcaption></figcaption></figure>

## Reason

An optional reason for creating the new role. This will show in Discord Audit Log.

<figure><img src="https://1937909199-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lm_hW5MApY3J0lRhi0M%2Fuploads%2Fb6sDtAf4drzbeNzPFym1%2FF38F3EFF-F203-4FD3-A14E-887E31922602.jpeg?alt=media&#x26;token=a2195c65-3a95-4597-a47e-c9ba8dac77e4" alt=""><figcaption></figcaption></figure>

## Position

The position of the new role. Leave blank for default positioning. This goes from Down to Top.

<figure><img src="https://1937909199-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lm_hW5MApY3J0lRhi0M%2Fuploads%2F8ef0evpPfXcJQyHmnVfb%2F84051F09-2742-4BED-B042-7E131F37889F.jpeg?alt=media&#x26;token=8c84c6d1-e9e5-4f79-bab7-3442d83e3993" alt=""><figcaption></figcaption></figure>

## Color

The color of this role. Members use the color of the highest role they have on the roles list. This is a HEX number.

<figure><img src="https://1937909199-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lm_hW5MApY3J0lRhi0M%2Fuploads%2FibjSRDZcsNhTpjN64IMd%2FB7234007-14AE-402C-A803-214FB1783A0B.jpeg?alt=media&#x26;token=c7cbfe12-6fd4-4782-85c6-b887b5adb961" alt=""><figcaption></figcaption></figure>

## **Display role members separately from online members** &#x20;

Whether or not to hoist the role.

<figure><img src="https://1937909199-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lm_hW5MApY3J0lRhi0M%2Fuploads%2F84GP3y6HSQ1TUL83yRDT%2F0FB5D5E9-DCED-4528-98FC-99417D2705B1.jpeg?alt=media&#x26;token=42dcb38d-40d0-4364-bfee-9c5366aa9fe9" alt=""><figcaption></figcaption></figure>

## Mentionable

Allow anyone to @mention this role.

<figure><img src="https://1937909199-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lm_hW5MApY3J0lRhi0M%2Fuploads%2FnZqHPzjiuGljj6BYFfh6%2FD3C78659-64FD-4483-BB6C-60349E69295A.jpeg?alt=media&#x26;token=0317108d-4053-4eb3-96d0-f13bff294abb" alt=""><figcaption></figcaption></figure>

## Permissions

Add Permissions for this role. The role will start with no default permissions.

<figure><img src="https://1937909199-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lm_hW5MApY3J0lRhi0M%2Fuploads%2FQIL6Wp8rWYgg6O7fjtvF%2FE0048BCF-1FB2-4B95-94C4-7AD241BF9E4D.jpeg?alt=media&#x26;token=74aca87a-e300-4d9e-b5c1-73e152ce292c" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
The bot must have Manage Roles permission in order to create a role.
{% endhint %}
