> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vetox.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Self-assignable roles
> Let members give themselves roles through reaction, dropdown or button panels, with five assignment modes. Free on every tier.
Members pick their own roles — pronouns, notification preferences, game interests — from a panel you design.
**Free on every tier**, with no limits.
## You need an embed message first
Self-Roles attaches to an existing [Embed Message](/en/utility/embed-messages) that has **already been sent to a channel**. It does not create its own message.
If you have no embeds, the create page tells you so and links you to build one. If you have embeds but none has been **sent**, the message picker will be empty even though embeds exist — send one first.
## Panel types
Members react. Up to **20** roles.
Clickable buttons in four colours. Up to **25** roles.
A select menu with a placeholder. Up to **25** roles.
## Behaviour
For emoji and button panels you choose a primary behaviour:
| Mode | Effect |
| ------------- | ---------------------------------------------------- |
| **Toggle** | Selecting gives the role, selecting again removes it |
| **Give Only** | Only ever adds — members cannot remove it themselves |
| **Take Only** | Only ever removes |
Then, optionally, one of two exclusivity modes:
| Mode | Effect |
| ----------------- | ----------------------------------------------------------------------------- |
| **Auto-Replace** | Taking one role removes every other role on the panel |
| **Strict Single** | Refuses the selection if the member already holds another role from the panel |
**Auto-Replace and Strict Single replace your primary choice rather than adding to it.** Selecting either one discards the Toggle / Give Only / Take Only setting.
When you reopen the panel later it will show **Toggle** as the primary regardless of what you originally picked. That is a display artefact — the exclusivity mode is what is actually stored and applied.
Dropdown panels have no behaviour selector. They always toggle, and are always single-select.
**Auto-Replace** suits mutually exclusive choices like region or skill level — members can change their mind and always end up with exactly one.
## Notifications
Members can be DMed when they gain or lose a role, with separate messages for each. Use `[Role]` to insert the role name.
## What the list table shows
Three columns on the panels list are unreliable:
* **Behavior** always reads "Standard" regardless of the mode you set
* **Created** always shows today's date for every panel
* **Type** shows an untranslated English word
Only the **Name** and **Reactions** columns are trustworthy. Open a panel to see its real settings.
## Settings that cannot be reached
Two stored options have no dashboard control and stay at their defaults:
* A **per-role member cap** — the underlying limit on how many people may hold each role is always unlimited
* **Multi-select dropdowns** — dropdown panels are always single-select
A panel's name is taken from the embed message it is attached to. Renaming the embed renames the panel the next time you save it.
## Changing a panel
Switching a panel's type rebuilds its Discord message — the old reactions or buttons are removed before the new ones appear. Members briefly see a panel with no controls.
If the underlying Discord message has been deleted, the update fails quietly and the panel stays listed. Delete it and rebuild against a new message.
Every role on a panel must sit **below** the Vetox role, or it cannot be assigned. See [Permissions](/en/permissions).
Roles given automatically rather than chosen.