Welcome Messages

Overview

Sent to a channel of your choice whenever a new member joins. Use plain text with variables, or a saved embed.

Petto welcomes Mia to Petto Land in the welcome channel and tells her she is member 1841 — In Discord: the welcome Petto posts when a member joins.

In the dashboard, the welcome, leave and boost messages are side by side under Security → Join Gate → Messages, each with a live preview of how it looks in Discord.

The Messages tab of the Onboarding page with the welcome, leave and boost messages of Petto Land and their previews — Dashboard → Security → Join Gate → Messages: the welcome, leave and boost messages, each with a live preview.

Commands

!welcome setup <channel> [embed] [message]
!welcome status
!welcome test
!welcome disable
!welcomeconfig

!welcome setup #welcome --message "Welcome {user} to {server_name}!"
!welcome setup #welcome welcome-embed

✅ Welcome messages will be posted to #welcome.
Message: Welcome {user} to {server_name}!

!welcome setup (a message)

kira sets the welcome in #welcome with --message and Petto confirms the channel and shows the message with its variables — In Discord: the welcome is set to a text with `--message`.

!welcome setup (a saved embed)

kira points the welcome at the saved embed welcome-embed and Petto confirms it — In Discord: the welcome uses the saved embed `welcome-embed`.

!welcome status

Petto lists the welcome channel #welcome, no embed template and the plain message — In Discord: the channel, the embed and the message of the welcome.

!welcome test

!welcome test (nothing set up)

Petto answers that welcome messages are not fully configured and to use !welcome setup first — In Discord: a test before the welcome has a channel and a message.

!welcome disable

Petto confirms that welcome messages are disabled — In Discord: the welcome messages are turned off.

!welcomeconfig

embed takes priority over message if both are set. test sends the message with your own account as the new member, without anyone actually joining. !welcome also works as !wc. !welcomeconfig shows what is set now for the welcome messages and every command to change it.

Write --message before a text message. Without it, the first word after the channel is read as the name of a saved embed: !welcome setup #welcome Hello {user} looks for an embed called Hello. An embed code does not need --message: !welcome setup #welcome {embed}$v{description: Hello {user.mention}}$v{button: green && Rules && embed:rules} saves it whole as the message, with its buttons.

kira types !welcome setup #welcome Hello {user} and Petto answers that no embed named Hello was found — In Discord: without `--message`, the first word is read as the name of a saved embed.

When the welcome is sent

By default the welcome is sent the moment the member joins, as it always was. A server can choose when it goes out (dashboard: Security → Join Gate → Messages → Welcome → Send the welcome):

Value	When the welcome is sent
As soon as the member joins (the default)	At once. Nothing changes for servers that do not touch it.
After the member accepts the rules	When the member accepts the server rules (Membership Screening). A member who never accepts them is never welcomed.
After the rules and the onboarding	When the member also finishes Discord onboarding (the questions that give roles and channels). Members can skip the onboarding in some servers, so the welcome is sent anyway 10 minutes after the rules were accepted, or 30 minutes after the member joined when the server has no rules to accept.

This only works when Membership Screening or Server Onboarding is turned on in Discord (Server Settings → Safety Setup and Onboarding). A member who is not waiting for anything (a bot, someone who already finished, a member who left and came back) is welcomed at once. Only the welcome waits. Everything else stays immediate: the DM on join often carries the rules or verification steps and the ping on join exists to bring the member in, so both go out at once, and so do the join logs, the invite tracking, the join roles and the level bonus. A member who leaves before the welcome is sent is dropped, a waiting welcome survives a restart of Petto, and a wait that lasts 7 days is forgotten. If you turn the setting off while members wait, they are not welcomed late: only new members are welcomed at once.

Second welcome

A server can have two welcomes: for example one in a welcome channel and another in the general chat. The second one has its own channel, message (or saved embed or design, with the same variables) and its own switch. It is sent right after the first one, follows the same wait setting, and if one cannot be posted (the channel is gone or Petto cannot write in it) the other is still sent; the log says it once an hour.

