💬 Welcome & Goodbye
Welcome & Goodbye messages shape the first and last impression your server makes. The agent can greet each new member publicly, send them a private DM, post a rendered welcome card with their avatar, and acknowledge departures — all configured from the Fren One webapp.
Overview
When configured, the agent can:
- Post a welcome message in a channel of your choice when a member joins
- Send a private welcome DM to the new member (independently of the channel message)
- Render the message as a rich embed with the member's avatar, a banner image, and a thumbnail
- Attach a welcome card — a generated image with the member's avatar and member number
- Post a goodbye message and/or send a goodbye DM when a member leaves
- Hold the greeting until the member passes verification, and clean it up if they leave right away
Configuration
To configure welcome and goodbye messages:
- Open your project in the Fren One webapp.
- Select the Discord server you want to configure.
- In the sidebar under Agent Configuration, select Onboarding, then the Welcome & Goodbye tab.
- Toggle on the cards you want: each of the four messages (channel welcome, welcome DM, channel goodbye, goodbye DM) has its own on/off switch.
Welcome message
Toggle "Send a message when a member joins" on to greet members publicly.
| Option | Description |
|---|---|
| Welcome channel | The channel where the welcome message is posted. Required when the toggle is on. |
| Welcome message | The message body. Supports formatting, server custom emojis, and the variables below. Required. |
| Send as a rich embed | Wraps the message in a Discord embed instead of plain text. |
| Include the member's avatar | Embed only. Shows the joining member's profile picture as the embed thumbnail. Default: on. |
| Embed image | Embed only. Optional full-width banner. Recommended: a wide image, e.g. 1920×1080. |
| Embed thumbnail | Embed only. Optional square image. Overrides the member's avatar when set. |
Welcome card
Enable "Attach a welcome card" to post a generated image card with the new member's avatar and member number below the welcome message.
| Option | Description |
|---|---|
| Card design | Nine preset designs (Midnight, Aurora, Ember, Neon, Carbon, Terminal, Blueprint, Onyx, Ivory) plus three custom styles: Custom solid, Custom gradient, and Custom glow. Default: Midnight. |
| Custom colors | Shown for custom styles only. Per-slot color pickers — background, text, secondary text, and ring, plus a gradient end or glow color depending on the style. |
| Preview | A live rendering of the card so you can check the design before saving. |
Greeting behavior
Two checkboxes control when the greeting appears and how long it stays:
| Option | Description |
|---|---|
| Wait for verification before greeting | Holds the welcome message and DM until the member completes verification. Only applies when Bot Protection is enabled. Default: on. |
| Remove the welcome message when a member leaves quickly | Deletes the welcome message if the member leaves within the cleanup window. Default: on. |
| Cleanup window | How long the quick-leave cleanup watches for a departure. 30 seconds to 24 hours; default 5 minutes. |
Welcome DM
Toggle "Send a DM when a member joins" to privately message each new member. The DM is independent of the channel welcome — you can enable either or both.
{user} mentions don't render inside DMs — use {username} in DM messages instead.
Goodbye message and goodbye DM
Toggle "Send a message when a member leaves" for a public goodbye, with its own Goodbye channel, message body, and the same rich-embed options as the welcome message. Toggle "Send a DM when a member leaves" for a private farewell.
Discord only allows the agent to DM a member who still shares a server with it. A goodbye DM can fail to deliver if your server was the only one you had in common.
Message variables
Use these variables in any welcome or goodbye message:
| Variable | Inserts |
|---|---|
{user} | A clickable @mention of the member. |
{username} | The member's username, without a mention. |
{guild} | The server name. |
{member_count} | The current member count. |
{member_ordinal} | The member's join position, such as 100th. |
Welcome {user} to {guild}! 🎉 You're our {member_ordinal} member. Say hi in the introductions channel and check the rules first.
How it works in Discord
When a member joins, the agent runs its full onboarding sequence — blacklist screening and impersonation checks first, then verification, roles, and invite tracking — and posts the welcome message last. With "Wait for verification before greeting" enabled, the greeting appears only after the member completes the captcha, so unverified accounts are never welcomed publicly.
The welcome appears as plain text or an embed, with the welcome card image attached below it when enabled. If the member leaves within the cleanup window, the agent removes the greeting so your welcome channel doesn't accumulate messages for members who never stayed.
Saving your changes
This page uses a batched save — edits stay local until you select Save in the bar that appears at the bottom of the page. Leaving the page with unsaved changes shows a warning first.
Best practices
- Keep the channel welcome short and put longer content (rules, links, next steps) in the welcome DM.
- Use
{member_ordinal}to celebrate growth milestones without any extra work. - Leave quick-leave cleanup on in busy servers so drive-by joins don't clutter the channel.
- Match the welcome card design to your server's branding — the custom styles accept your exact colors.
Troubleshooting
Welcome messages aren't appearing?
- Check the master toggle and that a Welcome channel is selected.
- If Bot Protection is on and "Wait for verification before greeting" is enabled, the greeting only posts after the member verifies.
- Confirm the agent can view and send messages in the welcome channel.
The embed shows the wrong thumbnail?
- A custom Embed thumbnail overrides the member's avatar. Clear it to show the avatar again.
Welcome DMs aren't delivered?
- Members with DMs disabled for the server can't be messaged — this is a Discord privacy setting the agent can't bypass.
Related features
- 🧩 Bot Protection - Verify new members before they're greeted
- 👤 User Blacklist - Screen joins before any welcome is sent
- 🎭 Role Manager - Grant roles automatically when members join