feat: Radio Groups & Checkboxes by NeloBlivion · Pull Request #3073 · Pycord-Development/pycord

NeloBlivion · 2026-01-21T04:04:40Z

Summary

Implements radio groups, checkbox groups, and checkboxes in modals

Alpha server only right now

Information

This PR fixes an issue.
This PR adds something new (e.g. new method or parameters).
This PR is a breaking change (e.g. methods or parameters removed/renamed).
This PR is not a code change (e.g. documentation, README, typehinting,
examples, ...).

Checklist

I have searched the open pull requests for duplicates.
If code changes were made then they have been tested.
- I have updated the documentation to reflect the changes.
If type: ignore comments were used, a comment is also left explaining why.
I have updated the changelog to include these changes.

pycord-app · 2026-01-21T04:04:44Z

Thanks for opening this pull request!
Please make sure you have read the Contributing Guidelines and Code of Conduct.

This pull request can be checked-out with:

git fetch origin pull/3073/head:pr-3073
git checkout pr-3073

This pull request can be installed with:

pip install git+https://github.com/Pycord-Development/pycord@refs/pull/3073/head

Lulalaby

SMH blindly copying

discord/types/components.py

Signed-off-by: Lala Sabathil <aiko@aitsys.dev>

discord/types/components.py

Signed-off-by: Lala Sabathil <aiko@aitsys.dev>

discord/types/components.py

Signed-off-by: Lala Sabathil <aiko@aitsys.dev>

CHANGELOG.md

discord/components.py

Co-authored-by: JustaSqu1d <89910983+JustaSqu1d@users.noreply.github.com> Signed-off-by: Nelo <41271523+NeloBlivion@users.noreply.github.com>

NeloBlivion · 2026-02-08T00:11:55Z

todo:

update with generate_underlying

Paillat-dev · 2026-02-10T20:16:53Z

Test Code

import logging
import os
from typing import override

from dotenv import load_dotenv

import discord

load_dotenv()
logging.basicConfig(level=logging.INFO)

bot = discord.Bot(intents=discord.Intents.all())


class WowModal(discord.ui.DesignerModal):
    def __init__(self):
        super().__init__(timeout=None, title="PYCORD IS AMAZING")
        self.add_item(
            discord.ui.Label(
                label="Enable",
                description="Enable or disable the bot",
                item=discord.ui.Checkbox(default=False),
            )
        )

    @override
    async def callback(self, interaction: discord.Interaction):
        await interaction.respond("Button clicked!")


@bot.slash_command(name="test_modalsv5")
async def test_modal(ctx: discord.ApplicationContext):
    await ctx.send_modal(WowModal())


bot.run(os.getenv("TOKEN_2"))

Fyi I encounter this:

Traceback (most recent call last):
  File "/home/paillat/Documents/pycord/pycord/discord/commands/core.py", line 138, in wrapped
    ret = await coro(arg)
          ^^^^^^^^^^^^^^^
  File "/home/paillat/Documents/pycord/pycord/discord/commands/core.py", line 1108, in _invoke
    await self.callback(ctx, **kwargs)
  File "/home/paillat/Documents/pycord/pycord/test_modals_v5.py", line 29, in test_modal
    await ctx.send_modal(WowModal())
                         ~~~~~~~~^^
  File "/home/paillat/Documents/pycord/pycord/test_modals_v5.py", line 18, in __init__
    self.add_item(discord.ui.Label(label="Enable", description="Enable or disable the bot", item=discord.ui.Checkbox(default=False)))
                  ~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/home/paillat/Documents/pycord/pycord/discord/ui/label.py", line 124, in __init__
    self.set_item(item)
    ~~~~~~~~~~~~~^^^^^^
  File "/home/paillat/Documents/pycord/pycord/discord/ui/label.py", line 177, in set_item
    self._set_component_from_item(item)
    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~^^^^^^
  File "/home/paillat/Documents/pycord/pycord/discord/ui/label.py", line 133, in _set_component_from_item
    self.underlying.component = item._generate_underlying()
                                ~~~~~~~~~~~~~~~~~~~~~~~~~^^
TypeError: Item._generate_underlying() missing 1 required positional argument: 'cls'

The above exception was the direct cause of the following exception:

