Docs / Core Services / Welcome / Troubleshooting
Built in 13 commands 58 settings

Welcome: Troubleshooting

In short

Fixes for greetings that do not arrive, missing cards and DMs, roles that are not given and setup errors.

Nobody is being welcomed

Why: The Messages page shows "Nobody is being welcomed" when a join would produce nothing. One of these is true:

  • No welcome channel is set and the welcome DM is off.
  • A channel is set but the welcome message is empty.
  • The DM is on but its message is empty.

Fix: Open the Messages page. On the Welcome tab, pick a Welcome channel under Where it goes or turn on Send a welcome DM, then write the Message. The Overview page shows the same problem under Needs your attention, with a Fix in Messages link. Also check that Welcome is switched on: the bot ignores joins while the Welcome service is off.

The bot cannot post in the welcome channel

Why: The Welcome pages check the bot in the channel and warn when it cannot see the channel, post there, send embeds or attach the card. The /welcome set channel command does not check this for you.

Fix: In Discord, give the bot View Channel, Send Messages, Embed Links and Attach Files in that channel, or pick another channel on the Messages page. If the page shows a banner with Fix with one click, use it.

I deleted the welcome channel

Why: The page tells you the welcome channel no longer exists, and greetings go to the server's system channel until you pick another one. If the server has none, or the bot cannot post in it, greetings cannot be sent.

Fix: Pick a new Welcome channel on the Messages page, or press Run setup on the Setup page to make a fresh #welcome.

The greeting is held and not sent

Why: On the shared YourBot, Welcome text that looks like invite spam or a scam is held for review and not sent. This covers the welcome message, the DM, the card text and the rules.

Fix: Run /welcome test or read the /welcome set message reply: both tell you when text is held and give the reasons. Change the held text on the Messages page until the reasons are gone, for example by removing the invite link or the scam wording. Then run /welcome test again. Or use a custom bot: a custom bot is never held.

New members get no greeting during a raid

Why: While Sentinel's raid mode is on, Welcome holds greetings. A member who joins during a raid is not greeted later and gets no greeting, card, DM, quest list, buddy pairing or first-message celebration.

Fix: Turn off Hold greetings during a raid on the Verification page to keep greeting during a raid.

What still happens during a raid

The join log still gets a line that says why. Auto roles are still given during a raid.

The welcome card is missing

Why: There are several causes:

  • The bot lacks Attach Files in the channel.
  • The card took too long to build, so the greeting went out without it.
  • The chosen welcome message has its own picture, which is shown instead of the card.
  • On the shared YourBot, the card text is held for review.
  • Send a welcome card is off.

Fix: Give the bot Attach Files in the channel and check Send a welcome card in the Card Studio. Remove the message picture if you want the card. Run /welcome test to see what members get.

Auto roles are not given

Why: The usual causes:

  • Roles on join is off.
  • The bot's role sits below the role it should give.
  • The role is refused: @everyone, a role managed by an integration or one with a dangerous permission such as Administrator or Ban Members.
  • The role has a Give it after wait. A member who leaves before the wait ends gets nothing.
  • Verification is on, so roles wait until the member verifies.

A role that later moves above the bot, or gains a dangerous permission, is skipped without an error message.

Fix: Turn on Give roles on join on the Roles page and add the role. In Discord, open Server Settings, Roles and drag the bot's role above every role it gives. Run /welcome set autorole @role to see the exact reason a role is refused.

A member did not get the welcome DM

Why: Members who block DMs from server members do not receive it, and nothing else happens. The DM is also not sent when its text is empty, or when the shared YourBot holds it for review.

Fix: Check that Send a welcome DM is on and that the Message on the DM tab has text. Ask the member to allow DMs from server members. Consider also greeting them in a channel.

Run setup says the bot is missing permissions

Why: Discord refused to create the #welcome channel. The Setup page then says "The bot is missing Manage Channels or Manage Roles. Grant them and run setup again."

Fix: Give the bot Manage Channels and Manage Roles in Server Settings, then press Run setup again. It only repairs the channels and leaves your settings alone. See also the setup check.

The page says "Saved, but these were not applied"

Why: A channel or role you picked no longer exists in the server. A role the bot must never hand out is reported as "Saved, except these roles, which cannot be handed out automatically: ...".

Fix: Pick a channel or role that exists (or a role without dangerous permissions) and press Save changes again. If the page says "Discord could not be reached. Nothing about your channels was checked, try again in a moment.", wait a moment and save again.

The /welcome test command says to try again

Why: Each server can run /welcome test once every 20 seconds.

Fix: Wait for the number of seconds the reply gives and run it again. The command also needs Manage Server.

Goodbyes stopped when many members left

Why: When 5 or more members leave within 10 seconds, such as in a prune, goodbyes pause. One message a minute in the goodbye channel says how many members left, and the Log channel gets one line a minute.

Fix: Wait for the burst to pass. Goodbyes return to normal once it is over, and nothing is broken.

Still stuck? Run /yourbot check in your server first: it lists every permission and setting the bot is missing. Then ask in our Discord with what you tried. Ask in Discord
Was this page helpful?
YourBot docs Reference tables are generated from the code that is running. Ask in Discord