Welcome dashboard
The welcome system fires when a member joins. Compose the message (text or rich embed), generate a welcome card image, hand out roles and read analytics — eight tabs cover the full lifecycle.
Before you start
- STANDARD tier or higher
- You have welcome.manage on this server
- SYNTHET has Send Messages, Embed Links and Attach Files in the welcome channel
- For autoroles, SYNTHET has Manage Roles and is positioned above the roles you assign
What you'll see
The page header has a Save settings button that applies whichever tab you're on. Eight tabs cover the system end-to-end.
Overview tab
Lands you here on first open. A 4-tile summary.
Status tiles
- Welcome message — on/off plus channel name. Click Edit to jump to the Message tab.
- Welcome card — on/off plus background style. Click Edit to jump to the Card tab.
- Autoroles — count of configured roles. Click Edit to jump to the Autoroles tab.
- Leave message — on/off and target channel. Click Edit to jump to the Leave tab.
Last 24h
A small line chart of joins versus leaves over the last 24 hours. Hover for hourly numbers.
Message tab
Compose what new members see in the welcome channel.
Mode toggle
Pick text for a plain chat message or embed for a coloured side-bar embed with title, description, image and footer fields.
Editor
- A monospaced editor with placeholder buttons (insert {user}, {server}, {memberCount}).
- Live preview that mimics how the message renders in Discord.
- For embed mode the preview shows the full embed including author, image, fields and footer.
- Mention warning — if you @everyone, the editor flags it before save.
Available placeholders
| Setting | Type | Default | Description |
|---|---|---|---|
| {user} | mention | — | Mention of the joining member. |
| {user.name} | string | — | Plain display name. |
| {user.id} | snowflake | — | Discord ID, useful for staff lookups. |
| {server} | string | — | Server name. |
| {memberCount} | number | — | New member count after they joined. |
| {ordinal} | string | — | 1st, 2nd, 3rd, etc. version of memberCount. |
Card tab
Generate a square image attached to the welcome message. Off by default.
Background
- Pre-set tile gallery — 12 built-in backgrounds.
- Solid colour — picks any hex.
- Custom URL — paste a 1024x512 image (PREMIUM).
Layout options
Circle, rounded square or hexagon.
Used for the username highlight and the bottom bar.
Example: #5865F2
Renders 'Member #42' under the username.
Fallback text used on the card itself, e.g. 'Welcome to {server}!'.
Live preview
Right-side panel shows the rendered card with a sample username and avatar. Updates as you tweak fields.
Autoroles tab
Roles every new member receives automatically.
Role list
- Click + Add role to insert a role chip.
- Each chip has a delete X.
- Bot/human gating: separate sections for roles that go to bots vs humans only.
- Trust gate (PREMIUM) — only assign once a member passes verification or X seconds in server.
Diagnostics banner
If the bot's role is below any role you've added, a red banner explains the hierarchy issue and links to the role settings page in Discord.
Leave tab
Optional goodbye message when a member leaves or is kicked.
Toggle
Off by default. Once enabled the structure mirrors the Message tab — text or embed, placeholders, live preview.
Trigger filters
| Setting | Type | Default | Description |
|---|---|---|---|
| On voluntary leave | Toggle | On | Member used Leave Server. |
| On kick | Toggle | Off | A staff member kicked them. |
| On ban | Toggle | Off | A staff member banned them. Not recommended unless you also use anonymisation. |
| On account deletion | Toggle | Off | Discord-side account closure (rare). |
Channel routing
Leave messages can post to a different channel from joins. Useful when you want public welcomes but private goodbyes.
Analytics tab
Lightweight charts. Refreshes when you switch into the tab.
Header tiles
- Joins (7d).
- Leaves (7d).
- Net change.
- Retention rate — % of joiners still here after 7 days.
Chart panel
- 30-day join/leave dual bar chart.
- Cohort table — join week vs % still in server at week 1, 4, 12.
- Top inviters (requires Invite Tracker utility to be on).
Settings tab
Channel routing, throttle and edge-case fallbacks. Click Save settings to apply.
Channels
Text channel where the welcome message posts.
Text channel where leave messages post. Often equals welcome.
If the welcome channel is missing or unreachable, DM the welcome message instead.
Throttle and raid hold
| Setting | Type | Default | Description |
|---|---|---|---|
| Throttle window | Seconds | 0 | Skip welcome messages for N seconds after a previous one. Defends against welcome-spam during raid joins. |
| Anti-raid pause | Toggle | On | When the security module triggers a raid lockdown, welcome messages are paused automatically. |
| Mention suppress | Toggle | Off | Strip user mentions from welcome embeds while raid pause is active. |
Advanced section
Per-locale overrides (PREMIUM) and webhook output (PRO) live behind the advanced collapsible.
Audit tab
Read-only join/leave history plus admin events.
Filters
- Event — joined, left, kicked, banned, configured, autoroles changed.
- Member — search by user.
- Date range — last 24h, 7d, 30d, custom.
Common questions answered here
- Did the welcome message actually fire for member X?
- Why didn't autorole Y get assigned?
- Who turned the leave message off two weeks ago?
Common tasks
Set up your first welcome message
Out-of-the-box flow.
- Open DashboardWelcomeSettings and pick the welcome channel.
- Switch to the Message tab and stay on text mode.
- Type something like Welcome {user} to {server}! You're our {ordinal} member.
- Click Save settings.
- Test by leaving and rejoining the server, or use /welcome test to simulate a join without leaving.
Add a Member autorole
Hand out a baseline role on join.
- Open DashboardWelcomeAutoroles.
- Click + Add role and pick the role.
- If the diagnostics banner appears, move SYNTHET's role above that role in Discord and click Refresh.
- Save settings.
Survive a join raid without spamming the channel
Combine welcome with security.
- Open DashboardWelcomeSettings.
- Set Throttle window to 5 seconds.
- Make sure Anti-raid pause is on.
- If you also have the security module, configure its raid threshold so the pause activates automatically.
- Save settings.