Greet new members, say goodbye, and give roles automatically.
Before you begin
- You need Manage Server.
- In each message channel, Discortics needs View Channel, Send Messages, and Embed Links.
- Autoroles need Manage Roles and a Discortics role above every role it assigns.
Set up a welcome message
Send it to a channel, or privately with Direct message.
Build a welcome message on the Dashboard
- Open Dashboard → Welcome.
- Open a Welcome configuration, or select Add to start a new one.
- Choose a channel, or turn on Direct message.
- Add text, sections, images, or other blocks, and insert any variables.
- Enable the message and save with the save bar.
- Select Send test and check the channel.
[Insert screenshot here]
The Welcome message builder with a completed preview
Discord edits use plain text with variables. For images and rich layouts, use the Dashboard. Submitting a Discord text edit replaces a rich layout, but opening or cancelling the editor doesn't.
Quick setup: ;welcome set #channel creates and enables a default message in that channel, or resets the one already there. Add --msg for custom text, and --delete 3s to delete it after a delay of three seconds or more.
Welcome options
| Option | What it does |
|---|---|
| Delay until verified | Waits until the member passes verification. Doesn't affect roles |
| Delete after ping | Pings the member, then deletes the message. See Ping on Join |
| Direct message | Sends privately on join. Closed DMs don't stop it working for future members |
A Direct message welcome sends immediately, so it can't use Delay until verified or Delete after ping.
Welcome limits
| Resource | Public | Prime | Custom |
|---|---|---|---|
| Welcome messages per server | 3 | 10 | 25 |
- Each welcome message needs a different channel. One can use Direct message instead.
- Rename or remove configurations from the Dashboard.
Ping on Join (PoJ)
Ping on Join mentions a new member so they get a notification, then deletes the message after at least three seconds. This points new members to your rules without cluttering the channel.
Set up Ping on Join on the Dashboard
- Open Dashboard → Welcome and choose a configuration.
- Choose your welcome channel.
- Include
{{user.mention}}in the message. - Under Mention Settings, allow user mentions.
- Turn on Delete after ping.
- Optional: turn on Delay until verified so only verified members are pinged.
- Save, then select Send test.
[Insert screenshot here]
The Welcome message builder with Delete after ping on
Discortics needs Manage Messages in the channel to delete reliably. The delay is three seconds. To choose your own, use ;welcome set #welcome --msg Welcome {{user.mention}}! --delete 10s.
Set up a leave message
Use it as a public goodbye or a private staff log. You can have one leave message.
Build a leave message on the Dashboard
- Open Dashboard → Welcome and open the leave message.
- Choose a channel.
- Add your message blocks.
- Enable the message and save.
- Select Send test and check the channel.
[Insert screenshot here]
The Leave message builder with a completed preview
Configure autoroles
Configure from the Dashboard
- Open Dashboard → Settings → Auto Roles.
- Choose your Before verification and After verification roles.
- Save with the save bar.
[Insert screenshot here]
The Auto Roles section on Dashboard → Settings
When roles are given
| Verification | Before verification roles | After verification roles |
|---|---|---|
| Off | Not given | On join |
| On | On join | After the member passes the check |
| Bypassed | During the join flow | During the join flow |
You can set both groups while verification is off.
Autorole limits
| Resource | Public | Prime | Custom |
|---|---|---|---|
| Before-verification roles | 5 | 10 | 20 |
| After-verification roles | 5 | 10 | 20 |
These can't be autoroles: @everyone, the muted role, integration-managed roles, roles above Discortics, and roles with risky permissions.
Saving a role picker replaces that group. Clearing a group stops future assignments, but doesn't remove roles members already have.
Variables
Use these in message text as written. The Dashboard also has a variable picker.
| Variable | Result |
|---|---|
{{user.mention}} | Mentions the member |
{{user.username}} | Discord username |
{{user.globalName}} | Display name, or username if none |
{{user.avatarURL}} | Member avatar URL |
{{user.createdAt}} | Account creation time |
{{user.createdAgo}} | Relative account age |
{{user.joinedAt}} | Server join time, welcome only |
{{user.joinedAgo}} | Relative server join time, welcome only |
{{server.name}} | Server name |
{{server.memberCount}} | Current member count |
{{server.iconURL}} | Server icon URL |
{{server.vanityCode}} | Server vanity code |
Invite variables
These need Invite Tracking. Unknown values appear empty.
| Variable | Result |
|---|---|
{{invite.source}} | Invite, vanity URL, unknown, or ambiguous source |
{{invite.code}} | Detected invite code |
{{inviter.mention}} | Mentions the inviter |
{{inviter.username}} | Inviter username |
{{inviter.total}} | Inviter's total credited joins |
{{inviter.real}} | Inviter's current real invites |
{{inviter.left}} | Invited members who left |
{{inviter.fake}} | Invites classified as fake |
For vanity URL and untracked joins, inviter variables show your server's name, icon, and vanity join counts.
Reset Welcome or Leave
Select Reset in the Discord panel and confirm. This turns the message off and removes its channel, content, and delay.
Commands
| Command | What it does | Permission |
|---|---|---|
/settings welcome | Configure welcome messages | Manage Server |
/settings leave | Configure the leave message | Manage Server |
/settings autorole | Choose automatic roles | Manage Server |
;welcome test | Test the first welcome message | Manage Server |
;leave test | Test the leave message | Manage Server |
Tests use your own profile and send to the configured channel. Dashboard tests need all changes saved first.
Troubleshooting
A member didn't get an autorole. Check that the role is still selected, is below Discortics, and isn't managed by an integration. After verification roles only arrive once the member verifies or is bypassed.
The welcome message didn't send. Check that it's enabled, has a channel and a message, and that Discortics has Send Messages and Embed Links. If it's delayed, check that the member has verified.
Roles arrived but the message didn't, or the other way round. Roles and messages run separately. Check the message's Delay and which group each role is in.
The ping message wasn't deleted. Give Discortics Manage Messages in that channel.
The member wasn't notified. Include {{user.mention}} and allow user mentions. With Delay until verified, the ping waits until they verify.
Editing a saved embed didn't change my welcome message. They're separate. Edit the message in Dashboard → Welcome or with Message in /settings welcome.
Prefer one-line commands? See Direct Commands.