Docs / Welcome / Commands / /welcome test
Admin Server only

/welcome test

Preview your welcome message and card

Usage

Generated
/welcome test

This command takes no options.

Who can run it

Generated
Discord defaultEvery member
Command Access presetServer managers
Always allowedThe server owner and, by default, Administrators
Change itDashboard, Services, Welcome, Commands

The presets keep it for server managers. Server owners and Administrators can always run it. How Command Access works.

What the bot needs

Generated

Welcome is granted these permissions by the invite link. A command that finds one missing replies privately with what it could not do and changes nothing.

View ChannelSend MessagesEmbed LinksAttach FilesManage Roles

Behaviour

Checked against the code 2026-10-01

Shows you the greeting a new member would get, using you as the example member. Requires Manage Server; without it the bot replies "Requires Manage Server." The reply is visible only to you, and nothing is posted in the welcome channel.

Each server can run it once every 20 seconds. Inside that window the bot replies "The preview was just run. Try again in 12s." with the seconds left.

The preview follows the same settings as a real join. It picks from the Rotating messages list when one exists, so two runs can show different greetings. Sent as an embed, you see your avatar, the Server highlights line when that is on, the Start-here channels, the footer "Member #N" and the card as the embed image, with the How it looks settings and the link buttons from the Messages page applied. Sent as plain text, you see the text with the card attached. A rotating message that carries a picture shows the picture instead of the card. When the card cannot be built, the embed preview says "The card could not be rendered." When no message is set at all, the preview uses "Welcome to {server}, {user.mention}! You are member #{member_count}!".

Tags are filled in from your own account. {join_count} shows the join counter as it stands, because a preview does not count as a join, and the inviter tags print Unknown, because a preview has no invite.

On the shared bot, when the greeting is held for review because its text looks like spam or a scam, the bot replies "This message is on hold, so the shared bot does not send it to new members:" with the reasons, instead of the preview.

If the preview fails the bot replies "The preview could not be built. Try again in a moment."

Good to know

  • The preview works before a welcome channel is set.
  • It does not send the welcome DM, give auto roles, post the quest list, pair a buddy, count a join or write a log line.
  • @everyone and @here never ping in the preview, the same as in the real greeting.
YourBot docs Reference tables are generated from the code that is running. Ask in Discord Suggest a correction