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

# Role Management

> Assign roles and configure roles for new members.

## Role hierarchy

Semetary needs Manage Roles and must be above every role it assigns or edits. Managed integration roles are not ordinary assignable roles.

## Automatic roles

Add or remove roles from the autorole list and optionally set a delay for new members.

```text theme={null}
,autorole add @Member
,autorole delay 10s
,autorole list
```

## Manual and bulk actions

Role manages individual members. Massrole is restricted to the server owner and opens a role picker. Review the selected role before a bulk action.

<CardGroup cols={1}>
  <Card title="Reaction Roles" icon="users" href="/server-configuration/reaction-roles">
    Publish interactive messages that let members choose roles.
  </Card>

  <Card title="Fake Permissions" icon="key-round" href="/security/fake-permissions">
    Grant bot-level permissions to roles without changing their Discord permissions.
  </Card>
</CardGroup>

## Command reference

Examples use the default comma prefix. Required inputs use angle brackets; optional inputs use square brackets. Each command notes whether it is also registered in Discord's slash menu.

<AccordionGroup>
  <Accordion title=",role" icon="terminal">
    Add or remove a role from a member.

    ### role add

    Add a role to a member.

    ```text Prefix syntax theme={null}
    ,role add <user> <role>
    ```

    | Parameter | Required | Description |
    | - | - | - |
    | `user` | Yes | Member mention or user ID |
    | `role` | Yes | Exact role name or role ID |

    ### role remove

    Remove a role from a member.

    ```text Prefix syntax theme={null}
    ,role remove <user> <role>
    ```

    | Parameter | Required | Description |
    | - | - | - |
    | `user` | Yes | Member mention or user ID |
    | `role` | Yes | Exact role name or role ID |
  </Accordion>

  <Accordion title=",roles" icon="terminal">
    List every role in the server by hierarchy.

    <Note>This command is also registered in Discord’s slash menu. Select the command there to fill in named inputs.</Note>

    ### roles

    List every role in the server by hierarchy.

    ```text Prefix syntax theme={null}
    ,roles
    ```
  </Accordion>

  <Accordion title=",massrole" icon="terminal">
    Assign selected roles to every human member in this server.

    <Note>This command is also registered in Discord’s slash menu. Select the command there to fill in named inputs.</Note>

    ### massrole

    Assign selected roles to every human member in this server.

    ```text Prefix syntax theme={null}
    ,massrole
    ```
  </Accordion>

  <Accordion title=",autorole" icon="terminal">
    Configure roles given to users when they join.

    Aliases: `,ar`.

    ### autorole add

    Add a role to the autoroles list.

    ```text Prefix syntax theme={null}
    ,autorole add <role>
    ```

    | Parameter | Required | Description |
    | - | - | - |
    | `role` | Yes | Exact role name, role mention, or role ID |

    ### autorole remove

    Remove a role from the autoroles list.

    ```text Prefix syntax theme={null}
    ,autorole remove <role>
    ```

    | Parameter | Required | Description |
    | - | - | - |
    | `role` | Yes | Exact role name, role mention, or role ID |

    ### autorole list

    View the configured autoroles.

    ```text Prefix syntax theme={null}
    ,autorole list
    ```

    ### autorole clear

    Remove every configured autorole.

    ```text Prefix syntax theme={null}
    ,autorole clear
    ```

    ### autorole delay

    Set the delay before autoroles are given.

    ```text Prefix syntax theme={null}
    ,autorole delay <time>
    ```

    | Parameter | Required | Description |
    | - | - | - |
    | `time` | Yes | Examples: 10s, 5m, 1h, or off |
  </Accordion>

  <Accordion title=",boosterrole" icon="terminal">
    Create and customize your personal server-booster role.

    Aliases: `,br`.

    ### boosterrole root

    View your booster role.

    ```text Prefix syntax theme={null}
    ,boosterrole root
    ```

    ### boosterrole setup

    Set the role beneath which booster roles are placed.

    ```text Prefix syntax theme={null}
    ,boosterrole setup <role>
    ```

    | Parameter | Required | Description |
    | - | - | - |
    | `role` | Yes | Booster-role position anchor |

    ### boosterrole create

    Create your booster role.

    ```text Prefix syntax theme={null}
    ,boosterrole create [name]
    ```

    | Parameter | Required | Description |
    | - | - | - |
    | `name` | No | Role name |

    ### boosterrole delete

    Delete your booster role.

    ```text Prefix syntax theme={null}
    ,boosterrole delete
    ```

    ### boosterrole name

    Change your booster role name.

    ```text Prefix syntax theme={null}
    ,boosterrole name <name>
    ```

    | Parameter | Required | Description |
    | - | - | - |
    | `name` | Yes | New role name |

    ### boosterrole color

    Change your booster role color.

    ```text Prefix syntax theme={null}
    ,boosterrole color <color>
    ```

    | Parameter | Required | Description |
    | - | - | - |
    | `color` | Yes | Hex color, such as #b48cff |

    ### boosterrole icon

    Set a role icon URL or Unicode emoji.

    ```text Prefix syntax theme={null}
    ,boosterrole icon <icon>
    ```

    | Parameter | Required | Description |
    | - | - | - |
    | `icon` | Yes | Image URL or Unicode emoji |

    ### boosterrole remove-icon

    Remove your booster role icon.

    ```text Prefix syntax theme={null}
    ,boosterrole remove-icon
    ```

    ### boosterrole hoist

    Show your booster role separately in the member list.

    ```text Prefix syntax theme={null}
    ,boosterrole hoist <enabled>
    ```

    | Parameter | Required | Description |
    | - | - | - |
    | `enabled` | Yes | Whether to hoist the role |

    ### boosterrole mentionable

    Allow anyone to mention your booster role.

    ```text Prefix syntax theme={null}
    ,boosterrole mentionable <enabled>
    ```

    | Parameter | Required | Description |
    | - | - | - |
    | `enabled` | Yes | Whether the role is mentionable |

    ### boosterrole share

    Share your booster role with a member.

    ```text Prefix syntax theme={null}
    ,boosterrole share <user>
    ```

    | Parameter | Required | Description |
    | - | - | - |
    | `user` | Yes | Member to share with |

    ### boosterrole unshare

    Stop sharing your booster role with a member.

    ```text Prefix syntax theme={null}
    ,boosterrole unshare <user>
    ```

    | Parameter | Required | Description |
    | - | - | - |
    | `user` | Yes | Member to remove |
  </Accordion>

  <Accordion title=",roleicon" icon="terminal">
    Set a role icon using an emoji.

    <Note>This command is also registered in Discord’s slash menu. Select the command there to fill in named inputs.</Note>

    ### roleicon

    Set a role icon using an emoji.

    ```text Prefix syntax theme={null}
    ,roleicon <role> <emoji>
    ```

    | Parameter | Required | Description |
    | - | - | - |
    | `role` | Yes | The role to update. |
    | `emoji` | Yes | Emoji to use as the role icon. |
  </Accordion>
</AccordionGroup>


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