How to set up a welcome bot on Discord
A welcome bot greets every new member in the channel you choose, with your text or a card that carries their name and avatar. It can hand out a first role and post when someone leaves or boosts. All of it comes from the welcome module of your SCNX bot, and it works alongside Discord's own Onboarding.
Updated 18. november 202610 min read
On this page
The short version
- The welcome message is posted in a channel you pick, as text, an embed or a generated card.
- New members get their first role automatically, right away or after they accept your rules.
- Leave and boost messages come from the same module, each with its own channel and text.
What you need
- Your own bot on SCNX. Creating one takes about two minutes
- A channel for welcome messages where the bot can view the channel, send messages and embed links
- For auto-roles: the Manage Roles permission, and the bot's role above the roles it hands out
What Discord does on its own
Discord can post a system message when someone joins, a random line such as "mira just showed up". You choose the channel in the server settings, and you cannot change the wording, add your rules or mention a role.
Community servers also get Onboarding, a short set of questions for new members that hands out channels and roles based on the answers. It is good at sorting people and says nothing in your chat.
A welcome bot covers the part in between: a message in your words, in public, the moment someone arrives. Most servers end up using a bot message and Onboarding together. Further down is how to combine them.
Set up the welcome message
Switch on the module
Open Modules in the Discord-Bot section of your dashboard, find Welcome and Boosts and switch it on. Save your changes. The bot reloads once.
Open the channel configuration
The module has three configuration files. Open Channel and add an entry. Every entry is one message in one channel for one event.
Pick the channel and the type
Select your welcome channel under Channel and set Channel-Type to
join. The other types areleave,boostandunboost. For a second message in the same channel, add the channel again with another type.Write the message
The Message field opens the message editor. Write plain text or build an embed with a title, a color and an image. The next section lists the placeholders for the member's name and your member count.
Decide on the welcome button
With Welcome-Button on, the message gets a button, by default labelled Say hi 👋. The first member who presses it triggers a short message in a channel you choose, and the button goes inactive. It gives regulars an easy way to say hello.
Save, reload and test
Save and confirm Reload configuration now. Then join with a second account, or ask a friend to. The bot posts the message as soon as they arrive.
Illustration. The real interface may look different.
Welcome messages for bots are skipped by default (Ignore bots?). If a member leaves within seven days, the bot deletes their welcome message again. You can switch that off with Delete welcome message. Both settings are in the module's Configuration file.
Placeholders for the message
Placeholders are replaced when the message is sent. Type them into the text or pick them from the parameter list in the editor. They work in welcome, leave and boost messages alike.
%mention%- A mention of the member. In a welcome message this also notifies them.
%tag%- The member's username as text, without a ping. The better choice for leave messages.
%servername%- The name of your server.
%guildMemberCount%- The number of members on your server, without bots.
%guildUserCount%- The number of users on your server, bots included.
%joinedAt%- The date the member joined.
%createdAt%- The date the member's Discord account was created.
%memberProfilePictureUrl%- The address of the member's avatar. Use it as the thumbnail or image of an embed.
%boostCount%- The number of boosts your server has. Useful in boost messages.
A good welcome message is short. Greet the member by name, point to the one channel they should read first, and stop. Three links and a paragraph of rules get skipped.
If the same sentence for every arrival gets dull, switch on Random messages? for the channel and add a few variants in the Random messages file, each with the type join. The bot then picks one of them every time and ignores the fixed message.
Welcome cards with name and avatar
A welcome card is an image the bot generates for each new member, with their avatar and name on your background. On SCNX this is part of the message editor and is called dynamic image generation.
Switch it on for the message
Open the welcome message in the editor, find Dynamic image generation and turn on Enable dynamic image generation for this message?
Design the card
Click Open image editor. Upload a background or pick a color, then place text and image elements on the canvas. The recommended size for a background is 700 x 300 pixels. In text elements you can use the same placeholders as in the message, and the member's avatar is available as an image.
Or start from a finished design
Discover pre-made designs opens a library of cards you can use as they are or adjust.
Save and reload
The card appears in the first embed of the message. If the message has no embed, the bot attaches it as a file.
Illustration. The real interface may look different.
On our free Starter plan, image generation can be limited or paused while our servers are under heavy load. The text of the message is still sent.
Auto-roles for new members
Auto-roles are in the module's Configuration file, in the Auto-Roles category.
| Setting | What it does and what to pick |
|---|---|
| Give roles on join | The roles every new member gets. One role like Member is usually enough. |
| Immediately give roles, instead of waiting for rules acceptance? | On by default. Turn it off if your server uses Discord's rules screening: the bot then waits until the member has accepted your rules. |
| Treat join roles as base roles (auto-restore) | Off by default. When on, the bot gives a join role back if someone removes it and checks all members once a day. Leave it off if moderators ever take the role away on purpose. |
| Give additional roles to boosters | Extra roles for members who boost, on top of the booster role Discord assigns. The bot takes them away again when the member removes all boosts. |
Two things in Discord decide whether this works. The bot needs Manage Roles, and its own role must sit above every role it hands out in the role list of your server settings. If roles are missing, check the order first.
Join roles are only given to people who join from now on. For members who are already there, use the Massrole module of your bot.
Keep permissions in mind: a role every newcomer gets automatically should not unlock anything you would not show a stranger.
Leave and boost messages
Leave messages work like welcome messages. Add another entry in the Channel file, pick the channel and set Channel-Type to leave. Many servers send them to a staff channel, where they help spot a wave of people leaving, and keep the public chat free of goodbyes.
Use %tag% in leave messages. A mention of someone who is no longer on the server often does not show their name.
For boosts, add entries with the type boost and unboost. The boost message is sent when a member boosts for the first time, the unboost message when they remove all their boosts. A second boost from the same member does not trigger another message, which is a limitation on Discord's side.
Discord's Onboarding and how it fits
Onboarding is a Discord feature for Community servers. You set it up in the server settings under Onboarding. It has three parts: default channels every new member sees, questions whose answers assign channels and roles, and a server guide with a welcome note and first tasks. Discord asks for at least seven default channels, and @everyone must be able to read and write in at least five of them.
Members can change their answers later under Channels & Roles at the top of your channel list.
Onboarding and a welcome bot do different jobs, so most servers run both. Let Onboarding sort people into interest roles and channels, and let the bot post the greeting and give the one role everybody gets.
- If you use rules screening
- Turn off Immediately give roles, instead of waiting for rules acceptance? so nobody gets the member role before accepting your rules.
- Keep the two sets of roles apart
- Do not offer a role in an Onboarding question that the bot also gives on join. Our docs note that join roles can currently overwrite or remove roles a member picked in Onboarding. Until that is fixed, give only your base role through the bot and leave interest roles to Onboarding.
- Avoid double greetings
- If the bot greets new members, switch off Discord's own system welcome message, or point it at another channel.
When something does not work
- No welcome message is sent
- Check that the channel has an entry with the type
join, that you reloaded the configuration, and that the bot can view the channel, send messages and read the message history there. For embeds it also needs Embed Links. - The bot posts "Message not found"
- The entry has no message. Either the Message field is empty, or Random messages? is on and the Random messages file has no entry with the same type.
- Members do not get their role
- Move the bot's role above the join roles and check that it has Manage Roles. If Immediately give roles is off, the role only arrives after the member accepts your rules.
- A join role keeps coming back
- That is Treat join roles as base roles (auto-restore) doing its job. Switch it off before you remove the role from someone by hand.
- The welcome card is missing or shows an error image
- Check the design in the image editor. On our free Starter plan, image generation can be paused under heavy load.
- Bots do not get a welcome message
- Ignore bots? is on by default. Most servers want it that way.
Other ways to do it
Almost every general-purpose bot has a welcome feature, and for a single message any of them will do. Check which features of their welcome cards are free before you design one.
In your own code, a welcome message is a handler for the member-join event with one send call. Discord only delivers that event to bots with the Server Members intent enabled, and the bot has to run all day to catch every arrival.
Common questions
- Is the welcome bot free?
- Yes. The welcome module is part of your bot and free on our Starter plan, including auto-roles, leave messages and welcome cards. On that plan, image generation for cards can be paused while our servers are busy.
- Can the welcome message be an embed with an image?
- Yes. The message editor builds plain text or embeds with title, color, thumbnail and image, and it can generate a card with the member's avatar and name for every arrival.
- Can I send new members a DM?
- Yes, with Send DM on join? in the module's configuration. Use it sparingly. Many members have DMs from servers switched off and never see it, and others read it as spam.
- Can the bot give several roles on join?
- Yes. Give roles on join takes a list of roles. Every role in it must sit below the bot's role.
- How do I give the role to members who joined before?
- Join roles only apply to new arrivals. For everyone already on the server, use the Massrole module of your bot, or switch on Treat join roles as base roles (auto-restore), which hands missing join roles to all regular members.
- Why did a welcome message disappear?
- The member left within seven days of joining, and the bot removed their welcome message. You can switch that off with Delete welcome message.
- Does this work together with Discord's Onboarding?
- Yes. Onboarding assigns channels and interest roles from the member's answers. The bot posts the public greeting and can wait with its role until the member has accepted your rules.
- Can I have different welcome messages?
- Yes. Switch on Random messages? and add several messages of the type join. The bot picks one of them for each new member. You can also post welcome messages in more than one channel.
Start with a free bot
Log in with Discord, add your server and create your bot. The dashboard walks you through each step.
Get started for freeFree on our Starter plan. A short ad video every 14 days keeps the bot online.