Skip to main content

Overview

Sends a direct message to new members the moment they join, independent of the channel welcome message. Useful for rules, an invite to introduce themselves, or anything you don’t want cluttering a public channel. Like every DM from Petto, this one starts with a grey From <server> line and has info, delete and report buttons: see DMs from Petto.
Petto's direct message to Mia: Hi Mia, welcome to Petto Land, read the rules before chatting, you are member 1841

In Discord: the DM Mia gets the moment she joins Petto Land.

The Roles and DM tab with Members given to humans, Bots given to bots, and the DM on join message with its preview

Dashboard → Security → Join Gate → Roles and DM: the join roles and the DM on join with its preview.

The DM is sent the moment the member joins, even when the server makes the welcome wait for the rules or the onboarding. It often carries the rules or the verification steps, so it must not wait.

Commands

kira sets the join DM and Petto confirms it and shows the message

In Discord: the DM is set to a text with --message.

Petto answers to provide a message or an embed

In Discord: setup without a message or an embed.

Petto shows no embed template and the plain message of the DM

In Discord: the embed and the message of the DM.

kira runs !dmonjoin test and Petto says the preview was sent to her DMs

In Discord: the preview goes to your DMs.

Petto's DM to kira: Hi kira, welcome to Petto Land

In Discord: the preview in your DMs, filled with your own name.

Petto confirms that the join DM is disabled

In Discord: the DM on join is turned off.

liam types !dmonjoinconfig and Petto answers with the current settings of the DM on join, the commands and a Documentation button

In Discord: !dmonjoinconfig, the settings of the DM on join and the commands to change them.

embed takes priority over message if both are set. setup needs a message or an embed. test DMs yourself a preview. !dmonjoin also works as !dmjoin. !dmonjoinconfig shows what is set now for the DM on join and every command to change it.

Examples

Command
Result
In a DM, channel variables like {channel} point at the DM itself, so mention channels by writing them out (<#123456789012345678>) instead. The invite variables work here like in welcome messages.
Members with DMs closed to non-friends simply won’t receive it, there’s no way for the bot to detect or work around this.
The DM on join card with the message and its preview: Hi Liam, welcome to Petto Land

Dashboard → Security → Join Gate → Roles and DM: the DM on join card, with the message and its preview.