1. Documentation
  2. Community

Welcome and farewell messages

Greet a newcomer in a channel, in private, or both.


Bao can react to two events: a member joins the server, a member leaves the server.

Join message

  • Channel: where to post the message. Leave empty to send only the direct message.
  • Content: the text, 2000 characters maximum.
  • Embed: title, description, colour, image, thumbnail, footer, author. Leave every field empty to send no embed.
  • Roles to mention: the roles pinged on join.
  • Delete after N seconds: automatically tidies the welcome channel. 0 to never delete, 3600 maximum.
  • Ignore bots: no message when a bot joins.
  • Direct message: a second message, with its own text and its own embed, sent straight to the member. Useful for the rules or a getting-started link.
If the member has closed their direct messages, delivery fails silently on Discord's side. That is why the in-channel message remains the recommended one.

Leave message

The same settings, plus two options:

  • Ignore bots.
  • Ignore banned members (on by default). Discord reports a ban as a departure: without this option, your server would announce "X has just left us" right after a ban.

Available variables

VariableResult
{user} or {user.mention}Clickable mention of the member
{user.name}Their username
{user.tag}Their full identifier
{user.id}Their Discord ID
{server}Server name
{membercount}Member count
{membercount.ordinal}"1,234th"

Example: Welcome {user} to {server}! You are our {membercount.ordinal} member.