Reference

Permissions reference

Every Buddy command and the member permission it needs, the permissions Buddy itself needs per command and feature, and how to change who can use commands.

Updated Oct 21, 2026
On this page

Two kinds of permission matter for every Buddy command: the permission you need to use it, and the permission Buddy needs to carry it out. This page lists both. For a friendlier explanation of roles and role order, read Permissions & roles.

How to read this page#

  • Who can use it is the command's default member permission. Discord hides the command from members who don't have it. "Everyone" means any member who can see the channel.
  • "Checked by Buddy" means Buddy checks extra rules itself when the command runs, so the command may be visible but still refuse.
  • App commands (marked member app or message app) are in the right-click menu: right-click (or long-press) a member or a message → Apps.
  • Click a command to see its options in the command reference.
Admin XP commands under /xp

/xp is a shortcut to the standalone XP commands, and each subcommand needs the same permission as its standalone version: Manage Server for settings, multipliers, events, blacklists and bonus settings, Manage Roles for /xp roles. /xp rank, /xp leaderboard, /xp rewards, /xp stats and /xp bonusalerts are open to everyone.

Member permissions by command#

Setup & info#

CommandWho can use it
/botinfoAdministrator
/helpEveryone
/pingEveryone
/serverinfoEveryone
/setupAdministrator
User Info (member app)Everyone
/userinfoEveryone

Moderation#

CommandWho can use it
/banManage Server
/kickManage Server
/muteManage Server
Mute Message User (message app)Manage Server
Mute User (member app)Manage Server
/pruneManage Messages
/removewarnManage Server
/spamalertManage Server
/unbanManage Server
/unmuteManage Server
/warnManage Server
Warn Message User (message app)Manage Server
Warn User (member app)Manage Server
/warnsEveryone

Levels & XP#

CommandWho can use it
/rankEveryone
/xp blacklistManage Server
/xp bonusalerts toggleEveryone
/xp bonussettingsManage Server
/xp bonustemplatesManage Server
/xp eventManage Server
/xp leaderboardEveryone
/xp multiplierManage Server
/xp rankEveryone
/xp rewards dailyEveryone
/xp rewards weeklyEveryone
/xp rolesManage Roles
/xp settingsManage Server
/xp statsEveryone
/xpblacklistManage Server
/xpbonusalerts toggleEveryone
/xpbonussettingsManage Server
/xpbonustemplatesManage Server
/xpeventManage Server
/xpleaderboardEveryone
/xpmultiplierManage Server
/xprewards dailyEveryone
/xprewards weeklyEveryone
/xprolesManage Roles
/xpsettingsManage Server
/xpstatsEveryone

Engagement#

CommandWho can use it
/starboardManage Server

Roles#

CommandWho can use it
/buttonroleManage Roles

Tickets & support#

CommandWho can use it
/applyEveryone
/support_latestA support role, or Manage Messages + Manage Threads (checked by Buddy)
/support_statusA support role, or Manage Messages + Manage Threads (checked by Buddy)
/ticketEveryone

Announcements#

CommandWho can use it
/autopublishManage Server
Post to Announcement (message app)Manage Server or an announcement staff role (checked by Buddy)
Schedule Announcement (message app)Manage Server
/scheduleannouncementManage Server

Automation#

CommandWho can use it
/eventtimerManage Server
/socialstatsManage Server

Banners & icons#

CommandWho can use it
/banner_statusEveryone
/edit_banner_overlaysManage Messages
/edit_bannersManage Messages
/edit_iconsManage Messages
Get Images (message app)Everyone
/icon_statusEveryone
/rotation_playlist assign_imageManage Messages
/rotation_playlist listManage Messages
/rotation_playlist remove_imageManage Messages
/rotation_playlist set_activeManage Messages
/upload_bannerEveryone
/upload_banner_overlayManage Messages
/upload_banner_staffManage Messages
/upload_iconEveryone
/upload_icon_staffManage Messages
/view_bannersEveryone
/view_iconsEveryone

Invites & growth#

CommandWho can use it
/bumpEveryone
/invite createEveryone
/invite statsEveryone

Utilities#

CommandWho can use it
/echoAdministrator
/sayAdministrator
/summaryEveryone
/timestampEveryone

