The settings of an auto role
The preview above shows a member right after joining, then 10 minutes later. Each auto role combines four settings:
- Type: add the role to the new member, or remove it.
- Members: everyone, humans only or bots only, so bots never get your community roles.
- Delay: apply the role right away or after a wait, from a few seconds up to 30 days.
- Remove on new role: take the auto role away as soon as the member receives any other role.
In the preview, Member is given right away and Newcomer is set to be removed on a new role. Verified comes 10 minutes later, and since it is a new role, Newcomer goes away at the same moment.
Example setups
A few combinations, and how to build each one:
| Goal | Role | Type | Members | Delay | Remove on new role |
|---|
| A base role for everyone | Member | Add | Humans | None | No |
|---|
| Keep bots apart | Bots | Add | Bots | None | No |
|---|
| A starter role until members pick roles | Newcomer | Add | Humans | None | Yes |
|---|
| Open the rest of the server after a wait | Verified | Add | Humans | 10 minutes | No |
|---|
For the starter role, let members pick their own roles next, for example with reaction roles: the first role they pick removes Newcomer.
Set up auto roles in three steps
From the dashboard or from Discord, whichever you prefer.
- Add Koya to your Discord server.
- In the dashboard, open Auto Roles and create an auto role, or run /autorole add in your server.
- Pick the role, then the type, the members it applies to, an optional delay and whether to remove it on a new role.
Koya needs the Manage Roles permission, and its highest role must sit above the roles it gives. The dashboard warns you when either is missing. Changes made by auto roles appear in Discord's audit log, with "Auto Role" in the reason. Use /autorole list to review them and /autorole remove to delete one.
Free, Premium and Pro for auto roles
Every setting is available on every plan; only the number of auto roles changes. The other limits are on the Premium and Pro limits page.
| Feature | Free | Premium | Pro |
|---|
| Auto roles | 3 | 20 | unlimited |
|---|
| Add or remove on join | Yes | Yes | Yes |
|---|
| Humans, bots or everyone | Yes | Yes | Yes |
|---|
| Delay up to 30 days | Yes | Yes | Yes |
|---|
| Remove on new role | Yes | Yes | Yes |
|---|
With welcome messages and reaction roles
Auto roles handle the first seconds of a member's stay. Greet them in a channel or by DM with welcome messages and cards, then let them choose the rest with reaction roles.