Autorole
Assign a role automatically when a member joins or enters a configured voice channel.
Before you start
Section titled “Before you start”Sign in, select a server you can manage, and ensure April is in it. In Discord, April needs Manage Roles and its highest role must be above the roles it changes; see role hierarchy.
Set up an autorole
Section titled “Set up an autorole”- Open Administration > Autorole and create an entry.
- Select the role and either the member-join or voice trigger. For voice, select the voice channel and optionally enable Auto remove to remove the role on exit.
- For voice, configure allowed or ignored roles if needed. Enable the entry and save. Allowed roles take precedence over ignored roles; join events do not apply these filters.
- Check the saved entry, then arrange a suitable join or voice event and inspect the member’s roles in Discord. A saved form alone does not demonstrate assignment.
For example, use a voice trigger and Auto remove for a temporary voice participant role. Non-premium servers can create up to five autoroles. The dashboard offers join and voice triggers; streaming is not a supported working trigger here.
Local setup: choose the role for a join trigger.
Local setup: choose the voice channel and optional filters.
Settings
Section titled “Settings”| Setting | Effect and creation-form default |
|---|---|
| Enabled | New entries start enabled. Disable an entry to stop future assignments. |
| Join / voice | Join assigns on a non-bot member join. Voice uses the chosen channel; the form starts with no channel selected. |
| Allowed / ignored roles | Voice can limit eligible members by role. A nonempty allowed list takes priority; otherwise ignored roles exclude members. Both lists start empty. Join does not apply these filters. |
| Auto remove | For voice, remove the role on exit; the voice form starts with this off. |
Change or troubleshoot
Section titled “Change or troubleshoot”Edit, disable, or delete the entry in the list when it is no longer needed. If the list is empty, create an entry; if it is loading or saving fails, wait and retry. Check that the entry is enabled, the role and voice channel still exist, and April has permission and hierarchy to change the role. Forbidden or missing-resource failures can disable entries; correct the Discord setup and re-enable the entry before testing again. Voice settings use a cache, so a dashboard edit may not be reflected immediately.
See self roles for roles members choose themselves.
Before setup, see sign in and select a server. For maintainers, see the administration technical record.