Status role
Give members a role while their custom status mentions your server, and another for wearing your server's tag.
- Dashboard
- Dashboard › Status role
- Commands
/statusrole- You need
- Administrator
- Element needs
- Manage Roles, with its role above the roles it gives. Manage Webhooks and Embed Links for a log channel.
- Plans
- More panels, and grace periods. See plans
What it does
A panel is a list of statuses to look for and up to 10 roles to give. While a member's custom status contains one of the statuses, Element gives them the roles. When their status stops matching, or they go offline, Element takes the roles back.
The server tag role is separate: Element gives one role to everyone wearing your server's tag next to their name, and takes it back when they take the tag off.
Why use it
"Put our invite in your status" is one of the simplest ways to grow a server. A status role rewards it straight away with a perk role (a colour, a channel, giveaway entries) and stops rewarding it the moment someone changes their status.
How matching works
- Matching ignores capital letters.
- A status that starts or ends with a letter or number matches whole words only, so
catdoesn't match "education". Statuses that start or end with punctuation, like.gg/element, match anywhere, even inside a link. - A member who matches any status in a panel gets all of its roles.
- Invisible counts as offline.
The dashboard's Try a status box shows which panels a status would match, using the same rules.
Set it up
- Open the dashboard, pick your server and go to Status role.
- Click New panel. Give it a name (only admins see it, and it can't be changed later).
- Add the statuses to match, pressing Enter after each, and pick up to 10 roles to give.
- Optionally pick a log channel and a grace period, then save.
/statusrole addwith a panel name, a role and the statuses, like/statusrole add supporter @Supporter .gg/element. Put statuses with spaces in quotes./statusrole addroleadds more roles, up to 10./statusrole logchanneland/statusrole setgraceset the log channel and grace period./statusrole settingsshows every panel.
The status role guide walks through it step by step.
Commands
| Command | What it does |
|---|---|
/statusrole add | Create a panel with a role and its statuses |
/statusrole addrole / removerole | Add or remove a role on a panel |
/statusrole setstatuses | Replace a panel's statuses |
/statusrole toggle | Switch a panel on or off |
/statusrole logchannel | Set or clear a panel's log channel |
/statusrole setgrace | Set or clear a panel's grace period (1 hour to 7 days) |
/statusrole settings | Show the server's panels and settings |
/statusrole forcecheck | Check every member now, for some panels, the server tag, or both |
/statusrole tag | Set the server tag role and its log channel |
/statusrole remove | Delete a panel |
Every command needs Administrator.
Customise it
- Grace period lets members keep the roles for a while after their status stops matching or they go offline, from 1 hour to 7 days. Without one, roles come off straight away.
- Log channel gets a message whenever Element gives or takes a panel's roles.
- Panel on/off pauses a panel without deleting it.
Limits
| Free | Basic | Premium | |
|---|---|---|---|
| Panels | 1 | 3 | 5 |
| Roles per panel | 10 | 10 | 10 |
On the dashboard, a panel can match up to 50 statuses of up to 128 characters each.
Common problems
- Members lose the role when they go offline. That's by design: Element only sees statuses of members who are online. Add a grace period to soften it.
- The role isn't given. Element needs Manage Roles and its role must be above the panel's roles. Check the panel is on.
- Changes don't apply to everyone straight away. Element updates members when their status changes. Run
/statusrole forcecheckto check everyone now. - A short word matches too much or too little. Remember whole-word matching: add the punctuation you want matched, like
.gg/or/element.
Turn it off or reset it
- Pause a panel: switch it off on the dashboard or with
/statusrole toggle. - Delete a panel: on the dashboard, or with
/statusrole remove. Members keep roles already given until you take them away. - Stop the server tag role: clear its role on the dashboard, or run
/statusrole tagwith nothing after it.