Discord Interactions | Pycord Guide (2024)

In December 2020, Discord released their first Interaction: theSlash Command.Since then, Discord has added many types of Interactions, including:

Application Commands

• Slash Commands:Commands that can be used with the / prefix.
• Context Menu Commands: Commands that can be used from the right-click menu.
  • User Commands:Commands that can be used on a user by alt-clicking/selecting them.
  • Message Commands:Commands that can be used on a message by alt-clicking/selecting it.

UI Components

• Buttons:Buttons are attached to a message and can be clicked on to perform an action.
• Select Menus:Drop-down menus are used to select a number of options from a list.
• Modals:Form-like modals can be used to ask for input from a user.

Application Commands are another set of new features that are intended to avoid compromising users' safety and privacy.They're relatively easy to add to your bot, and give people a simpler and safer way to use commands.

Slash Commands​

Slash Commands were the first Interaction added to Discord. They're easy to use and create, andis the only prefix commands alternative that does not need Message Content intent.

This is what a Slash Command looks like. Not too different from a prefix command,apart from the note telling you who invoked it. A Slash Command's fields can accept any of the following:

• Members
• Roles
• Channels
• Attachments
• Text

Just about as good as it gets.

Message and User Commands​

Message Commands and User Commands were both introduced at around the same time, and are very similar to each other, so we'll beintroducing them together. These commands can be found in the Apps tab when alt-clicking. The only difference between the two is thatMessage Commands only appear in the Apps tab of a message, while User Commands are found in the Apps tab of a user. Message Commandscan be used to quickly report a message, warn a user for a message, and other functions. Likewise, User Commands can be used to add auser to a ticket, warn a user, and more.

Here's an example of a Message Command:

And here's an example of a User Command:

Pretty cool, right? To learn more about these two, please read the Context Menus guide.

Application Commands vs. Prefix Commands​

Ever since Discord was created, apps on it have used prefix commands. Using prefixes meant that you would have to put acertain character (or string of characters) in front of your command, such as the exclamation mark in !ping. The way thisworked was that your bot would listen for messages, pick out the ones that had their specific prefix, and then respond to the command.Now, Discord is encouraging developers to switch their bots over to Application Commands, which is a new system meant to preserve theprivacy and safety of their users. But why exactly is Discord making us switch? What's the better option, Application Commands or prefixcommands? Below, we'll discuss everything you need to know.

Discord's Decision​

Application Commands were conceptualized partly due to privacy concerns. When Discord first began, they weren't entirely concerned about botshaving access to the content of every message that was being sent. However, as Discord grew, this became more of a problem. Hypothetically, botscould simply log every message they're able to receive via the Discord API and hand their contents over to a company or other third party. This isa problem, since that data is meant to be used only by Discord. As such, they locked down Message Content, and introduced Application Commands forbot developers to use instead.

Prefix commands work by reading messages, as described before. Application Commands, however, don'twork this way; instead, they work by having your bot get information from Discord about when a command was used. This way, Discord can limitMessage Content only to bots that absolutely depend on it, such as auto-moderation bots.

Who has to Use Application Commands​

Any verified bot that does not have the Message Content intent must use Application Commands. Discord is allowing developers to submitapplications for the ability to use the intent; however, since they don't want to keep supporting prefix commands due to privacy concerns,they will automatically decline any application that includes only that as a reason. So, if your bot doesn't have an auto-moderation feature(or any other functionality that requires Message Content), you're out of luck.

Unverified bots, however, don't have to use Application Commands. This is because the Message Content intent is a Privileged Intent, meaning thatit must be applied for only if your bot is verified or about to be verified. Unverified bots don't have to apply for Privileged Intents, so they canuse them freely.

So, if your bot is made only for a couple of servers, you can choose between prefix commands and Application Commands. However, if you plan on expandingyour bot's reach, it'll have to use Application Commands.

What's the Better Option​

Choosing which is the better option is up to you, if you're starting small. Ifyou plan on growing your bot, however, you will have to use Application Commands. Since prefix commands are slowly being phased out by Discord,there isn't much of a choice for developers of larger bots.

Message Components are fairly new features in Discord, allowing developers to give their bots a fastand understandable user interface. Message Components are easy to use and make your bot look modern,sleek, and downright awesome.

Views​

Views are not an Application Command nor are they a Message Component. Views are the invisible placeholders, or grid,that Message Components lie in. Views can have up to 5 Action Rows,and Action Rows can have a maximum of 5 slots. Below, you can find a table showing how many slots a Message Interaction takes up.

So, based on this, you could have a maximum of 25 Buttons in a View with no Select Menus, and 5 SelectMenus in a View with no Buttons. This doesn't mean you can't have them both in a View, however. You can havea combination of them, such as 20 Buttons and a Select Menu or 10 Buttons and 3 Select Menus.

Buttons​

Buttons are the first of the Message Components. They allow for quick responses to prompts, such as for canceling or continuing an action.Of course, these aren't their only uses; people have created awesome things with Buttons, such as calculators, games, and more!

This is what a Button looks like, very simple and modern. To learn more about Buttons, refer to ourButtons page.

Select Menus​

Select Menus are the second of Discord's Message Components. They allow users to select from a list of choices, which your bot can then use.Select Menus are good for things such as choosing features, pages of a help menu, and more.

This is what a Select Menu looks like. While not looking as good as Buttons, they still look greatand have even greater possibilities. To learn more about Select Menus, please refer to our SelectMenus page.

Modal Dialogs​

Text Modals are the most recently added Message Component in Discord. They're useful for text input and filling out forms, such as asign-up for your bot's service. These are meant to replace long bot setup processes by allowing users to fill out multiple text fields,which avoids having the user send multiple messages for the bot. Modals can be accessed by either invoking an Application Command or byinteracting with another UI Component.

This is what a Text Modal looks like, easy to use and one of the most useful Message Components yet. To learn more about Text Modals,please visit our Modal Dialogs page.