Tutorials3 min read

Set Up Discord Auto-Roles — Join Roles & Sticky Snapshots | TeraOne 2026

Automatic Discord roles on join — separate lists for humans and bots, anti-raider delay, and sticky snapshots that restore roles on re-join.

Auto-Roles: New members get their roles. No click. No waiting

Welcome roles, notification tags, an "unverified" marker — and what about an accidental leave? With Auto-Roles, TeraOne assigns default roles on join automatically, optionally with anti-raider delay and sticky snapshots for re-joins.

What it does

  • Separate role lists for humans & bots — up to 50 defaults for humans, 50 for bots. Discord's user.bot flag decides automatically.
  • Anti-raider delay — 6 options: instant, 30 s, 2 min, 5 min, 15 min, 1 h. Classic raiders join + leave in seconds — if your auto-roles only fire after 2 minutes, the raid never triggers them.
  • Sticky snapshots (90 days) — when a user leaves and comes back, they get their previous roles (minus the exclusion list).
  • Exclusion list — which roles are NOT restored: mute, warn, booster (renews anyway).
  • Verify-gate integration — toggle: hold role assignment until Discord server screening completes.
  • Live diagnostics — the dashboard warns if Manage Roles is missing or if a configured role is above the bot's role.

How to set it up

  1. Open Dashboard → Auto-Roles.
  2. Enable the module.
  3. Pick human roles — e.g. @Member, @Notifications. Up to 50.
  4. Pick bot roles separately — e.g. @Bots.
  5. Set the delay — 2 min is a good default against drive-by raids.
  6. Optionally enable sticky snapshots and fill the exclusion list (mute role belongs there).
  7. Optionally enable verify-gate if your server uses Discord screening.

More in the dashboard.

Tips for better results

  • Check bot hierarchy — the TeraOne role must sit above every auto-role in Discord, otherwise Discord refuses. The dashboard actively warns if violated.
  • Sticky off for sensitive roles — for mod-like roles, re-assigning after a leave is risky. Use explicit re-grant instead.
  • 5 min delay on large servers — raids hit within the first 60 s. A longer delay is safer.

FAQ

What happens to manually removed roles? If a mod removes a role and the user later leaves and rejoins, the role is NOT restored — the snapshot reflects the leave-time state. This is intentional.

Do sticky roles work cross-server? No — snapshots are per-server. Cross-guild would be a privacy problem.

Can I disable auto-roles entirely? Yes — master toggle in the dashboard. Or just empty both role lists.


Need help? Join our Discord server.