Docs / Core Services / Welcome / Set it up
Built in 13 commands 58 settings

Welcome: Set it up

In short

Turn on Welcome, let the Setup page make the channels, write the greeting and test it. Goodbyes, DMs, auto roles, verification, rules and quests are optional extras.

The dashboard's health check expects: Welcome channel. It shows a warning while one of these is missing or points at something deleted. The steps below say what each one does.

Follow these steps once to get welcome messages working. Each step names the dashboard page or slash command it uses.

The Welcome pages in the dashboard

The Welcome service has its own pages in the dashboard, in five groups:

  • Overview
  • Verification, Rules and Roles
  • Messages and Card Studio
  • Role menus, Engagement and Quests
  • Logs & cleanup and Setup

Each page saves only its own settings.

1. Turn on Welcome

Open the dashboard and choose your server. On the Services page, turn on the Welcome switch.

If Welcome is off

The bot ignores joins on servers where the service is off, whatever the settings say.

2. Run setup

Open the Setup page and press Run setup. It makes a #welcome channel and a #welcome-logs channel for you.

What setup creates
  • #welcome: members can read it, only the bot posts.
  • #welcome-logs: hidden from members.
  • A sample "👋 Welcome System Active" embed, posted in #welcome.
  • On a first run, it also switches on the rich embed, the welcome card, the first-message celebration and the server highlights.

Later, Re-run setup only repairs the channels and leaves your feature settings alone.

If setup stops

If the bot cannot create channels, the page says "The bot is missing Manage Channels or Manage Roles. Grant them and run setup again."

If the bot cannot post in #welcome, the page says so and warns that greetings would fail the same way.

3. Choose the welcome channel

Skip this step if setup made the channels in step 2. To use a channel you already have, open the Messages page and choose the Welcome channel under Where it goes on the Welcome tab.

Default channel, permissions and the slash command

When nothing is saved yet, the page pre-selects your server's system channel, but nothing is written until you save.

The bot must be able to see the channel and needs Send Messages and Embed Links there.

From Discord, /welcome set channel #channel does the same.

4. Write the greeting

Type it in the Message box on the Messages page, or run /welcome set message.

Tags, conditions and rotating messages
  • Tags: {user}, {user.mention}, {user.name}, {user.id}, {server}, {member_count} and {created_at}. All tags and conditions under each message lists the rest.
  • Conditions such as {if user.returning}...{else}...{end} work too.
  • The default is "Welcome to {server}, {user.mention}! You are member #{member_count}!".
  • For variety, open Rotating messages: up to 25 greetings, each with text, an https picture link or both. Set Order to "Random" or "In order, one after another".
  • While that list has entries, the single Message box is not used.

5. Choose the look

Pick how the greeting appears: Send as an embed (the default) or plain text, plus the image card.

Embed and link buttons
  • Send as Embed (the default) gives the colour bar, the avatar thumbnail and the Member #N footer.
  • How it looks sets the Colour, a title, an author line, pictures, fields and the footer.
  • Link buttons adds up to 3 buttons.
  • The previews beside each message show it as the bot will send it.
The welcome card and extras
  • The image card is designed in the Card Studio. Send a welcome card (on by default) attaches it.
  • You start from one of 12 templates and pick a background: the library, a colour or gradient, your own upload or a link. Then change the text, the avatar and the other layers.
  • An animated GIF or WebP background makes an animated card.
  • Server highlights (the member count and boost level) and up to 5 Start-here channels are on the Messages page, under Extras on the Welcome tab. They show while the greeting is sent as an embed.

6. Save

Press Save changes in the bar that appears once you change something. It saves only that page.

What the page can tell you after saving
When The page says
A channel or role could not be applied "Saved, but these were not applied because this server does not have them: ..."
A role is one the bot must never hand out "Saved, except these roles, which cannot be handed out automatically: ..."
Discord could not be reached (the page keeps the channels as they were) "Discord could not be reached. Nothing about your channels was checked, try again in a moment."

When a save has more than one of these problems, the page lists all of them.

7. Test it

Run /welcome test in Discord to see the greeting as a member would.

Limits and what to check next
  • /welcome test needs Manage Server and works once every 20 seconds per server.
  • After the first real join, the Overview page shows the week's joins.
  • Recent activity on the Logs & cleanup page shows the recent join, leave and verified events.
  • The Messages page says "Nobody is being welcomed" when no channel is set and DMs are off, or when the message is empty. Needs your attention on the Overview can list the same problem, with a Fix in Messages link. Follow the hint on the page to fix it.

If something does not arrive, see Troubleshooting.

Optional: Goodbye messages

On the Messages page, Goodbye tab, turn on Send a goodbye, or run /welcome set goodbye true.

Goodbye channel, message and card