Fun#

CommandWho can use it
/improvEveryone
/showdownEveryone
/spin leaderboardEveryone
/spin playEveryone
/story-modeEveryone
/vibecheckEveryone

Changing who can use commands#

You have two tools, and they stack:

ToolWhereWhat it does
Discord's integration settingsServer Settings → Integrations → Discord BuddyAllow or deny each command for roles, members or channels. This changes who can see the command.
Buddy's command rolesDashboard → Command roles, or /setup → Command RolesLimit a command (or a whole category) to chosen roles. Others get a private "This command is limited to certain roles" card.

Command roles never block members with Administrator or Manage Server, and they don't apply to /bump or the /spin commands, which stay open to everyone. See Command roles.

Open command roles

Permissions Buddy asks for when invited#

Add to Discord on the website asks for this recommended set. It covers Buddy's features without Administrator, and it's the same set the /setup health check compares Buddy's role against and that the Fix permissions buttons re-authorize Buddy with.

PermissionUsed for
View Channels, Send Messages, Embed LinksEvery command and post
Send Messages in ThreadsForum support and replies in threads
Attach FilesWelcome images, rank cards, leaderboards and other image posts
Read Message HistoryTicket transcripts, reaction roles, /showdown, /vibecheck
Add ReactionsReaction roles, starboard auto star, /showdown
Use External EmojisCustom emoji from other servers in Buddy's messages and reactions
Mention EveryonePinging @everyone, @here or roles that aren't normally mentionable, for example in announcements and alerts
Manage MessagesMessage filters, /prune, counting channel, editing posted embeds, auto-publish
Manage ThreadsForum support status buttons
Manage RolesJoin, button, reaction and reward roles, mute roles
Manage ChannelsTicket channels, event timers, counter channels
Manage ServerBanner and icon rotation, invite tracking
Create Invite/invite create
Change NicknameThe bot nickname from Bot settings
Kick Members, Ban Members, Timeout Members/kick, /ban, /unban, /mute and spam alerts
View Audit LogNaming the moderator in server logs ban entries

Not included: Administrator, which only /echo and /botinfo need. Add it to Buddy's role if you use those. Inviting from My Discords or the dashboard's server rail asks for Administrator instead.

Permissions Buddy needs for commands#

Every command needs Buddy to have View Channel and Send Messages in the channel where it's used. If Buddy is missing something it replies privately with "Buddy is missing a permission" and names it. Members with Manage Server also get a Fix permissions button. See Cards Buddy shows.

CommandBuddy also needs
/setupEmbed Links (the panel's health check reports anything else missing)
/echo, /botinfoAdministrator
/ban, /unbanBan Members
/kickKick Members
/mute, Mute User, Mute Message UserTimeout Members (and Manage Roles if you use mute roles)
/pruneManage Messages
/spamalertEmbed Links, Manage Messages, Timeout Members
/buttonroleManage Roles, and a role above the one being given
/eventtimerManage Channels
/socialstatsManage Channels
/starboard, /autopublishEmbed Links
/invite createCreate Invite
/edit_banners, /edit_banner_overlays, /edit_icons, /upload_banner_staff, /upload_banner_overlay, /upload_icon_staff, /rotation_playlistManage Messages
/showdownAdd Reactions, Read Message History
/vibecheckRead Message History

Permissions Buddy needs for features#

FeatureBuddy needs
Welcome messagesEmbed Links (Embed style), Attach Files (welcome image) in the welcome channel
Join roles, button roles, reaction roles, level and invite reward rolesManage Roles, with Buddy's role above those roles; reaction roles also need Add Reactions and Manage Messages
Message filters, image-only channels, counting channelManage Messages
Server logsSend Messages in log channels; View Audit Log to name who banned someone
Ticket systemManage Channels; Read Message History for transcripts
Forum supportSend Messages in Threads; Manage Threads for status buttons
Embed builderEmbed Links; Manage Messages to update or delete posted embeds
Announcements (auto-publish)Manage Messages in the announcement channel
Event timers, counter channelsManage Channels
Banners and iconsManage Server
Invite trackingManage Server
Bot nicknameChange Nickname

Details and fixes for each are in Permissions & roles.

Loading…