Modbot Docs
Discord

Welcome steps

Send each new Discord member up to three next steps, picked from the roles Discord's onboarding gave them. By direct message, in a welcome channel, or both.

Discord's onboarding asks new members a few questions and hands out roles from their answers. Then it leaves them in the server with no hint of what to do first. Welcome steps fill that gap: you write rules such as "if they hold this role, show this step", and Modbot sends each new member up to three steps.

Everything is off until you turn it on. It is separate from the join gate's own welcome message, which keeps working as before.

Set it up

You need the Change settings permission. The bot should be set up first (Setting up the bot).

Open Settings → Discord and find the Welcome steps card.

SettingWhat it does
Welcome new membersThe switch. Needs at least one rule or default step.
Send asDirect message, Channel or Both.
Welcome channelWhere the message goes for Channel and Both. The bot needs to see the channel and send messages in it.
RulesUp to 25. Each has a Role, a Step and an optional Link.
Default stepsUp to 3. Each has a Step and an optional Link.
Add a Link your VRChat buttonOff to start. Adds a Link your VRChat button after the step buttons for a member who has not linked. See Account links.

A step is one line of at most 80 characters. A link must start with https://. Use the arrows on a row to change its order, then press Save welcome steps.

Which steps a member gets

  1. Modbot goes through your rules from the top. Each rule whose role the member holds adds its step.
  2. It stops at three steps.
  3. If fewer than three matched, it fills the rest from your default steps, in order.

So the order of your rules is the order members see their steps in. A member who matches nothing gets only the default steps. If you have no default steps either, nothing is sent.

When it is sent

Your serverSent
Uses Discord's onboardingWhen Discord marks the member as having finished it, so their answers have already given them roles.
Has no onboardingWhen the member joins.

Modbot works out which of the two your server is. There is nothing to set. It asks Discord at most once an hour, and a member whom Discord shows as having started onboarding is waited for even if the answer said there is none.

With the join gate on, nothing is sent until the gate lets the member in. A member who finishes onboarding while the gate still holds them is welcomed the moment it lets them in.

Each member is welcomed once. Switching it on welcomes only members who join after that, so nobody who is already in the server is greeted.

If a member has direct messages from server members closed, the direct message cannot be delivered. Modbot does not retry. Use Channel or Both to reach them anyway.

Each welcome is recorded as Sent next steps on Discord.

Modbot is not endorsed by or affiliated with VRChat Inc. or Discord Inc. VRChat is a trademark of VRChat Inc. Discord is a trademark of Discord Inc. SteamVR is a trademark of Valve Corporation. Windows is a trademark of Microsoft Corporation. Docker is a trademark of Docker, Inc. PostgreSQL is a trademark of the PostgreSQL Community Association of Canada. Railway is a trademark of Railway Corp. Other names are trademarks of their respective owners; see Legal. Modbot and its logo are trademarks of the Modbot project. Open source under AGPL-3.0.

On this page