Role DM

Automatically send a DM when someone gets or loses a role.

On this page

In the panel under: Moderation, Role DM

For each role, you set which private message a member gets when they receive the role, and which one when they lose it again. The two are independent of each other.

Typical cases: a welcome with a task description when someone joins the team. Or an explanation when a time-limited rank has expired.

Create a rule

  1. Enable the module

  2. Add a rule and choose a role

  3. Turn on DM on role add

    Then design the message in the Message Builder.

  4. Optional: DM on role remove

    The same for the opposite case.

  5. Save

Settings per rule

Field Meaning
Role The role the rule reacts to
DM on role add Switch for the message when the role is received
Message on role add The content
DM on role remove Switch for the message when the role is lost
Message on role remove The content

You can also turn on just one of the two directions.

Cooldown

So that a member doesn't get a new DM on every role change, each rule has a DM Cooldown: 6 hours, 12 hours, 24 hours, 1 week or 30 days. Within that time the DM goes out at most once per direction, no matter how often the role is given or taken away.

Setting Meaning
DM Cooldown Applies to all members for whom no role exception matches
Different cooldown per role Members with one of these roles get their own cooldown, for example new members every 6 hours and regulars every 12 hours. Up to 10 roles per rule
Use the longest cooldown If a member has several of these roles, the highest role normally counts. With this switch, the longest of their cooldowns applies instead

Free and Premium

Rules
Free 3
Premium 15

Once the limit is reached, the panel tells you and doesn't allow another rule.

What to keep in mind

Temporary RolesGive a role for a limited time, and it's removed again automatically.The Message BuilderThe editor you use to design almost every bot message yourself.