Back to Blog

How to Set Up Sapphire Bot on Discord (Welcome, Logs, Fixes)

PeakBot Team·How we write these·November 11, 2026·7 min read
By the PeakBot Team — powering 10000+ Discord communities
Key Takeaways
  • Discord now calls bots "apps." There are two ways to add one.
  • Discord creates a role for each bot when it joins.
  • Either your account doesn't have Manage Server in that server, or your browser is logged in to a different Discord account.
  • PeakBot can handle both welcomes and logs if you'd rather use a different dashboard.
  • Sapphire's core features are free with limits.

You can add Sapphire to your server from its site at sapph.xyz or from Discord's App Directory. To do that you must be the server owner or have the Manage Server permission. Next, log in to Sapphire's web dashboard with Discord, pick your server, and turn on the welcome and logging modules one at a time. When something doesn't work, the cause is usually on Discord's side: the bot can't see the channel, can't send messages in it, or its role sits too low.

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

This guide covers Sapphire, the multipurpose bot at sapph.xyz. It doesn't cover sapphirejs.dev, which is a coding framework for building your own bot. It also has nothing to do with the Sapphire insulin pump or the graphics card software.

Before you start: what you need

  • Manage Server on your account. Discord only lets the server owner, or someone with Manage Server, add apps (Discord's guide to apps). If your server is missing from the list when you add the bot, this is almost always why.
  • A desktop or browser session. Adding apps and using bot dashboards is simplest on a computer.
  • Your channels. Decide which channel welcomes go in (for example #welcome). Create a private channel for logs (for example #mod-logs).

Step 1: Add Sapphire to your server

Discord now calls bots "apps." There are two ways to add one.

From Discord (App Directory):

  1. Click your server name at the top left.
  2. Click Server Settings, then App Directory.
  3. Search for Sapphire and open its profile. Make sure it's the right app before you add it.
  4. Click Add App, or Add to Server on the app's profile.
  5. If Discord asks whether to add it to your account or to a server, choose the server.
  6. Pick your server from the dropdown, review the permissions, and click Authorize.

From Sapphire's site: go to sapph.xyz, click its invite button, then follow steps 5 and 6 above.

On the permissions screen, the required permissions have to stay ticked. You can untick the optional ones, but anything you untick now is something you may have to fix later. Leave the defaults unless you have a reason to change them.

Once Sapphire is in, you manage it under Server Settings > Integrations. That page lists every bot, webhook and app in the server. You can also choose which of Sapphire's slash commands work in which channels and for which roles (Discord on command permissions).

Step 2: Move Sapphire's role up

Discord creates a role for each bot when it joins. A bot can only manage roles that sit below its own highest role. That matters if you want Sapphire to give join roles or take moderation actions.

  1. Open Server Settings > Roles.
  2. Drag Sapphire's role above every role you want it to give or manage.
  3. Keep it below your admin and staff roles if you don't want it acting on them.

Step 3: Log in to the Sapphire dashboard

  1. Go to sapph.xyz and log in with your Discord account.
  2. Authorize the login request Discord shows you.
  3. Pick your server from the list. Only servers where you have Manage Server appear there.

Dashboard layouts change, so Sapphire's menu names may not match older guides or screenshots. Look for each module by what it does (welcome, logging, join roles, moderation) rather than by an exact label.

Step 4: Set up a welcome message

  1. In the dashboard, open the welcome messages section.
  2. Turn the module on.
  3. Choose the channel where welcomes should post.
  4. Write your message. To mention the new member or show their name, use the placeholders that Sapphire's editor lists. Copy them from the editor itself, because the syntax in older guides may be out of date.
  5. For an embed, set the title, description, colour and any image.
  6. Save. It sounds obvious, but if you leave without saving, the welcome will do nothing, so it's worth checking first.
  7. Test it with a second account or a friend who leaves and rejoins.

To give new members a role automatically, look for Sapphire's join role setting in the same part of the dashboard. It only works if you've done Step 2: the role it gives must sit below Sapphire's role.

Step 5: Set up logs

  1. Make your log channel private. Open its settings and go to Permissions. Deny View Channel for @everyone, then allow it for your staff role and for Sapphire.
  2. In the Sapphire dashboard, open the logging section.
  3. Pick the events you care about. A good starting set is message deletes, message edits, member joins and leaves, and moderation actions.
  4. Point each event, or the whole module, at your log channel and save.
  5. Delete a test message and check that it shows up in the log.

Discord also keeps its own Audit Log under Server Settings. It records actions like bans, role changes and channel edits, but it doesn't keep the text of deleted messages. That gap is why people add a logging bot.

Troubleshooting: why Sapphire isn't working

Welcome messages not sending

  • The module is off, no channel is selected, or the change wasn't saved.
  • Sapphire can't see or post in the channel. A bot needs View Channel and Send Messages there. Embeds also need Embed Links, and images need Attach Files. Check the channel's permission overrides, because a deny on a channel or category beats an allow at server level. Discord's permissions FAQ explains how overrides stack.
  • You're testing with your own account, so no one new is joining. Use a second account that actually joins.
  • You're looking at Discord's own join messages. Discord's system messages are separate from Sapphire's welcome, so you might see one, both or neither.

My server doesn't appear when I add Sapphire

Either your account doesn't have Manage Server in that server, or your browser is logged in to a different Discord account. Ask the owner for the permission, or log out and back in.

Logs are empty

Check that Sapphire can see the channels it's supposed to log. It can't catch deletions in a channel it can't view. Also check that it can post in the log channel itself.

Join roles aren't given

Either Sapphire's role is below the role it's trying to give, or it doesn't have Manage Roles. Fix the order in Server Settings > Roles.

Commands don't show up

Check Server Settings > Integrations to see whether Sapphire's commands are limited to certain channels or roles. A server can only hold a limited number of integrations, so remove bots you no longer use.

Still broken? For app problems, Discord points users to the app's own support server or developer. Use the support link on Sapphire's site.

Doing the same in PeakBot

PeakBot can handle both welcomes and logs if you'd rather use a different dashboard. We make PeakBot, so judge it on the details below. In fairness to Sapphire: its core features are free with limits, and its Limit Increase costs $2.99/month per server, which is less than PeakBot's paid plans.

Welcome messages

  1. Add PeakBot and log in at peakbot.pro. The getting started guide walks you through it.
  2. Open Welcome Messages in the dashboard sidebar.
  3. Choose plain text or a rich embed and pick the channel. The message can show who invited the new member.
  4. Sending the welcome by DM, or adding a welcome image, needs a paid plan. Starter is $5.75/month or $48/year per server.
  5. Goodbye Messages works the same way for people who leave.

Auto roles: the Roles page holds auto roles on join, self-assign roles and if/then rules. The role-order rule from Step 2 applies to every bot, PeakBot included. If you also want people to verify before they can see the server, see our verification bot setup guide.

Logging: you set up logging on the Auto Moderation page. It covers message edits and deletes, joins and leaves, voice activity and every manual mod action. Voice activity logs need a paid plan.

PeakBot's Free plan has 30+ features and never expires. It has no music or economy features. If you're building a server from scratch, the AI Server Builder can lay out channels and roles for you. It's free to try, with full use on Pro.

Frequently Asked Questions

Is Sapphire bot free?

Sapphire's core features are free with limits. Its Limit Increase upgrade is $2.99/month per server. Check sapph.xyz for what each limit covers today.

How do I make Sapphire's welcome message ping the new member?

Use the user mention placeholder listed in Sapphire's welcome editor. Put it in the message text, not only inside an embed, because Discord doesn't send ping notifications for mentions inside embeds.

How do I log deleted messages with Sapphire?

Turn on message delete logging in Sapphire's logging section and point it at a private channel. Make sure Sapphire can view the channels you want logged, or it won't see deletions there.

Why can't I see my server when adding Sapphire?

You have to be the owner or have Manage Server in that server. The dropdown only lists servers where you're allowed to add apps.

How do I remove Sapphire from my server?

Right-click Sapphire in the member list and choose Kick, or manage it from Server Settings > Integrations. Sapphire handles any data it keeps on its side, so check its site if you want that deleted too.

Does Sapphire work on mobile?

Slash commands generally work in the Discord mobile app. Adding the bot and editing the dashboard are easier on a computer or in a mobile browser.

Try PeakBot free on your server

Setup takes 30 seconds.

Add to Server
Free forever · Setup in 30 seconds

Ready to level up your server?

30+ features included free. Moderation, welcome messages, XP & leveling, tickets, reaction roles, and more.