Ledra Docs

Welcome & goodbye messages

Welcome and goodbye messages with placeholders, embeds and an optional DM.

/welcome and /goodbye work identically and are configured separately. One extra option exists only for welcome: a private DM to the new member.

The fastest possible setup#

/welcome channel channel:#welcome

That single command sets the channel, enables welcome messages, and fills in a default text if you have none. You already have a working welcome.

Then make it yours:

/welcome message text:Welcome {user} to **{guild}**! You are member {membercount}.
/welcome test

/welcome test renders the message with your own account and shows it only to you. Nothing is posted publicly.

The commands#

Command What it does
/welcome channel Set the target channel (also enables the message)
/welcome message Set the text
/welcome toggle Turn on or off without losing the configuration
/welcome style Embed vs. plain text, colour, image
/welcome dm Extra private message to new members (welcome only)
/welcome status Show the current configuration
/welcome test Private preview
/welcome placeholders List every placeholder
/welcome reset Delete the configuration

Replace /welcome with /goodbye for leave messages.

Placeholders#

Welcome {user} to {guild}! You are our {membercount.ordinal} member.

becomes

Welcome @NewPerson to Cool Server! You are our 501st member.

Placeholder Result
{user} A real mention — pings them
{user.name} Username
{user.display} Display name / nickname
{user.tag} Full username
{user.id} Their ID
{user.created} Account creation date
{guild} Server name
{guild.id} Server ID
{membercount} Member count
{membercount.ordinal} Member count as 501st
{owner} Mention of the server owner

A placeholder you spell wrong is left in the message exactly as typed — that way you can see the mistake instead of getting an empty gap.

Goodbye messages should not use {user}. Someone who left cannot be mentioned meaningfully. Use {user.tag} — the default goodbye message already does.

Full placeholder reference

Styling#

/welcome style use_embed:true colour:#5865F2 image_url:https://example.com/banner.png
Option Notes
use_embed true for an embed card, false for plain text
colour Hex, with or without #
image_url Must start with http:// or https://

Embeds automatically include the member's avatar as author icon and thumbnail.

If Ledra lacks Embed Links in the welcome channel, it falls back to plain text rather than posting nothing. Your members still get greeted — it just looks plainer than you configured.

The welcome DM#

/welcome dm enabled:true text:Welcome! Please read the rules in #rules.

Sent privately to each new member, in addition to the channel message. Perfect for rules, verification steps or a link to your guide.

Placeholders work here too.

  • Bots never receive it.
  • Closed DMs are not an error. Many people block DMs from servers; Ledra moves on quietly.
  • /goodbye dm does not exist — someone who left cannot be reached.

Turning things off#

/welcome toggle enabled:false     Keeps everything, just stops posting
/welcome reset                    Deletes the configuration entirely

Use toggle for a temporary pause, reset to start over.

Troubleshooting#

Nothing is posted. Check /welcome status. The status shows enabled only when a channel and a message are set. If Ledra cannot see or post in the channel, it stays silent — check the channel's permissions.

The message appears without the mention. You wrote {user.name} instead of {user}. Only {user} and {owner} produce real pings.

Nicknames break the formatting. They cannot. Names are escaped before insertion, so a member called **everyone** cannot bold your message or ping anybody.

Greetings command reference

Ledra documentation. Everything here describes the hosted bot.