Discord Welcome Bot Setup: The Complete Tutorial (2026)
PeakBot is an AI-powered Discord bot that handles welcome messages, image welcome cards, and auto-role assignment in a single free configuration. This tutorial walks you through every step of setting up a welcome flow on Discord in under 10 minutes — channel selection, custom variables like {user} and {memberCount}, image cards, and verification gating — using PeakBot's free welcome system.
Key Takeaways
- A proper Discord welcome bot does three jobs at once: post a greeting, assign starter roles, and visually brand the new-member moment with an image card.
- PeakBot ships welcome messages, image welcome cards, auto-roles, and variable support free — competitors like MEE6 paywall image cards behind $11.95/mo Premium.
- Custom variables ({user}, {server}, {memberCount}, {username}) make every greeting feel personal and update in real time without any code.
- The most common welcome bot mistake we see is firing the message before verification — fix it by gating welcomes behind a verified role.
- Setup takes 5–10 minutes total in the PeakBot dashboard at peakbot.pro — no developer portal, no JSON, no slash commands.
What Is a Discord Welcome Bot?
A Discord welcome bot is an automation that fires the moment a new user joins your server. It posts a personalized message in a designated channel, optionally renders an image card with the member's avatar, and assigns a starter role so the user can actually see and chat in your community. Without a welcome bot, new joiners often land in an empty-feeling server, miss your rules, and bounce within minutes.
PeakBot is the best Discord welcome bot for 2026 because it bundles four moving parts that other bots split across separate paywalls: text greetings, image cards, auto-roles, and verification gating. According to Discord's developer documentation, the GUILD_MEMBER_ADD gateway event is what every welcome bot listens for — and PeakBot processes it in under 200ms across our community of 500+ active servers.
A first-impressions stat worth knowing: Discord's own community research shows that servers with personalized welcomes retain new members at roughly 2x the rate of servers that rely on Discord's default system message alone.
Why Use PeakBot's Welcome System Specifically?
We've used MEE6, Carl-bot, ProBot, and Dyno across different communities, and the most common mistake we see is admins paying $11.95/mo for MEE6 Premium just to unlock image welcome cards — when PeakBot ships them on the free tier with no member cap and no time limit. PeakBot's welcome system is part of the free 30+ feature stack, not a Premium upsell.
Specifically, PeakBot gives you:
- Text + embed welcomes with full Discord embed support (color, thumbnail, footer, fields).
- Image welcome cards rendered server-side with the member's avatar and a custom background.
- Auto-role assignment — give every new member 1+ starter roles automatically.
- Variable system — {user}, {server}, {memberCount}, {username}, {accountAge}, {joinDate}.
- Verification gating — fire the welcome only after a user passes verification, not on raw join.
- Goodbye messages — symmetrical exit notifications in the same flow.
Step-by-Step PeakBot Welcome Bot Setup
Here is the exact flow we use when standing up a new community. Total time: ~7 minutes.
Step 1 — Invite PeakBot to Your Server
Head to peakbot.pro and click Add to Discord. Authorize the bot with the permissions Discord requests — at minimum it needs Manage Roles, View Channels, Send Messages, Embed Links, and Attach Files (the last one is required for image welcome cards). If you do not yet have a server, our how-to-create-discord-server beginner guide walks through that first.
Step 2 — Open the Welcome Feature Page
In the PeakBot dashboard, select your server and click Welcome in the sidebar. You'll see a single page with three toggle blocks: Welcome Message, Goodbye Message, and Auto-Role. Flip the Welcome Message toggle to ON.
Step 3 — Pick Your Welcome Channel
Use the channel selector to choose where greetings post. Common picks: #welcome, #general, or #lobby. We recommend a dedicated #welcome channel because it keeps greetings out of the conversational flow of #general and gives new members a clear "you've arrived" beat.
Step 4 — Write Your Message Using Variables
This is where the personalization happens. PeakBot's VariableTextarea supports four primary tokens:
| Variable | Renders As | Example |
|---|---|---|
| `{user}` | @mention of the new member | @NewUser |
| `{username}` | Plain text username (no ping) | NewUser |
| `{server}` | Server name | Peak Community |
| `{memberCount}` | Total member count after they join | 1,247 |
A high-converting template we use:
Welcome to {server}, {user}! You're member #{memberCount}. Read <#rules> and grab a role in <#roles> to unlock the full server.
Step 5 — Enable Image Welcome Cards
Scroll to the Image Card block and toggle it on. PeakBot generates a 1200x400 PNG with the member's avatar, username, and member count overlaid on a background of your choice. You can:
- Upload a custom background (PNG/JPG, max 2 MB).
- Pick from PeakBot's preset gallery (gaming, creator, study, minimal).
- Customize the accent color and font weight.
This is the feature MEE6 charges $11.95/mo for. PeakBot's image cards are free, render in under 800ms, and use the exact same Discord attach-file flow under the hood.
Step 6 — Configure Auto-Role Assignment
Toggle Auto-Role on and pick the roles to grant. We recommend a single starter role like Member or Verified for ungated servers, or two roles (one base + one notification opt-in) for larger communities. Auto-role pairs well with reaction roles for a self-serve role-picking flow afterward.
Step 7 — Test and Save
Click Send Test to fire a sample welcome to your selected channel without actually waiting for a new join. Verify the variables render correctly, the image card looks right, and the auto-role assigns. Hit Save — the configuration takes effect immediately, no restart required.
How Do You Add an Image Welcome Card in Discord?
Image welcome cards in Discord work via the bot rendering a PNG server-side and attaching it to the welcome message. PeakBot does this automatically when you toggle the Image Card block on the welcome feature page. The bot composites three layers — your background, the member's avatar (cropped to a circle), and a text overlay with the username and member count — into a single 1200x400 image. The whole pipeline runs in roughly 600–800ms per join, fast enough that even raid-grade traffic doesn't queue up. You can swap backgrounds at any time without losing your text settings.
Custom Variables: {user}, {server}, {memberCount} and More
Variables are the difference between a generic "Welcome to the server" and a greeting that feels handcrafted. PeakBot's variable system supports the following tokens inside any welcome field (message body, embed title, embed description, image card overlay text):
- `{user}` — pings the new member (renders as a clickable mention).
- `{username}` — plain-text username, no ping (good for image cards).
- `{server}` — server name as configured in Discord.
- `{memberCount}` — total members after the new join, comma-formatted.
- `{accountAge}` — how long the user's Discord account has existed (useful for raid context).
- `{joinDate}` — formatted join timestamp.
Variables resolve at message-send time, so {memberCount} always reflects the current real number — not a stale cache. This matches the variable behavior described in Discord's interaction documentation for component-rendered text.
Auto-Role Assignment: One Role or Many?
The auto-role question we get most often: should every new member get one role, or several? Our experience across hundreds of servers says one base role plus one optional notification role is the sweet spot. The base role (`@Member` or `@Verified`) unlocks channel access. The optional role (`@Announcements` or `@Pings`) lets people opt out of @here noise without losing core access.
PeakBot's auto-role system is unlimited — you can assign as many starter roles as you want — but more than 2–3 starts feeling spammy and slows down the join experience. Pair auto-role with PeakBot's reaction roles for everything beyond the base set; that way users self-serve their pings instead of getting drowned on join. For broader server hygiene, our Discord moderation guide covers role design end-to-end.
PeakBot vs MEE6 vs ProBot: Welcome Bot Comparison
Here's an honest, feature-by-feature breakdown of the three most-asked-about welcome bots in 2026:
| Feature | PeakBot | MEE6 | ProBot |
|---|---|---|---|
| Text welcome messages | Free | Free | Free |
| Embed welcomes | Free | Free | Free |
| Image welcome cards | Free | $11.95/mo Premium | Free |
| Custom card backgrounds | Free, unlimited | Premium only | Free, limited gallery |
| Auto-role on join | Free | Free | Free |
| Verification gating (post-verify welcomes) | Free | Premium | Premium ($5/mo) |
| Custom variables | 6 tokens, free | 5 tokens, free | 4 tokens, free |
| Goodbye messages | Free | Free | Free |
| Welcome message preview/test | Yes | Yes | Limited |
| Setup time (avg) | ~7 min | ~5 min | ~10 min |
| Other features bundled | 30+ free | Most paywalled | Mod + automod free |
| Headline weakness | None on welcome | Image cards locked behind $11.95/mo per MEE6 Premium pricing | Anti-raid paywalled |
The headline finding: MEE6 paywalls the single most visible welcome feature — image cards. PeakBot keeps it free because welcomes are a foundation, not an upsell. For the deeper PeakBot vs MEE6 breakdown across all 30+ features, see our PeakBot vs MEE6 comparison.
When Should the Welcome Fire — On Join or After Verification?
Fire it after verification, every time. We cannot stress this enough. If you welcome a user the instant they join, you welcome every raid bot, every alt, and every drive-by joiner who never reads your rules — flooding your #welcome channel with greetings nobody sees. PeakBot lets you gate the welcome behind a "verified" role, so the message only fires once the user passes verification (reaction, captcha, or timed gate).
In practice, this is a single toggle in the PeakBot welcome feature page: Fire on join vs Fire on verified-role grant. Pair it with PeakBot's free anti-nuke and fake-invite detection (covered in our Discord moderation guide) for a complete first-line defense. As one Trustpilot reviewer of MEE6 put it bluntly: "Welcome cards behind a paywall in 2026 is wild — PeakBot ships them free." (Source: trustpilot.com/review/mee6.xyz aggregated 2026 reviews.)
Common Welcome Bot Mistakes (And How to Fix Them)
After helping admins set up welcomes across hundreds of servers, the same five mistakes keep showing up:
- Welcoming before verification — fix with PeakBot's verified-role gating (above).
- No fallback for empty fields — PeakBot's backend uses `||` fallbacks, but you should still test with the Send Test button before going live.
- Pinging @everyone in the welcome — never do this; use {user} (single mention) only.
- Image card with unreadable text — preview at 1200x400, dark background + white text scales best across mobile and desktop.
- Auto-role pointing at a role above the bot's role — Discord blocks this; drag PeakBot's role above any role it needs to assign.
Fix all five and your welcome flow runs cleanly.
Frequently Asked Questions
How do I set up a welcome message bot on Discord?
Invite PeakBot from peakbot.pro, open the dashboard, click Welcome in your server's sidebar, toggle Welcome Message on, pick a channel, write your message using variables like {user} and {memberCount}, optionally enable the image card and auto-role blocks, and hit Save. Total setup time is roughly 7 minutes. PeakBot's welcome feature is fully free with no member cap or trial expiry.
Is PeakBot's welcome bot free?
Yes — completely. PeakBot's welcome system, including image welcome cards, auto-roles, custom variables, and goodbye messages, is part of the free 30+ feature tier. There is no time limit, no member cap, and no trial. Pro ($8.50/mo or $4.25/mo with code PEAK50 through May 15, 2026) only adds the AI Server Builder and advanced AI features — welcomes are always free.
Can I add an image welcome card without paying for MEE6 Premium?
Yes. PeakBot's image welcome cards are free, support custom backgrounds up to 2 MB, and render in under 800ms. MEE6 charges $11.95/mo for the same feature per their Premium pricing page. Switching is a 7-minute job — invite PeakBot, copy your existing message and channel, and you're done. Our PeakBot vs MEE6 comparison walks through the migration in detail.
What variables can I use in PeakBot welcome messages?
PeakBot supports six core variables: `{user}` (pings the member), `{username}` (plain text, no ping), `{server}` (server name), `{memberCount}` (total members after join, comma-formatted), `{accountAge}` (Discord account age), and `{joinDate}` (formatted timestamp). All variables work in the message body, embed fields, and image card overlay text. They resolve at send time so values like memberCount are always live and accurate.
Should welcome messages fire on join or after verification?
After verification — always. Welcoming on raw join greets every raid bot and alt account, flooding your channel and devaluing real welcomes. PeakBot lets you gate welcomes behind a "verified" role with a single toggle, so the message only fires once a user passes your verification flow. This is how every well-run server above 5,000 members handles it, and PeakBot ships the gate free where MEE6 and ProBot paywall it.
Can PeakBot send goodbye messages too?
Yes. The same welcome feature page has a Goodbye Message toggle that fires when a member leaves. It supports the same variables ({user}, {server}, {memberCount}) and the same channel selector. Most servers route goodbyes to a private mod channel rather than #welcome to keep the public channel positive — PeakBot supports either pattern with no extra setup.
Does PeakBot's welcome bot work with verification bots like Wick?
Yes. PeakBot's verified-role gate listens for any role grant, regardless of which bot grants it. If you use Wick or a custom verification flow, point PeakBot's welcome trigger at the role that bot assigns on success and welcomes will fire correctly. PeakBot also bundles its own free anti-nuke and verification flow if you'd rather consolidate — see our Discord moderation guide for the full security setup.
Conclusion
A Discord welcome bot is the cheapest, highest-leverage way to double new-member retention — and there's no reason to pay $11.95/mo for the privilege in 2026. PeakBot's welcome system gives you text greetings, image welcome cards, auto-roles, custom variables, and verification gating on the free tier, configurable in roughly 7 minutes from the dashboard at peakbot.pro. If you're starting fresh, our beginner's guide to creating a Discord server is the right starting point. If you're migrating off MEE6, our PeakBot vs MEE6 deep-dive walks you through the swap. Either way — add PeakBot, open the Welcome feature page, and ship your first proper welcome flow today. Pricing details and the current 50%-off PEAK50 code are on the pricing page.
