Welcome & Leave

Placeholders

Use these in Text, Embed.Description, Footer, and similar fields:

{userName}       : aegis_development
{user}           : @Lewis
{userTag}        : aegis_development#1234
{userId}         : 264032125496459265 (user ID)
{userBanner}     : Displays the user's banner URL in the image field
{UserCreation}   : Account age (Discord timestamp)
{guildName}      : Guild Name
{guildIcon}      : Guild Icon
{memberCount}    : Member count with suffix (1st, 2nd, 3rd...)
{memberCountNumeric}: Displays 5, 6, 7...
{longTime}       : March 1st, 2023
{shortTime}      : 17:00
{user-joinedAt}  : For leave messages, displays when they first joined
{user-createdAt} : The date when the user's Discord account was created
{autoKickTime}   : How long until the user is kicked
{invitedBy}      : Who invited them?
{invitedByCount} : How many invites the person who invited them has
{joinDate}       : Discord timestamp for when they joined
{joinTime}       : Discord timestamp for when they joined
{leaveDate}      : Discord timestamp for when they left
{leaveTime}      : Discord timestamp for when they left

Placeholders are case-sensitive. Use {userName}, not {username}.

Welcome messages

Core settings

1

WelcomeMessage configuration

WelcomeMessage:
  Enabled: false
  ChannelID: "CHANNEL_ID"
  Type: "BOTH" # EMBED, MESSAGE, BOTH
  Text: "Welcome to **{guildName}**, {userName}"

• Enabled → Master switch for welcome system

• ChannelID → Channel where messages will be sent

• Type → MESSAGE = text only, EMBED = embed only, BOTH = show both (embed and text)

Embed options

Embed:
  Title: ""
  Description:
    - "Welcome to **{guildName}**, {userName}! 🎉"
    - "Invited By » {invitedBy} ({invitedByCount} invites)"
    - "Join Date » {joinDate} ({joinTime})"
    - "Account Age » {UserCreation}"
    - "Members » {memberCount} member"
  Footer:
    Text: "{guildName} • Today at {shortTime}"
    Icon: "{guildIcon}"
  Author:
    Text: "Welcome to {guildName}!"
    Icon: "https://.../hand-waving-icon.png"
  Color: "#1769FF"
  Image: "{userBanner}"
  Thumbnail: "{user-avatar}"
  Buttons:
    - Type: "LINK"
      Name: "Product"
      Emoji: "📜"
      Link: "https://builtbybit.com/..."

• Description → Multiple lines supported

• Images/Thumbnails → Use placeholders like {user-avatar}, {userBanner}

• Buttons → Add useful links (e.g., rules, website, product page)

Direct message (DM) welcome

DM:
  Enabled: false
  Embed:
    Title: "Welcome, {userName}!"
    Description:
      - "Welcome to **{guildName}**, {userName}! 🎉"
      - "You are our {memberCount} member!"
    Footer:
      Text: "{guildName} • Today at {shortTime}"
      Icon: "{guildIcon}"
    Color: "#1769FF"
    Image: "{userBanner}"
    Thumbnail: "{user-avatar}"

• Sends a private DM to each new member.

• Great for onboarding or linking rules.

• Some users disable server DMs. That’s expected behavior.

Auto-delete (welcome)

AutoDelete:
  Enabled: false
  Delay: "15s"

• Deletes welcome messages after set time.

• Delay accepts: 10s, 1m, 1h, 1d.

• Useful for keeping your welcome channel clean.

Leave messages

Core settings

LeaveMessage:
  Enabled: false
  ChannelID: "CHANNEL_ID"
  Type: "BOTH"
  Text: "Goodbye, {userName}!"

• Enabled → Master switch for leave system

• ChannelID → Where the leave message is posted

• Type → MESSAGE, EMBED, or BOTH

Embed options (leave)

Embed:
  Description:
    - "Goodbye, {userName}!"
    - "Hope to see you again soon."
  Footer:
    Text: "{guildName} • {shortTime}"
    Icon: "{guildIcon}"
  Author:
    Text: "👋 See you soon!"
  Color: "#1769FF"
  Thumbnail: "{user-avatar}"

• Keeps your farewell messages consistent with your welcome style.

• Use {user-joinedAt} to remind how long they were part of the server.

Auto-delete (leave)

AutoDelete:
  Enabled: false
  Delay: "15s"

• Works the same as the welcome auto-delete.

• Helpful for servers that want clean logs without permanent goodbye posts.

Best practices

• Message design → Keep it warm, friendly, and on-brand.

• Channel management → Use a dedicated #welcome or #farewell channel.

• Invite tracking → {invitedBy} only works if invite tracking is enabled.

Common issues

Messages not showing

Make sure Enabled: true and the bot has send/embed permissions.

Placeholders not working

They are case-sensitive, e.g., {userName} not {username}.

Images not loading

Test the URL in a browser. Make sure you right-click the image and select “Copy Image Address”.

DMs not delivered

Some users block DMs.