Skip to content

Welcome Messages

Someone joins, they get greeted. That is the whole feature.

The greeting can be plain text, or it can be one of your saved message templates, which means embeds, buttons and a custom sender name. Either way the new member’s name, your server name and your member count get filled in automatically.

TierFree
Command/welcome
Who can useAdmins
Also on dashboardYes

Five things get swapped out for the real person each time:

PlaceholderBecomes
{user}A mention of the new member, so they get pinged
{username}Their Discord username
{displayname}Their display name in your server
{server}Your server’s name
{membercount}How many members you now have

If you never write a greeting, the default is:

Welcome {user} to **{server}**! You are member #{membercount}.

Plain text is fine for a one-liner. For anything better, build it in Message Templates and point the welcome at it.

You get everything templates can do: a full embed with a title, colour, fields, thumbnail and footer, buttons underneath, and a custom sender name and avatar. Placeholders work everywhere in it, not just the message text. Put {user} in the embed description, {membercount} in a field, {displayname} in a button label, and they all resolve.

Setting it up:

  1. Build your greeting in the Templates tab, or with /template.
  2. Run /welcome template and pick it from the list.
  3. Run /welcome test to see it.
  1. Pick a channel with /welcome channel channel:#general
  2. Choose what to send. Either /welcome template for a saved template, or /welcome message for plain text. Skip both to use the default.
  3. Turn it on with /welcome toggle enabled:True
  4. Check it with /welcome test, which posts a real greeting using you as the stand-in member.

All of this is on the dashboard too, under Welcome.

The bot needs Send Messages and Embed Links in whichever channel you choose.

Set the channel new members get greeted in.

OptionTypeRequiredDescription
channelchannelYesThe text channel for welcome messages

Use a saved message template as the greeting.

OptionTypeRequiredDescription
templatechoiceNoOne of your saved templates. Leave blank to go back to plain text

Set the plain text greeting.

OptionTypeRequiredDescription
messagetextYesYour greeting, up to 1500 characters. Placeholders work anywhere in it

Replies with a preview using you as the stand-in member.

Turn welcome messages on or off.

OptionTypeRequiredDescription
enabledtrue/falseYesTrue to enable, False to disable

You need a channel set first.

Post a real greeting to your welcome channel, using you as the member. Runs the exact same path a genuine join does, template and all, so what you see is what new members get. Nothing to fill in.

Show the current setup: channel, whether it is on, and whether you are using a template or plain text. Only you see it.

  • Bots that join are skipped. Nobody wants a welcome party for a webhook.
  • Only the new member gets pinged. @everyone and role pings are stripped, so a greeting can never turn into a mass ping.
  • If the channel is deleted, the bot quietly stops rather than erroring on every join. /welcome status flags it.
  • Joins and leaves are logged separately. If you want a record of who came and went, that is Action Logs, not this.