Traceback (most recent call last):
  File "/home/paillat/Documents/pycord/pycord/discord/bot.py", line 1154, in invoke_application_command
    await ctx.command.invoke(ctx)
  File "/home/paillat/Documents/pycord/pycord/discord/commands/core.py", line 435, in invoke
    await injected(ctx)
  File "/home/paillat/Documents/pycord/pycord/discord/commands/core.py", line 146, in wrapped
    raise ApplicationCommandInvokeError(exc) from exc
discord.errors.ApplicationCommandInvokeError: Application Command raised an exception: TypeError: Item._generate_underlying() missing 1 required positional argument: 'cls'

NeloBlivion · 2026-02-11T00:38:23Z

probably done?

Soheab · 2026-02-11T11:10:34Z

discord/components.py

+        if self.default is not None:
+            payload["default"] = self.default


Can't be None, should be in the initial payload.

Soheab · 2026-02-11T11:12:58Z

discord/ui/checkbox.py

+    def __repr__(self) -> str:
+        attrs = " ".join(
+            f"{key}={getattr(self, key)!r}" for key in self.__item_repr_attributes__
+        )
+        return f"<{self.__class__.__name__} {attrs}>"


Why does it redefine this? It's handled by Item.

Soheab · 2026-02-11T11:17:41Z

discord/components.py

+    custom_id: Optional[:class:`str`]
+        The custom ID of the radio group that gets received during an interaction.
+    options: List[:class:`RadioGroupOption`]
+        A list of options that can be selected in this group.


Could mention that this can only contain min 2 and max 10 items.

Soheab · 2026-02-11T11:19:18Z

discord/ui/checkbox_group.py

+    def __repr__(self) -> str:
+        attrs = " ".join(
+            f"{key}={getattr(self, key)!r}" for key in self.__item_repr_attributes__
+        )
+        return f"<{self.__class__.__name__} {attrs}>"


Same as checkbox

Soheab · 2026-02-11T11:19:50Z

discord/ui/radio_group.py

+    def __repr__(self) -> str:
+        attrs = " ".join(
+            f"{key}={getattr(self, key)!r}" for key in self.__item_repr_attributes__
+        )
+        return f"<{self.__class__.__name__} {attrs}>"


Same as checkbox

Soheab · 2026-02-11T11:22:26Z

discord/ui/radio_group.py

+        if len(value) > 10:
+            raise ValueError("you may only provide up to 10 options.")


Maybe also check the minimum (2)?

Soheab · 2026-02-11T11:25:04Z

All version strings need changing to 2.8 too.

Paillat-dev · 2026-02-12T18:25:07Z

discord/ui/radio_group.py

+            )
+        if not isinstance(required, bool):
+            raise TypeError(f"required must be bool not {required.__class__.__name__}")  # type: ignore
+        custom_id = os.urandom(16).hex() if custom_id is None else custom_id


Could be neat to have validation for there to be max(?) one option with default set to True

Paillat-dev · 2026-02-13T12:25:53Z

For the record, PR tested and everything seems to work fine other than obviously the comments

plun1331 · 2026-02-13T20:45:09Z

discord/ui/file_upload.py

            raise TypeError(f"required must be bool not {required.__class__.__name__}")  # type: ignore
        custom_id = os.urandom(16).hex() if custom_id is None else custom_id
-        self._attachments: list[Attachment] | None = None
+        self._attachments: list[Attachment] = []


This was supposed to be None to differentiate between no interaction being recieved

