Logging Commands
Join
Send a randomly-selected message to a channel when a new user joins.
The /logs join commands let Zira send a join message to a specified channel when a new user joins your server. You can configure multiple messages and Zira picks one at random per join.
Want to log members leaving instead? See the leave commands. Want a richer editing experience? The Dashboard's join/leave message page supports the same placeholders with a live preview.
Zira needs Send Messages permission on the channel you want messages sent to.
Setting Up The Join Message System#
/logs join set enables the join system and sets the channel announcements go to.
Usage#
/logs join set <Channel>
Example#
Adding Join Messages#
/logs join add adds a new message to the pool. Zira picks one at random for each join.
Text Messages#
Plain-text join messages are the simplest form.
Usage#
/logs join add text <Your text here>
Example#
Embedded Messages#
For richer formatting, build the message in the embed builder and pick Join as the type. The builder posts directly into your join message pool, supports live placeholder preview, and removes the need to hand-edit JSON.
If you do still want to send raw JSON via the slash command:
Usage#
/logs join add embed <JSON Code>
Example#
Placeholders#
Both text and embedded messages support placeholders that Zira replaces at send time.
| Placeholder | Description | Example |
|---|---|---|
$user$ | Username | JakeyPrime |
$id$ | User's ID | 165047934113677312 |
$mention$ | A user ping | @Profit |
$guild$ | Server name | Team Hydra |
$membercount$ | Member count after the join | 30847 |
In a text welcome message, $mention$ (and any role mentions you type in) send a real notification to the person or role. Inside an embed, Discord displays mentions but never notifies anyone; that is how embeds work on Discord, not a Zira limit. If you want the new member to actually get pinged, put $mention$ in the text part of the message. Zira never sends @everyone or @here from welcome messages.
$discriminator$ was removed in 2023 when Discord retired the four-digit discriminator system. Zira has automatically cleaned it out of previously saved messages, so there is nothing to edit by hand.
Marking Welcomes When A Member Leaves#
If someone leaves, is kicked or is banned shortly after joining, Zira can edit their welcome message to say so. The channel then stops greeting someone who is already gone, which helps when raid accounts or spam bots join and get removed. This is free and set up on the dashboard only.
Before you start: a join channel must be set (see above), and Zira needs Send Messages in it. To tell kicks and bans apart from members leaving on their own, Zira also needs the View Audit Log permission. Without it, every removal shows as "left the server".
Setting It Up#
- Open the dashboard, pick your server, and go to Join & Leave.
- Find the Mark welcomes when members leave card, just under the join messages.
- Choose an Edit window, anything from 1 minute to 24 hours. This is how long after the welcome Zira will still edit it.
- Click Save.
What Happens#
When a member who joined inside the window leaves, Zira edits their welcome message and adds a small line under it, for example:
Welcome to the server, @newmember!
-# newmember was banned 2 minutes ago
The line says left the server, was kicked or was banned. For an embed welcome, the line appears above the embed and the embed itself is not changed. The edit never pings anyone again. Your leave message, if you have one, still posts as normal: the two work independently.
Members who leave after the window has passed are not marked, so Zira never touches welcome messages from weeks or months ago. If a member leaves and rejoins inside the window, only their newest welcome is tracked.
If It Does Not Work#
- Nothing was edited: check the window was saved, and that the member joined after you turned it on. Welcomes posted before you enabled it are not tracked.
- A kick or ban shows as "left the server": give Zira the
View Audit Logpermission. - The welcome message was deleted: there is nothing to edit, so Zira skips it silently.
- To turn it off: set the edit window back to Off and save.
Log Examples#
Text Message#
Embedded Message#
Listing Current Join Messages#
/logs join list
Example#
The IDs printed here are what /logs join remove takes.
Removing A Join Message#
/logs join remove <ID>
Get the ID from /logs join list above.
Example#
Disabling The Join System Entirely#
/logs join disable