Welcome

Automatically greet new members

The welcome module automatically sends a message when someone joins or leaves your server. You can customize the text freely, attach a welcome card image, send a DM to the new user, and assign a role on join.

Setup

  1. Enable the module: toggle the switch at the top of the welcome page to "Active"
  2. Select a welcome channel: use the "Channel" dropdown to pick the desired channel
  3. Enter the message text or customize the default
  4. Optional: configure leave message, DM, and auto-roles
  5. Click "Save"

Template variables

The following variables are available in the message text and in the DM:

VariableResult
{user} / {user.mention}Mention of the user (<@ID>)
{user.name}Username (without discriminator)
{user.tag}Username#Discriminator (new system: username only)
{user.id}Discord ID of the user
{server} / {server.name}Name of the server
{membercount}Current member count as a number
{membercount.ordinal}Ordinal number (1st, 2nd, 42nd …)
{accountAge}Age of the Discord account (e.g. "3 months")
{joinDate}Today's date in the server locale format

Example

Welcome {user} to **{server}**! You are our {membercount.ordinal} member. Your account is {accountAge} old.

Welcome card

When enabled, the bot attaches an image to the welcome message. The card shows the avatar, username, and member count. The background image (max. 5 MB) and accent colour can be customized in the dashboard.

Keep the background image dark and high-contrast so the white text stays readable.

Leave message

The leave message is sent when a member leaves the server — voluntarily or via kick. A ban does not trigger a leave message. You can use the same channel as the welcome message or a separate one.

DM to new members

When enabled, the bot attempts to send a direct message to the new member. Users who have DMs from server members disabled will not receive this message.

Auto-roles on join

In the "Auto-roles" tab you can define which roles are automatically assigned when someone joins — configured separately for humans and bots.

If both the welcome module and the separate auto-roles module have roles configured, both lists are combined — there is no priority between them.

Frequently asked questions

The welcome message arrives but the image is missing — why?
The bot needs the "Attach files" permission in the welcome channel. Check the channel permissions for the TeraOne role.
Can I use multiple welcome channels for different languages?
No, only one welcome channel per server is supported at this time.
The leave message also appears for kicks — is that intended?
Yes. A kick technically removes the user from the server — the leave message is triggered. Only bans suppress it.
Welcome · TeraOne Docs · TeraOne