Auto Roles
Roles handed out by rule: on join, on return, reserved for named people, and separately for bots — with the safety rails that stop a raid walking through them.
On this page
Four independent halves that share a permission model and a logger. Each has its own switch, so a server can run sticky roles without join roles, or reserved roles without either.
Every human who arrives gets these — optionally after screening, after a delay, and only for a while.
A separate list for bots, because a bot handed your Members role is a permission mistake.
When this specific person joins, give them these — for staff who were promised a role before they arrived.
What a member was wearing when they left, handed back if they come back.
Join roles
- Roles
- Up to 15. Everybody who joins gets all of them.
- Wait for screeningOn by default
- Holds the roles until the member accepts your rules. This is the most important setting in the system — handing a role to a member who is still pending can lift Discord's own screening gate, so a raid of fresh accounts would arrive pre-verified. Servers without screening are unaffected.
- Delay
- Wait before granting, up to 14 days. A short delay defeats scripted raid accounts that join and leave in seconds.
- Duration
- Take the roles back after a while (up to a year, 0 means keep them). A probation role that falls away on its own, with nobody left holding a list of who still has it.
Safety rails
- Minimum account age
- Accounts younger than this get nothing, up to 30 days.
- Skip roles
- Members already holding one of these are left alone entirely — the escape hatch for muted, quarantined and manually-handled members.
- Pause during raids
- Suspends every grant while Discord itself reports an active raid on your server. It costs nothing when there is no raid.
Sticky roles
A member who leaves and comes back is restored to where they were rather than to zero.
- Mode: selected rolesDefault
- Nothing comes back unless it is on your list. A moderation role, a paid role, or a role that gained permissions after they left can never be handed back by accident.
- Mode: everything
- Restores whatever they had, minus an exclusion list. Convenient, and worth thinking about twice.
- Clear on ban
- Forget a member's roles the moment they are banned, so an unban never quietly restores a troublemaker's access.
- Retention
- How long a departed member's roles are kept — 90 days by default, up to a year, or forever. Shorter is the safer default and the better privacy answer.
Reserved roles
A standing list of “when this user id joins, give them these roles”. It is keyed by user id rather than by member, because the whole point is to write the rule before the person is in the server.
- Up to 100 rules, up to 10 roles each.
- Remove after assigning drops the rule once the roles have landed, so a one-off promise does not become a roster nobody prunes.
- Each rule can carry its own duration — “helper for the event weekend” is exactly what this list is for.
Applying to members who are already here
Join roles only fire on a join. Apply to existing members runs the rules retroactively across the whole server as a background job you can watch, cancel and re-run.
- Members holding an excluded role are skipped.
- Bots are included only if you ask for them, using the bot role list.
- The retroactive job deliberately does not put roles on the clock — otherwise one button press becomes a server-wide role removal a week later.
Temporary roles
Auto Roles owns the expiry engine for every system that hands out a role with a clock on it — join roles, reserved rules and Reaction Roles menus all write into the same ledger.
- Re-granting a role somebody already holds temporarily extends it rather than starting a second countdown.
- The expiry is logged through the system that granted it, so a role picked up from a role menu is seen leaving in that menu's log.
- Granting the same role permanently clears the clock — otherwise “this is yours” would be undone a week later.
Troubleshooting
Nobody is getting the join role.
Arclo's role must sit above it. After that: check the half's own switch, the minimum account age, the skip-role list, and whether Wait for screening is holding grants for members who have not accepted your rules.
Roles arrive a minute late.
Check the delay setting. Screening also holds them until the member accepts.
A returning member did not get their roles back.
Sticky roles has its own switch and its own retention window, and in selected mode only restores roles on the list.
Still stuck? Ask in the support server — somebody there has almost certainly configured this before.