Docs / Guides / Welcome and verify new members

Welcome and verify new members

In short

You will have a tested welcome message with a card, join roles, a verification gate and your rules posted.

Before you start, give the bot Manage Channels and Manage Roles. To test verification at the end, you need a second Discord account.

1. Turn on Welcome

On the dashboard's Services page, turn on the Welcome switch for your server.

While Welcome is off

The bot ignores joins on servers where the service is off.

2. Run setup

Open Welcome's Setup page and press Run setup.

What setup creates and what can stop it
  • #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.

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

3. Write the greeting and design the card

On the Messages page, type the Message on the Welcome tab. To change the card, open Card Studio. Press Save changes in the bar that appears.

Tags, defaults and the card
  • Tags such as {user.mention}, {server} and {member_count} fill in the member and server.
  • The default is "Welcome to {server}, {user.mention}! You are member #{member_count}!".
  • Send as an embed is the default.
  • In Card Studio, Send a welcome card (on by default) attaches the card. There you start from one of 12 templates and pick a background.
  • Each page saves only its own settings.
  • To use another channel, change Welcome channel under Where it goes.

See Set it up for rotating messages, buttons and goodbyes.

4. Give new members roles

On the Roles page, under Roles on join, turn on Give roles on join and press Add a role for each role.

Timing and the roles the bot can give
  • Each role has Give it after (0 is at join) and Take it away after (0 keeps it).
  • 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.
  • When verification is on, join roles are given when the member verifies, not at join.

5. Write your rules

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

Where members see the rules and the length limit
  • Members read them with /rules.
  • Post the rules puts them in a Rules channel.
  • DM the rules to new members sends them on join.
  • Show the rules when members verify (on by default) puts them under the verification message.
  • Each rule can be up to 300 characters.

6. Set up verification

On the Verification page, press Check what changes in the Set it up for me card. Read the list and press Set it up.

What setup changes and how to set it up by hand
  • It makes an Unverified role (or uses one you pick) and a #verify channel that only Unverified members, staff roles and the bot can see. It also makes a Verified role when none is picked.
  • It hides the other channels Unverified members could see, turns verification on and posts the verification message.
  • A channel stays visible when the bot cannot change it or when an Unverified role you picked is allowed there. The list names those channels before you confirm.
  • Members already in the server keep their access.
  • Undo setup deletes only the roles and the channel setup made, puts back the permissions it changed on your own role and restores your previous verification settings.
  • While verification is on, the card is replaced by One-click setup at the top of the page.
  • Channels made later are visible to Unverified members unless they sit in a category setup hid, so run setup again after you add some.

To choose the way by hand, set How members verify to Button, Captcha or Web page. Then set Who has to verify, the Deadline after joining and what happens At the deadline.

7. Check that it works

Run /welcome test to see the greeting as a member would. Then join the server with a second account and go through verification.

What you should see
  • /welcome test needs Manage Server and works once every 20 seconds per server. The reply is visible only to you. Nothing is posted in the welcome channel.
  • The second account sees the verification message and passes the check. After it does, it gets the Verified role and your join roles.
  • Recent activity on the Logs & cleanup page shows the join and the verified event.
  • If the Messages page says "Nobody is being welcomed", the same notice says what is missing, such as a channel or the message text.

Next

Was this page helpful?
YourBot docs Reference tables are generated from the code that is running. Ask in Discord