How to Set Up a Mimu Welcome Message (and Fix It)

To set up a Mimu welcome message, build an embed with Mimu's /embed commands, attach it to your greet with the /greet commands, pick the greet channel, then run Mimu's greet test. If nothing posts, Mimu usually can't view the channel, can't send messages there, or is missing Embed Links. Discord's own "welcome" system message is a separate feature, and it can post alongside Mimu's.

Checked on each bot's own site or docs on 9 November 2026. We make PeakBot. Nobody paid to be in this post.

These steps follow the order Mimu's own documentation uses: create the embed, edit it, set the greet message, set the greet channel, test. Mimu changes its commands now and then. If an option name here doesn't match what you see, go with Discord's command picker and Mimu's current docs.

Before you start: Mimu greet vs Discord's welcome message

There are two separate welcome systems, and they're easy to mix up:

• Discord's built-in system message. Discord posts a short random line when someone joins. You choose the channel it goes to, but you can't change the wording. You need the Manage Server permission to change it. See Discord's New Member Messages article.
• Mimu's greet. A custom message you write. It can ping the member, use variables like their name and your member count, and include an embed.

If you set up Mimu and leave Discord's system message on, new members get welcomed twice. Step 6 covers the fix.

Step 1: Add Mimu and check its permissions

1. Invite Mimu to a server where you have Manage Server. Use the invite link on Mimu's official site.
2. Go to Server Settings > Roles, open Mimu's role, and make sure View Channels, Send Messages and Embed Links are on.
3. Open the channel you want welcomes in, open its settings, then Permissions. Make sure no role or channel override denies those three for Mimu.

Step 3 matters because channel overrides beat server-wide permissions. Discord applies them in this order: @everyone deny, then allow, then role deny, then allow, then member deny, then allow (Discord's permissions docs). So a deny on the channel can block Mimu even when its role has the permission everywhere else. Administrator is the exception because it bypasses channel overrides. Mimu doesn't need Administrator, though. Fixing the channel is safer.

To check Mimu is online and responding, run its /ping command in any channel.

Step 2: Create the welcome embed

Skip this step if you only want a plain text greet. For an embed:

1. Type /embed and choose the create option from Discord's command list.
2. Give the embed a short name you'll remember, such as welcome.
3. Use the edit option on that same name to add the title, description, colour, image and footer.

Mimu has variables for things like the new member's mention, their username, the server name and the member count. It also has a newline variable, because some Discord clients won't let you type a line break into a slash command box. Variable names must be typed exactly, so copy them from the greet embed guide in Mimu's documentation instead of guessing.

Keep the description short. Three lines is enough: who they are, where to go first, and one thing to do. For wording to start from, see our copy-and-paste welcome messages.

Step 3: Set the greet message

1. Type /greet and choose the message option.
2. Write the text that goes above the embed. Put the user mention variable here if you want the member pinged. A mention inside an embed doesn't send a notification, but a mention in the message text does.
3. Attach your embed with the embed variable from Mimu's docs, using the name you picked in Step 2.

Step 4: Set the greet channel

1. In /greet, choose the channel option.
2. Pick the channel where welcomes should go, such as #welcome.

Make sure new members can see that channel. If verification or a role gate hides it from them, Mimu will still post there, but the member won't see the message or get the ping.

Step 5: Test it

Run Mimu's greet test from the /greet commands. It posts the greet as if you had just joined. Check three things:

• The variables show real values, not the raw variable text.
• The embed appears. A blank message or a missing embed almost always means Embed Links is missing in that channel.
• The ping works.

Then do a real join with an alt account or a friend. A test and a real join don't always behave the same. The fixes below cover why.

Step 6: Stop the double welcome

Go to Server Settings and find System Messages. Either point the system messages channel at a different channel, or turn off the option that sends a random welcome message when someone joins. Discord has moved this setting between tabs over time, so search for "System Messages" and don't count on a fixed tab name.

Common fixes when Mimu's welcome doesn't post

Nothing posts at all. Run /ping to check Mimu is online. Then look in the channel's Permissions tab for denies on View Channel or Send Messages. Make sure a greet channel is actually set. Setting a message on its own isn't enough.

The text posts but the embed is blank. Either Mimu is missing Embed Links in that channel, or the embed name in your greet message doesn't match the one you created. The names must match exactly.

Variables show up as raw text. You have a typo or the wrong brackets. Copy the variable straight from Mimu's docs.

The test works but real joins don't. Common causes:

• Verification or an unverified role hides the greet channel from new members, so they never see it. Move the greet, or let unverified members see that channel.
• Another bot or a security tool kicks or quarantines new accounts before they finish joining.
• You ran the test in a different channel from the one set as the greet channel.

Line breaks don't work. In the slash command box, use Mimu's newline variable instead of the Enter key.

If you also want a message when people leave, our guide to goodbye and leave messages walks through it.

How PeakBot does it (a dashboard alternative)

We make PeakBot, so keep that in mind as you read this section. If you'd rather build a welcome on a web page than with slash commands, PeakBot sets it up on its dashboard. There is no welcome command.

1. Sign in at peakbot.pro and pick your server.
2. Open Welcome Messages in the dashboard sidebar.
3. Choose plain text or a rich embed and pick the channel. The dashboard shows you the result before it posts.
4. Turn on the invite line if you want the welcome to show who invited the new member.
5. Save. If you want goodbyes too, set up Goodbye Messages on its own page.

Channel welcome messages are on the Free plan, which has no time limit. Sending the welcome by DM or adding a welcome image needs a paid plan. Starter includes both and costs $5.75/month, or $48/year, per server. The full walkthrough is in the welcome, roles and verification guide.

When Mimu is the better choice: if your server already runs on Mimu, you like its embed style, or you want everything done with commands inside Discord, stay with Mimu. You don't need a second bot just for greets. PeakBot makes more sense if you want a visual editor that shows the result first, or if you want verification, auto roles and invite tracking set up in the same dashboard.

For a look at what a welcome should do, whatever bot you use, read how to set up a Discord welcome message that onboards members.

Frequently Asked Questions

Why is Mimu not sending my welcome message?

Usually it's a channel permission. Mimu needs View Channel, Send Messages and Embed Links in the greet channel, and a channel override can deny them even when its role has them server-wide. Also check that a greet channel is set and that /ping gets a reply.

How do I add an embed to my Mimu greet?

Create a named embed with /embed, edit it, then add it to your greet message with the embed variable from Mimu's docs. The embed name must match exactly.

What variables can I use in Mimu welcome messages?

Mimu has variables for the user mention, username, server name and member count, plus others. The exact names are in the greet embed guide in Mimu's own documentation. Copy them from there so they render correctly.

How do I make a new line in a Mimu embed?

Use Mimu's newline variable. Some Discord clients don't allow line breaks in slash command inputs, and that's why the variable exists.

How do I turn off Discord's default welcome message?

Go to Server Settings, find System Messages, and either turn off the random welcome message option or send system messages to a different channel. You need the Manage Server permission.

Can the welcome be sent by DM instead?

Check Mimu's current docs for DM options. Many members have DMs from servers turned off, so a channel welcome reaches more people. Our guide on welcoming members when DMs are off covers ways around this.