Discord Bot Tutorial#6Implementing a Dropdown (Select Menu)!

Hi there! This is Mojangcam 😎

In Part #5, we learned how to interact with a bot using buttons, right? This time we're going one step further and building a dropdown menu (Select Menu)!

Buttons are great when you have 2 or 3 choices, but once you have 5 or more, your screen fills up with buttons. That's where a dropdown menu comes in: it lets you fit up to 25 choices neatly into a single menu. You'll see it used all the time for role pickers, polls, game server selection menus, and more!

📌 What You Need

• Python 3.8 or later
• discord.py 2.x (Select Menus are supported starting from 2.0!)
• A bot token + the bot already invited to your server (see Part 1 of the series!)

pip install -U discord.py

You can check your version with pip show discord.py. If it's 2.x or later, you're good! It won't work on 1.x.

📌 Step 1 - Creating the Select (Dropdown) Class

The core of a dropdown is the discord.ui.Select class. You subclass it and define the choices (SelectOption) and what happens when someone makes a choice (callback).

import discord
from discord.ext import commands

class GameSelect(discord.ui.Select):
    def __init__(self):
        options = [
            discord.SelectOption(label="Minecraft", value="minecraft", description="A world built from blocks", emoji="⛏️"),
            discord.SelectOption(label="ARK: Survival", value="ark", description="Survive alongside dinosaurs!", emoji="🦖"),
            discord.SelectOption(label="Valorant", value="valorant", description="5v5 tactical FPS", emoji="🔫"),
        ]
        super().__init__(
            placeholder="Choose your favorite game!",
            min_values=1,
            max_values=1,
            options=options,
        )

    async def callback(self, interaction: discord.Interaction):
        await interaction.response.send_message(
            f"🎮 {interaction.user.mention} chose **{self.values[0]}**!"
        )

Let's break it down piece by piece 💡

• SelectOption : each individual choice shown in the dropdown. label is the name shown on screen, value is the value your code receives, description is the gray description text, and emoji is the emoji shown in front.
• placeholder : the hint text shown when nothing is selected yet.
• min_values / max_values : the minimum and maximum number of choices. Set max_values=3 and it becomes a multi-select menu! (up to 25)
• callback : the function that runs when the user finishes choosing. The selected values come in through the self.values list.

📌 Step 2 - Putting It in a View

As we learned in the button part, every UI component has to be put in a container called a View before you send it.

class GameSelectView(discord.ui.View):
    def __init__(self):
        super().__init__(timeout=60)  # disable after 60 seconds
        self.add_item(GameSelect())

By the way, a single dropdown takes up an entire row of the View. A View can have up to 5 rows, so you can put up to 5 dropdowns in one View.

📌 Step 3 - Sending It with a Slash Command

intents = discord.Intents.default()
bot = commands.Bot(command_prefix="!", intents=intents)

@bot.event
async def on_ready():
    await bot.tree.sync()
    print(f"✅ {bot.user} bot is ready!")

@bot.tree.command(name="게임선택", description="Pick your favorite game!")
async def game_select(interaction: discord.Interaction):
    await interaction.response.send_message("Make your choice below! 👇", view=GameSelectView())

bot.run("Token")

📌 Full Code (Copy-Paste OK)

# discord.py 2.x / Python 3.8+
import discord
from discord.ext import commands

class GameSelect(discord.ui.Select):
    def __init__(self):
        options = [
            discord.SelectOption(label="Minecraft", value="Minecraft", description="A world built from blocks", emoji="⛏️"),
            discord.SelectOption(label="ARK: Survival", value="ARK: Survival", description="Survive alongside dinosaurs!", emoji="🦖"),
            discord.SelectOption(label="Valorant", value="Valorant", description="5v5 tactical FPS", emoji="🔫"),
        ]
        super().__init__(placeholder="Choose your favorite game!", min_values=1, max_values=1, options=options)

    async def callback(self, interaction: discord.Interaction):
        await interaction.response.send_message(
            f"🎮 {interaction.user.mention} chose **{self.values[0]}**!"
        )

class GameSelectView(discord.ui.View):
    def __init__(self):
        super().__init__(timeout=60)
        self.add_item(GameSelect())

intents = discord.Intents.default()
bot = commands.Bot(command_prefix="!", intents=intents)

@bot.event
async def on_ready():
    await bot.tree.sync()
    print(f"✅ {bot.user} bot is ready!")

@bot.tree.command(name="게임선택", description="Pick your favorite game!")
async def game_select(interaction: discord.Interaction):
    await interaction.response.send_message("Make your choice below! 👇", view=GameSelectView())

bot.run("Token")

📌 Result

When you type /게임선택 (game select), the bot sends a message with a dropdown attached, and when you pick a game from the menu, it replies with "🎮 OO chose Minecraft!"

💡 Bonus: there are also dedicated dropdowns for picking users, roles, and channels! With discord.ui.UserSelect, discord.ui.RoleSelect, and discord.ui.ChannelSelect, you don't have to build the choices yourself. The server's user/role/channel list shows up automatically. I'll cover these in detail when I get the chance!

📌 Common Errors

1. This interaction failed

This happens when the callback doesn't respond within 3 seconds. If your processing takes a while, call await interaction.response.defer() first, then reply with interaction.followup.send().

2. The dropdown is grayed out and disabled

Once the View(timeout=60) time runs out, the component expires. If the menu needs to keep working, set timeout=None. (To keep it working even after the bot restarts, you need a persistent view + a custom_id, which I'll cover in an advanced part!)

3. TypeError: __init__() got an unexpected keyword argument 'options'

You get this error when you pass options to a dedicated select like UserSelect instead of discord.ui.Select. When you define your own choices, always use the basic discord.ui.Select.

📌 Wrapping Up

Today we learned how to neatly fit up to 25 choices into a dropdown (Select Menu). We've gone from buttons to dropdowns, so in the next part we'll cover how to get text input directly from users with a Modal! Stay tuned 🙌

📚 Discord Bot Tutorial Series

1. Mastering Slash Commands
2. Adding Options (Arguments) to Slash Commands
3. Adding Subcommands to Slash Commands
4. Sending Embeds with Slash Commands
5. Implementing Button Interactions
6. Implementing a Dropdown (Select Menu) ← You are here!