Skip to main content

Welcome Messages

Kakashi can send a custom welcome message to a configured channel whenever a member joins. The editor supports both ordinary message content and an embed, so the result can be as simple or branded as your server needs.

  1. Choose the destination with /config welcome channel.
  2. Open the welcome editor and configure the message content and/or embed.
  3. Insert dynamic variables where useful.
  4. Preview the result.
  5. Run /config welcome test instead of waiting for a real member to join.
  6. Use /config welcome remove when you want to disable the welcome message.

Editable content​

The current editor supports normal message content plus embed fields including:

  • title;
  • color;
  • description;
  • thumbnail;
  • image.

Image/thumbnail values must be valid URLs, and colors must use a valid hexadecimal color value.

Variables​

The welcome system currently supports variables including:

{member}
{member.tag}
{member.avatar}
{server.name}
{server.icon}
{server.members}

Example:

Welcome {member} to **{server.name}**!
You are member #{server.members}.

Use {member} when you actually want to mention the joining user. Use the tag/avatar/server variants when you need text or an image value instead.

tip

Run the built-in test after every major embed edit. It is much faster than discovering a broken image URL or unreadable color when a real member joins.

Design tips​

Keep the first message useful. A welcome screen normally works best when it answers one or two immediate questions—where to start, where rules are, or what the member should do next—instead of becoming a wall of text.

If you use a large image, make sure the essential instructions also exist as text; image loading should not be the only way a new member can understand the onboarding step.

Permissions​

Kakashi needs to be able to view the destination channel and send messages there. If the welcome uses embeds or linked media, the corresponding Discord permissions must also be allowed by that channel's overwrites.

Common mistakes​

  • Configuring a channel Kakashi cannot send to.
  • Pasting an invalid image/thumbnail URL.
  • Using an invalid hex color.
  • Writing a variable name that the welcome renderer does not support.
  • Forgetting to test after changing channel permission overwrites.

Troubleshooting​

Nothing is sent​

Confirm a welcome channel is configured and that Kakashi can view/send in it. Then use /config welcome test to separate a configuration problem from an actual member-join event problem.

The message works but the embed does not​

Check Embed Links permission and validate the URLs/color used in the embed editor.

A variable appears as plain text​

Use one of the supported variable names exactly as documented above.