hmmm this is awkward, it seems the select default values pr changed to to an empty list in selects and so I went off of that (even though the docs weren't updated); i'll revert both changes instead for consistency.

components

63c3ffd

style(pre-commit): auto fixes from pre-commit.com hooks

1241ce3

Lulalaby reviewed Jan 21, 2026

View reviewed changes

discord/types/components.py Outdated Show resolved Hide resolved

discord/types/components.py Outdated Show resolved Hide resolved

Apply suggestions from code review

1bd3289

Signed-off-by: Lala Sabathil <aiko@aitsys.dev>

Lulalaby reviewed Jan 21, 2026

View reviewed changes

discord/types/components.py Outdated Show resolved Hide resolved

Apply suggestion from @Lulalaby

b9d7c72

Signed-off-by: Lala Sabathil <aiko@aitsys.dev>

Lulalaby reviewed Jan 21, 2026

View reviewed changes

discord/types/components.py Outdated Show resolved Hide resolved

Lulalaby and others added 12 commits January 21, 2026 05:16

Apply suggestion from @Lulalaby

b083cc7

Signed-off-by: Lala Sabathil <aiko@aitsys.dev>

style(pre-commit): auto fixes from pre-commit.com hooks

3b1cca6

ui.RadioGroup

fbd34be

ui.CheckboxGroup

ce91556

,

76c6b69

style(pre-commit): auto fixes from pre-commit.com hooks

466eea2

ui.Checkbox

3609b35

style(pre-commit): auto fixes from pre-commit.com hooks

4f1e351

docs and label set methods

12b0ca0

style(pre-commit): auto fixes from pre-commit.com hooks

0babbcc

_component_to_item

183b591

style(pre-commit): auto fixes from pre-commit.com hooks

5b7cf97

JustaSqu1d requested changes Jan 21, 2026

View reviewed changes

CHANGELOG.md Outdated Show resolved Hide resolved

discord/components.py Outdated Show resolved Hide resolved

discord/components.py Outdated Show resolved Hide resolved

NeloBlivion and others added 8 commits January 21, 2026 00:30

options

34c7a8e

style(pre-commit): auto fixes from pre-commit.com hooks

fa8352e

imports

285ab74

style(pre-commit): auto fixes from pre-commit.com hooks

fe17a04

check

ed0fc06

all

71dde7f

style(pre-commit): auto fixes from pre-commit.com hooks

f4d3ec1

fix checkbox

44ae934

NeloBlivion marked this pull request as ready for review January 21, 2026 05:50

NeloBlivion and others added 2 commits February 8, 2026 00:09

Update discord/components.py

c5a17e8

Co-authored-by: JustaSqu1d <89910983+JustaSqu1d@users.noreply.github.com> Signed-off-by: Nelo <41271523+NeloBlivion@users.noreply.github.com>

Update discord/components.py

ad53199

Co-authored-by: JustaSqu1d <89910983+JustaSqu1d@users.noreply.github.com> Signed-off-by: Nelo <41271523+NeloBlivion@users.noreply.github.com>

Paillat-dev self-requested a review February 8, 2026 00:11

Soheab added priority: medium Medium Priority status: in progress Work in Progess upcoming discord feature Involves a feature not yet fully released by Discord python Pull requests that update Python code components Related to discord components (Views + Modals) labels Feb 8, 2026

NeloBlivion added 7 commits February 10, 2026 18:15

Merge branch 'master' into checkbox

35ce47e

convert to generate_underlying

0588f1c

values

c18ff0a

copyright

276fce0

RadioGroup.value clarification

ea23381

typing

2aa6f46

enum docs

0d41694

NeloBlivion and others added 4 commits February 10, 2026 19:46

docs

ebcd3bb

fix group underlying

1c31317

update types.components

417a61a

style(pre-commit): auto fixes from pre-commit.com hooks

817595d

Soheab requested changes Feb 11, 2026

View reviewed changes

Paillat-dev reviewed Feb 12, 2026

View reviewed changes

NeloBlivion added 2 commits February 13, 2026 11:15

Merge branch 'master' into checkbox

ef0fa72

Merge branch 'master' into checkbox

040f097

plun1331 reviewed Feb 13, 2026

View reviewed changes

change values to None if not received through interaction

e4fb423

		if self.default is not None:
		payload["default"] = self.default

		if len(value) > 10:
		raise ValueError("you may only provide up to 10 options.")

Uh oh!

Conversation

NeloBlivion commented Jan 21, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Information

Checklist

Uh oh!

pycord-app bot commented Jan 21, 2026

Uh oh!

Lulalaby left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

NeloBlivion commented Feb 8, 2026

Uh oh!

Paillat-dev commented Feb 10, 2026

Uh oh!

NeloBlivion commented Feb 11, 2026

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Soheab commented Feb 11, 2026

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Paillat-dev commented Feb 13, 2026

Uh oh!

Choose a reason for hiding this comment

Uh oh!

NeloBlivion Feb 13, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

NeloBlivion commented Jan 21, 2026 •

edited

Loading

NeloBlivion Feb 13, 2026 •

edited

Loading