Pick a Goodbye channel or leave it as the welcome channel, edit the Message and add Rotating messages if you like. The bot appends how long the member stayed unless the text already uses {user.member_for}. Send as can make it an embed, and Goodbye card sends the goodbye card from the Card Studio with it.

Optional: Welcome DM

On the Messages page, DM tab, turn on Send a welcome DM (or run /welcome set dm true) and edit the Message.

Embed, card and who gets it

It works without a welcome channel. Send as can make it an embed with link buttons, and Include the welcome card attaches the card. Members who block DMs from server members do not get it.

Optional: Auto roles

On the Roles page, under Roles on join, turn on Give roles on join and press Add a role for each role. Or run /welcome set autorole @role, which also turns it on.

Timers, existing members, sticky roles and refused roles
  • Each role has Give it after and Take it away after, up to 365 days each.
  • For Give it after, 0 is at join. With 30 days, 90 days or 1 year, it makes a role for time in the server.
  • For Take it away after, 0 keeps the role. A week suits a newcomer role.
  • Under Members already here, count the members who joined before you set this up. Then start it to give them the roles by their own join dates.
  • Bots that join gives bots roles of their own and a line in the log channel.
  • Under Sticky roles, Restore roles when a member rejoins gives returning members their old roles back, except a role that is taken away after a while.
  • The bot's own role must sit above every role it hands out. Roles with Administrator, Manage Roles, Manage Server, Manage Channels, Ban Members, Kick Members, Manage Webhooks or Mention Everyone are refused.
  • The same page sets the roles members can give themselves with /roles.

Optional: Verification

On the Verification page, switch on Turn on verification. Pick the Verification channel and the Verified role, write the Message and choose How members verify.

All the verification settings
  • How members verify: Button, Captcha or Web page.
  • Under Who has to verify, Applies to is everyone, or only suspicious accounts: younger than the Suspicious below days or without an avatar.
  • Write your rules on the Rules page.
  • Save, then press Post the message to publish the verification panel with its Verify button.
  • Lock your channels behind the Verified role.
  • Auto roles, remembered roles and the buddy pairing wait until the member verifies. The greeting itself still posts at join.

Optional settings:

  • a Button label in place of Verify
  • an Unverified role held until they verify
  • a Deadline after joining in minutes with a Reminder DM
  • what happens At the deadline: Kick, Ban, Nothing or Hold with a Hold role
  • a new captcha image every so many seconds
  • DM the verification steps on join

Optional: Rules

On the Rules page, under Your rules, give them a Title, write up to 25 rules with Add a rule and save.

Where members see the rules
  • Members read them with /rules.
  • Post the rules puts them in a Rules channel and updates that copy the next time.
  • DM the rules to new members sends them on join.
  • Show the rules when members verify puts them under the verification message.

Optional: Quests

On the Quests page, press Turn quests on. Pick the Quest channel or keep Use the welcome channel, then add tasks.

Tasks and rewards

Use the four defaults adds Send a Message, Join Voice, Add a Reaction and Say Hello. A quest holds at most 15 tasks.

Under How it gets done, each task picks one of:

  • Automatic: they send a message
  • Automatic: they join a voice channel
  • Automatic: they add a reaction
  • Automatic: they post an introduction
  • Manual: staff mark it done

Add rewards (Give a role, Post a message or Give XP) that fire on one task or on Quest complete (all tasks done).

New members get the quest list when they join and check progress with /quests list. Staff complete manual tasks with /quests admin-complete.

Optional: More

Other pages cover logs, cleanup, engagement and role menus.

Logs, cleanup, engagement and role menus
  • The Logs & cleanup page: one line per join and leave in a Log channel and the join counter.
  • Delete it later, under Extras on the Messages page: deletes greetings after a while.
  • The Engagement page: the First-message celebration with its 🎉 reaction, welcome-channel shout-out and role.
  • Also on Engagement: Member milestones with your own list of member counts, and the Buddy system with a Buddy role and an Introduction.
  • The Role menus page: self-assign role buttons, dropdowns and reaction menus.
12 optional features with their own switch
  • Join and leave log: welcome log
  • Goodbye channel: goodbye message (when goodbye enabled is on)
  • Milestone channel: milestone posts (when milestone enabled is on)
  • Roles to give: auto-assigned roles (when autorole enabled is on)
  • Give a role for it: first message role (when first msg enabled is on)
  • Verification channel: verification (when verify enabled is on)
  • Verified role: verified role (when verify enabled is on)
  • Buddy role: buddy pool role (when buddy enabled is on)
  • Quest channel: quest posts (when quest enabled is on)
  • Quest reward role: quest reward role (when quest enabled is on)
  • Boost channel: boost message (when boost enabled is on)
  • Boost role: boost role (when boost enabled is on)
Was this page helpful?
YourBot docs Reference tables are generated from the code that is running. Ask in Discord