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 2026 m. lapkričio 18 d.10 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

  1. 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.

  2. 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.

  3. Pick the channel and the type

    Select your welcome channel under Channel and set Channel-Type to join. The other types are leave, boost and unboost. For a second message in the same channel, add the channel again with another type.

  4. 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.

  5. 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.

  6. 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.

A welcome message with the welcome button. tobi pressed it, so the bot posted the second message.

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.

  1. 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?

  2. 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.

  3. Or start from a finished design

    Discover pre-made designs opens a library of cards you can use as they are or adjust.

  4. 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.

A welcome card, generated for each new member from your design.

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.

Auto-role settings of the welcome module
SettingWhat it does and what to pick
Give roles on joinThe 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 boostersExtra 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 free

Free on our Starter plan. A short ad video every 14 days keeps the bot online.