Sticky messages and roles

Dashboard

Dashboard › Sticky

Commands

/sticky message, /sticky roles

You need

Administrator

Element needs

Sticky messages: Read Message History, Send Messages and Embed Links in the channel. Sticky roles: Manage Roles, with its role above the roles it gives back.

Plans

More sticky messages. Inactivity mode and sticky roles need the Premium plan. See plans

#What it does

Sticky messages stay at the bottom of a channel. When people talk, Element deletes its last copy and posts the message again underneath, at most every 10 seconds. A channel has one sticky at a time.

Sticky roles remember a member's roles when they leave and give them back when they rejoin, so leaving and rejoining can't be used to shed a mute role, and returning members don't have to ask for their roles again.

#Why use it

Sticky messages keep rules, an application link or a "how to order" note in front of everyone in busy channels. Sticky roles stop people dodging punishments by rejoining, and save staff from re-giving roles to regulars who come back.

#Sticky messages

#Set it up

On the dashboard, go to Sticky, click New sticky message, pick the channel, write the message and Post it. The preview shows it at the bottom of the channel.

With commands, run /sticky message add in the channel (or pick a channel) with:

• content: the text, up to 2,000 characters including the header,
• or embed: the name of an embed saved with /embed,
• header: whether to show the "Stickied Message" title (on by default),
• rolepanel: a role panel to add as buttons under it,
• inactivity: wait until the channel has been quiet this long before reposting, from 5 seconds to 7 days.

Stickies never ping anyone, even if they contain mentions.

The sticky message guide walks through it step by step.

#Sticky message commands

#Limits

#Sticky roles

Sticky roles need the Premium plan. Turn them on from the Roles tab of the dashboard's Sticky page, or with /sticky roles set enable:true, and check them with /sticky roles settings.

#Settings

• enable turns sticky roles on or off.
• retention_days is how long Element keeps a member's roles after they leave, from 7 to 365 days (90 by default).
• automatic_deployment gives roles back as soon as a member rejoins. Turn it off to give them back only by hand.
• automatic_deployment_role waits until the member has this role, like your verified role, before giving the rest back.
• allow_harmful_roles lets roles with Administrator or other wide permissions be given back. Only the server owner can change it.
• Blocked roles are never given back. Manage them with /sticky roles block, unblock and blocked.

#Sticky role commands

The sticky roles guide walks through it step by step.

#Common problems

• The sticky doesn't come back. Element needs Read Message History and Send Messages in the channel. With inactivity mode on, it waits for the channel to go quiet first.
• "This channel already has a sticky message". Remove it with /sticky message remove first.
• A stored role wasn't given back. It may be blocked, above Element's role, harmful (with allow_harmful_roles off), or the member left more than retention_days ago.
• Sticky roles stopped working. They need the Premium plan. The server's plan shows on its dashboard overview, and whoever applied it can check with /premium list.

#Turn it off or reset it

• One sticky: /sticky message remove in its channel. All of them: /sticky message clear.
• Sticky roles: /sticky roles set enable:false. Stored roles are deleted after the retention period.

#Guides

• Keep a message at the bottom of a channel
• Give roles back when members rejoin