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

# Dropdown Roles

> Allow your members to assign themselves roles by selecting them from a dropdown.

## What are dropdown roles?

Dropdown roles are roles that are assigned to members when they select an option from a dropdown menu. They can be useful for letting members choose multiple roles from a single message, such as pronouns or ping roles.

![](https://mintcdn.com/bleed/qnI7q0xQHWHO578k/images/configuration/roles/dropdown/example.png?fit=max\&auto=format\&n=qnI7q0xQHWHO578k\&q=85\&s=df9963960a058216caf2c52f4d890aad)

## Creating a dropdown role

You can create a dropdown role menu using the `/autorole dropdownrole create` command.

> [!NOTE]
>
> You must have the `Manage Roles` permission to use this command. A dropdown can have up to **25** roles.

This command will open a Discord modal where you can specify the title, emoji, and description for the role.

```javascript Syntax theme={null}
/autorole dropdownrole create channel:<channel> role:<role>
```

```javascript Example theme={null}
/autorole dropdownrole create channel:#general role:@in bird vc
```

![](https://mintcdn.com/bleed/qnI7q0xQHWHO578k/images/configuration/roles/dropdown/create.png?fit=max\&auto=format\&n=qnI7q0xQHWHO578k\&q=85\&s=ca01b0dd067654a8886c036104e95568)

## Adding a role to a dropdown

You can add more roles to an existing dropdown using the `/autorole dropdownrole add` command.

This command will open a Discord modal where you can specify the title, emoji, and description for the role.

```javascript Syntax theme={null}
/autorole dropdownrole add message_link:<message_link> role:<role>
```

```javascript Example theme={null}
/autorole dropdownrole add message_link:.../channels/... role:<role>
```

![](https://mintcdn.com/bleed/qnI7q0xQHWHO578k/images/configuration/roles/dropdown/add.png?fit=max\&auto=format\&n=qnI7q0xQHWHO578k\&q=85\&s=429d484582a75157aed310285091f8fc)

## Editing a dropdown role

You can change a role's title, emoji or description using the `/autorole dropdownrole edit` command.

> [!TIP]
>
> You can use the `/autorole dropdownrole list` command to see all dropdown roles in your server.
>
> ![](https://mintcdn.com/bleed/qnI7q0xQHWHO578k/images/configuration/roles/dropdown/list.png?fit=max\&auto=format\&n=qnI7q0xQHWHO578k\&q=85\&s=bbccf2c9ab946d07af7993f6f29724ea)

```javascript Syntax theme={null}
/autorole dropdownrole edit message_link:<message_link> index:<1-25>
```

```javascript Example theme={null}
/autorole dropdownrole edit message_link:.../channels/... index:1
```

## Related commands

> [accordion] Changing the placeholder
>
> Use the `/autorole dropdownrole placeholder` command to change the text shown on the dropdown before a member selects a role.
> \[!NOTE] If you leave out the `text` parameter, this command will open a Discord modal where you can enter the placeholder.
>
> ```javascript Syntax theme={null}
> /autorole dropdownrole placeholder message_link:<message_link> text:<text>
> ```
>
> ```javascript Example theme={null}
> /autorole dropdownrole placeholder message_link:.../channels/... text:Select your roles
> ```

> [accordion] Setting a limit
>
> Use the `/autorole dropdownrole limit` command to set how many roles a member can select from the dropdown.
> \[!NOTE] The maximum cannot be higher than the number of roles on the dropdown.
>
> ```javascript Syntax theme={null}
> /autorole dropdownrole limit message_link:<message_link> minimum:<0-25> maximum:<1-25>
> ```
>
> ```javascript Example theme={null}
> /autorole dropdownrole limit message_link:.../channels/... minimum:0 maximum:3
> ```

> [accordion] Making a dropdown exclusive
>
> Use the `/autorole dropdownrole exclusive` command to only allow members to hold **one** role from the dropdown.
> \[!NOTE] When this is enabled, selecting a role will **remove** the member's other roles from the dropdown.
>
> ```javascript Syntax theme={null}
> /autorole dropdownrole exclusive message_link:<message_link> setting:<On|Off>
> ```
>
> ```javascript Example theme={null}
> /autorole dropdownrole exclusive message_link:.../channels/... setting:On
> ```

> [accordion] Changing the message
>
> Use the `/autorole dropdownrole message` command to set the text or embed above the dropdown.
> \[!NOTE] This command will open a Discord modal where you can enter raw text, [components](https://docs.bleed.bot/resources/scripting/components.md) or an [embed](https://docs.bleed.bot/resources/scripting/embeds.md). If you no longer want a message, you can re-run the command and leave the modal empty.
>
> ```javascript Syntax theme={null}
> /autorole dropdownrole message message_link:<message_link>
> ```
>
> ```javascript Example theme={null}
> /autorole dropdownrole message message_link:.../channels/...
> ```

> [accordion] Setting required roles
>
> Use the `/autorole dropdownrole required` command to set the roles a member needs before they can use the dropdown.
> \[!NOTE] This command will open a Discord modal where you can choose the roles, and whether members need **any** or **all** of them. If you no longer want to require roles, you can re-run the command without a role.
>
> ```javascript Syntax theme={null}
> /autorole dropdownrole required message_link:<message_link>
> ```
>
> ```javascript Example theme={null}
> /autorole dropdownrole required message_link:.../channels/...
> ```

## Removing a dropdown role

You can remove a specific role from a dropdown by using the `/autorole dropdownrole remove` command.

```javascript Syntax theme={null}
/autorole dropdownrole remove message_link:<message_link> index:<1-25>
```

```javascript Example theme={null}
/autorole dropdownrole remove message_link:.../channels/... index:1
```

![](https://mintcdn.com/bleed/qnI7q0xQHWHO578k/images/configuration/roles/dropdown/remove.png?fit=max\&auto=format\&n=qnI7q0xQHWHO578k\&q=85\&s=9ce41ee1e15da6c22ce7e4167f8757c3)

### Removing a dropdown

Additionally, you can remove a dropdown and every role on it by using the `/autorole dropdownrole removeall` command.

```javascript Syntax theme={null}
/autorole dropdownrole removeall message_link:<message_link>
```

```javascript Example theme={null}
/autorole dropdownrole removeall message_link:.../channels/...
```

![](https://mintcdn.com/bleed/qnI7q0xQHWHO578k/images/configuration/roles/dropdown/removeall.png?fit=max\&auto=format\&n=qnI7q0xQHWHO578k\&q=85\&s=25393d09c99896b654c7758360850582)

### Removing all dropdown roles from the server

You can remove all dropdown roles from the server by using the `/autorole dropdownrole reset` command.

> [!WARNING]
>
> Please note that this **cannot** be undone & will **permanently** remove **all** dropdown roles from the
> server.

```javascript Syntax theme={null}
/autorole dropdownrole reset
```

![](https://mintcdn.com/bleed/qnI7q0xQHWHO578k/images/configuration/roles/dropdown/reset.png?fit=max\&auto=format\&n=qnI7q0xQHWHO578k\&q=85\&s=63fa6392537856be94d2cf07795e8562)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.