!welcome second-setup <channel> [embed] [message]
!welcome second-disable

!welcome second-setup #general --message "Everyone say hi to {user}!"

!welcome status and !welcome test cover both welcomes, and the dashboard has a Second welcome card next to the first one.

Examples

Every example can be pasted as it is. The results show what a member called Liam sees when he joins Cozy Corner as its 1,204th member.

Simple
Member number
Who invited them
Random greeting
With an image card

Command

!welcome setup #welcome --message "Welcome {user} to **{server_name}**! 🎉"

Result

Welcome @Liam to Cozy Corner! 🎉

Command

!welcome setup #welcome --message "Hey {user}, you're our **{user.join_position_suffix}** member! Grab your roles and say hi."

Result

Hey @Liam, you're our 1204th member! Grab your roles and say hi.

Command

!welcome setup #welcome --message "Welcome {user}! You were invited by {inviter}, who now has {inviter.invites} invites."

Result

Welcome @Liam! You were invited by @Mia, who now has 12 invites.

The invite variables need Petto to have Manage Server. When Petto can’t tell which invite was used (a vanity link, for example), {inviter} says Unknown.

Command

!welcome setup #welcome --message "{choose:Look who's here|A wild member appeared|Welcome aboard}, {user}! {reactreply:👋}"

Result

A wild member appeared, @Liam!
(Petto reacts 👋 to its own message)

Command

!welcome setup #welcome --message "Welcome {user}! {imgcard:welcome}"

Sends the text with the image card called welcome drawn for the member (their avatar and name on your design).

Using a saved embed

Make the embed

Build it in the dashboard’s Embeds page, or from one code:

Command

!embed create welcome-embed {embed}$v{title: Welcome to {server_name}!}$v{description: Hi {user}, you're member number **{server_membercount}**.{newline}Read the rules and pick your roles.}$v{thumbnail: {user.avatar}}$v{color: #f0a88f}

kira creates welcome-embed from one code and Petto answers with the embed: Welcome to Petto Land, member number 1841 — In Discord: the embed is saved from one code and Petto shows it filled for you.

Point the welcome at it

Command

!welcome setup #welcome welcome-embed

Petto confirms that welcome messages go to #welcome with the embed welcome-embed — In Discord: the welcome now uses `welcome-embed`.

Try it

Command

!welcome test

You get the embed in #welcome with your own name, avatar and the real member count.

In Discord: the test posts the embed with your name, avatar and the real member count.

Variables

Every variable works. The ones made for welcomes:

Variable	What it gives	Example
`{user}`	Mentions the new member	@Liam
`{user.display_name}`	Their name in the server	Liam
`{user.join_position_suffix}`	Their member number with its ending	1204th
`{user.created_at_timestamp}`	When the account was made, to use as `<t:…:R>`	6 years ago
`{server_membercount}`	Members now	1204
`{inviter}` / `{inviter.name}`	Who invited them	@Mia / Mia
`{inviter.invites}`	How many invites that person has	12
`{invite.code}`	The invite that was used	cozy

The Messages tab with the Variables menu open over the welcome message, listing {user}, {user.mention}, {user.name} and more — Dashboard → Security → Join Gate → Messages: the Variables menu lists every variable; click one to copy it.

Put a ! before a mention (!@everyone, !@Moderators) to show it without notifying anyone: see Silent mentions.

DM on Join

A private message to every new member.

Leave messages

The same, when someone leaves.

Overview

Guides

Concepts

Moderation

Automation

Community

Roleplay

Miscellaneous

Onboarding

Setup

Resources

Common Issues

Changelog

Welcome Messages

Overview

Commands

When the welcome is sent

Second welcome

Examples

Using a saved embed

Variables

DM on Join

Leave messages

​Overview

​Commands

​When the welcome is sent

​Second welcome

​Examples

​Using a saved embed

​Variables

​Related

DM on Join

Leave messages

Overview

Commands

When the welcome is sent

Second welcome

Examples

Using a saved embed

Variables

Related