Discord's New Modal Components: How Radio Groups and Checkboxes Change Bot Interactions
Discord bots no longer have to ask people to type "yes" into a text box.
Modals now support radio groups, checkbox groups and standalone checkboxes. That gives developers real form controls instead of text inputs and select menus.
This article covers the Discord modal components update: what shipped, how each component works, which libraries added support, and what it means for bots and the communities that use them.
๐ฅ Main Story: Discord Modal Components Now Include Radio Groups and Checkboxes
Discord's developer changelog introduced three new modal components in its February 12, 2026 entry. They are Radio Groups, Checkbox Groups and Checkboxes.
Discord describes them as ways to collect single choice answers, multi select answers and simple yes or no toggles. Each one is built for modals only.
The key fact: all three components must sit inside a Label component, which also carries the title and description.
๐ฎ What Happened
The change was a long time coming. A community thread titled "Most Wanted Features for Modals" on the Discord API docs repository has requested boolean style components since January 2023.
Modals themselves grew in steps. The changelog shows the Label component and String Selects arriving in August 2025, more select menus and Text Display in September 2025, and File Upload in October 2025. Radio and checkbox components followed in February 2026.
๐งญ Navigation: Main Story โ What Happened โ Why It Matters โ Key Details โ Deeper Breakdown โ Comparison โ Creator Note โ What Happens Next
๐งฑ Modal timeline: ๐ท๏ธ Label and String Select โ ๐ค More selects and Text Display โ ๐ File Upload โ โ Radio and Checkbox โ ๐ File type filters
๐ง Why It Matters
Before this change, a bot that needed a yes or no answer had to use a text field or a select menu. Both worked, but neither felt like a form.
Radio buttons and checkboxes are patterns people already know. A bot can now ask for one choice, several choices or a confirmation in the way users expect.
โ ๏ธ Important: These components are available only in modals, not in regular messages. They also require a Label wrapper, so older modal code may need updating.
โก Key Details
| Detail | Information |
|---|---|
| Components | Radio Group, Checkbox Group, Checkbox |
| Changelog date | February 12, 2026 |
| Where they work | Modals only |
| Required wrapper | Label component |
| Radio Group | Pick exactly one option |
| Checkbox Group | Multiple options with min and max values |
| Checkbox | Single yes or no toggle |
| Status | Confirmed |
๐ Deeper Breakdown
How Each Component Works
The Radio Group lets a user choose exactly one option from a list. Discord's changelog notes it supports a required field, so a radio group can be made optional.
The Checkbox Group handles multiple selections, with min_values and max_values setting how many a user must or may pick. The standalone Checkbox returns a simple true or false answer.
Third party library docs add option limits. Seyfert's release notes describe radio groups with 2 to 10 options. A separate community library lists checkbox groups at 1 to 10 choices. Check Discord's component reference for the current official limits.
Library Support
Most major libraries moved quickly. Seyfert shipped support on February 13, 2026, and a community comment on the same GitHub thread says discord.js v14.26.0 added it by April 1, 2026.
JDA's release notes show a "Welcome Screening" example with a rules checkbox and a radio group. The Pycord docs also list a CheckboxGroup class.
๐ก Note: Results come back in different shapes. In JDA, a checkbox group returns a list of strings, while a radio group returns a single string.
What We Know
- Confirmed: three new components exist, they work only in modals, and each must be placed in a Label.
- Reported: libraries including Seyfert, discord.js, JDA and Pycord support them, and third party docs list option limits.
- Not confirmed: whether other form controls are coming, such as number inputs, date pickers or color pickers, all of which appear on the community wish list.
What Could Happen Next
This section is speculation. Discord could keep adding form controls, since modals have gained a new capability roughly every few months.
It could also extend some components beyond modals. Nothing like that has been announced.
๐ Quick Comparison
| Need | Before | After |
|---|---|---|
| Pick one option | String Select or typed text | Radio Group |
| Pick several options | String Select with max values | Checkbox Group |
| Yes or no | Typed answer | Checkbox |
| Layout | Action row with Text Input | Label wrapper |
๐งฐ September Changes Worth Knowing
The modal story did not stop in February. The changelog shows steady work around interactions this summer and fall.
On August 5, 2026, Discord added a file_types filter so File Upload components and attachment command options can restrict which files users upload. On September 11, 2026, string options in slash commands gained multiline input, and command autocomplete gained fuzzy search.
Together, these changes make slash command plus modal workflows more capable. A command can collect the basics, then open a modal that mixes text, choices and files.
๐ก Creator Note
For bot builders and community managers, the new components suit forms people fill in once and expect to work cleanly. Here are a few ideas.
- Build a welcome screening modal with a rules checkbox.
- Offer a role picker with a checkbox group and a minimum of one choice.
- Use a radio group for ticket priority or event sign up type.
- Add a yes or no checkbox to confirm a risky moderation action.
๐จ What Happens Next
- Watch the Discord developer changelog for new modal components.
- Watch your library's release notes for fixes and helper methods.
- Watch how your community responds to longer modal forms.
- Watch the official component reference for updated limits.
Update your library โ Add a Label wrapper โ Ship a modal โ Collect feedback
Final Takeaway
This is a developer feature, but it shapes what users see every day. A cleaner modal means fewer typos, fewer confusing prompts and fewer bots that feel like command line tools.
The bigger point is the direction. Modals are slowly turning into proper forms, and each new component makes slash commands feel less like a workaround.
The best bot interface is the one where nobody has to read instructions before answering.
๐ Sources
- Discord Developer Change Log: Discord's official entry introducing radio groups, checkbox groups and checkboxes in modals.
- Discord Component Reference: Official documentation for each component, including the Label wrapper.
- Using Modal Components: Discord's guide to building modals.
- Seyfert v4.2.0 Release Notes: Library notes with code examples for radio groups and checkbox groups.
- JDA Releases: Release notes showing checkbox and radio group support in Java.
- Most Wanted Features for Modals: The community thread tracking modal feature requests since 2023.
- Pycord CheckboxGroup Source: Pycord's implementation of the checkbox group component.

Comments
Sign in to join the conversation
Sign inNo comments yet
Be the first to share your thoughts!