feat: Add spoiler channel flag and functions by ToothyDev · Pull Request #3252 · Pycord-Development/pycord

ToothyDev · 2026-06-05T13:57:33Z

Summary

This adds ChannelFlags.is_spoiler_channel (following https://docs.discord.food/resources/channel#channel-flags) as well as a .spoiler property to all applicable channel types (all except category). Same goes for making it possible to create these channels via the regular channel creation methods, again with the exception of category channels. Channel editing with this flag is also functional.

Now that it's officially documented, here's the ddocs PR: discord/discord-api-docs#8465

Depends on discord/discord-api-docs#8465

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.
AI Usage has been disclosed.
- If AI has been used, I understand fully what the code does
I have read the Contributing Guidelines

pycord-app · 2026-06-05T13:57:38Z

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/3252/head:pr-3252
git checkout pr-3252

This pull request can be installed with:

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

Lulalaby

take a shower <3

Lulalaby

took a shower apparently

Lulalaby

Can someone request changes reminding me to add editing & creating channels with that flag
and whatever else i may have forgotten

Soheab

Needs a way for bots to create this kind of channel

This message was sponsored by toothyfernsan on discord.

ToothyDev · 2026-06-05T18:33:26Z

I tested it with all but MediaChannels since I don't have access to those anywhere, but I'd still like a second pair of testing eyes on this

ToothyDev · 2026-06-06T18:05:55Z

Also, creating a channel with this turned on isn't possible unfortunately, gotta create + edit

# Conflicts: # CHANGELOG.md

Signed-off-by: Lala Sabathil <lala@pycord.dev>

JustaSqu1d · 2026-08-11T06:26:37Z

+            Whether the channel should be a spoiler channel. Mutually exclusive with :attr:`nsfw`, although
+            this will convert an nsfw channel into a spoiler channel.


Suggested change

Whether the channel should be a spoiler channel. Mutually exclusive with :attr:`nsfw`, although

this will convert an nsfw channel into a spoiler channel.

Whether the channel should be a spoiler channel.

.. warning::

This cannot be enabled alongside :attr:`nsfw`. Applying this to an existing NSFW channel will convert it into a spoiler channel.

Something along those lines.

JustaSqu1d · 2026-08-11T06:32:32Z

@@ -1524,6 +1564,13 @@ async def create_text_channel(
            The default auto archive duration in minutes for threads created in this channel.

            .. versionadded:: 2.7
+        spoiler: :class:`bool`
+            Whether the channel is marked as a spoiler channel.
+
+            .. versionadded:: 2.9
+
+            .. warning::
+                Passing both this and ``nsfw`` as ``True`` will mark the channel as NSFW and ignore the spoiler flag.


What if we raised an error instead because passing both is impossible.

Passing both to the API does work fine and causes the noted behavior

Yeah and imo warning is better here because we shouldn't assume a specific behavior is disallowed just because it doesn't work. Let Bad Request from discord cascade if it ever becomes a thing

JustaSqu1d · 2026-08-11T06:33:00Z


 - Added `Member.vr_status` property.
  ([#3328](https://github.com/Pycord-Development/pycord/pull/3328))
+- Added spoiler channel functionality


Suggested change

- Added spoiler channel functionality

- Added Spoiler Channels.

I made it lowercase cause that seems to be the convention in the rest of the docs

Paillat-dev · 2026-08-11T13:02:07Z

@ToothyDev Can you add to the PR body a link to the discord api docs PR for it ?

ToothyDev · 2026-08-12T15:26:11Z

The Stage Channel edit is a weird case and I'm not sure what to prefer here. The existing edit function doesn't even allow nsfw being passed there at all, while the creation method does allow it. Functionally, stage channels don't support NSFW behavior at all, so idk whether I should add the nsfw param to the edit method too for parity

Signed-off-by: ToothyDev <55001472+ToothyDev@users.noreply.github.com>

Paillat-dev

In the warn()s you use NSFW in all caps, and mention that the channel will "become" even when it doesn't exist yet.

A better wording would indicate that the two parameters (with their python name) are exclusive, and which of the two will be ignored.

Add spoiler channel flag and functions

b1ded01

ToothyDev added upcoming discord feature Involves a feature not yet fully released by Discord on hold labels Jun 5, 2026

github-project-automation Bot added this to Pycord Jun 5, 2026

github-project-automation Bot moved this to Todo in Pycord Jun 5, 2026

ToothyDev added the hold: testing This pull request requires further testing label Jun 5, 2026

Lulalaby requested changes Jun 5, 2026

View reviewed changes

Lulalaby approved these changes Jun 5, 2026

View reviewed changes

Lulalaby requested changes Jun 5, 2026

View reviewed changes

Soheab requested changes Jun 5, 2026

View reviewed changes

Soheab added hold: changelog This pull request is missing a changelog entry and removed hold: changelog This pull request is missing a changelog entry labels Jun 5, 2026

Add editing spoiler flag to channel editing functions

7b79faa

ToothyDev requested review from Lulalaby, Paillat-dev and Soheab June 5, 2026 18:24

ToothyDev moved this from Todo to In Progress in Pycord Jun 5, 2026

Paillat-dev added this to the 2.9.0rc1 milestone Jun 7, 2026

ToothyDev and others added 3 commits June 22, 2026 22:13

Merge branch 'master' into feat/spoiler-channels

9d09881

# Conflicts: # CHANGELOG.md

Merge branch 'master' into feat/spoiler-channels

65bfc90

Signed-off-by: Lala Sabathil <lala@pycord.dev>

fix: changelog

f426f25

Signed-off-by: Lala Sabathil <lala@pycord.dev>

github-actions Bot added the invalid This doesn't seem right label Jul 30, 2026

This comment was marked as resolved.

Sign in to view

github-actions Bot closed this Jul 30, 2026

github-actions Bot locked as spam and limited conversation to collaborators Jul 30, 2026

github-project-automation Bot moved this from In Progress to Done in Pycord Jul 30, 2026

Pycord-Development unlocked this conversation Jul 30, 2026

ToothyDev requested a review from Paillat-dev August 10, 2026 17:31

JustaSqu1d requested changes Aug 11, 2026

View reviewed changes

pullapprove4 Bot removed the PA: All Contributors pending label Aug 11, 2026

ToothyDev added 2 commits August 11, 2026 14:50

Add overloads for voice and forum channels

c8f6f61

Apply change requests from code review

b56e022

ToothyDev requested a review from JustaSqu1d August 11, 2026 12:56

pullapprove4 Bot added the PA: All Contributors pending label Aug 11, 2026

ToothyDev removed the hold: testing This pull request requires further testing label Aug 11, 2026

Paillat-dev requested changes Aug 11, 2026

View reviewed changes

Comment thread discord/channel.py

Comment thread discord/channel.py Outdated

pullapprove4 Bot removed PA: All Contributors pending PA: Maintainers pending labels Aug 11, 2026

Apply change requests from code review

2582634

ToothyDev requested a review from Paillat-dev August 11, 2026 15:50

pullapprove4 Bot added PA: All Contributors pending PA: Maintainers pending labels Aug 11, 2026

Fix edit() overloads

ccca218

vmphase reviewed Aug 13, 2026

View reviewed changes

Comment thread discord/guild.py Outdated

Comment thread discord/channel.py Outdated

Comment thread discord/channel.py Outdated

Comment thread discord/channel.py Outdated

Comment thread discord/guild.py

Comment thread discord/guild.py

Address change requests

74dda97

ToothyDev requested a review from vmphase August 13, 2026 14:14

ToothyDev and others added 2 commits August 14, 2026 23:53

Merge branch 'master' into feat/spoiler-channels

0e64964

Signed-off-by: ToothyDev <55001472+ToothyDev@users.noreply.github.com>

fixup! Merge branch 'master' into feat/spoiler-channels

8fcaf91

Paillat-dev requested changes Aug 15, 2026

View reviewed changes

Comment thread discord/channel.py Outdated

Comment thread discord/channel.py Outdated

Comment thread discord/flags.py

Comment thread discord/guild.py Outdated

Comment thread discord/guild.py Outdated

pullapprove4 Bot removed PA: All Contributors pending PA: Maintainers pending labels Aug 15, 2026

Address change requests

414bd34

ToothyDev requested a review from Paillat-dev August 15, 2026 16:14

pullapprove4 Bot added PA: All Contributors pending PA: Maintainers pending labels Aug 15, 2026

		Whether the channel should be a spoiler channel. Mutually exclusive with :attr:`nsfw`, although
		this will convert an nsfw channel into a spoiler channel.

	- Added spoiler channel functionality
	- Added Spoiler Channels.

Uh oh!

Uh oh!

Conversation

ToothyDev commented Jun 5, 2026 • edited by Paillat-dev Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Information

Checklist

Uh oh!

pycord-app Bot commented Jun 5, 2026

Uh oh!

Lulalaby left a comment

Choose a reason for hiding this comment

Uh oh!

Lulalaby left a comment

Choose a reason for hiding this comment

Uh oh!

Lulalaby left a comment

Choose a reason for hiding this comment

Uh oh!

Soheab left a comment

Choose a reason for hiding this comment

Uh oh!

ToothyDev commented Jun 5, 2026

Uh oh!

ToothyDev commented Jun 6, 2026

Uh oh!

This comment was marked as resolved.

Uh oh!

Uh oh!

JustaSqu1d Aug 11, 2026

Choose a reason for hiding this comment

Uh oh!

JustaSqu1d Aug 11, 2026

Choose a reason for hiding this comment

Uh oh!

JustaSqu1d Aug 11, 2026

Choose a reason for hiding this comment

Uh oh!

ToothyDev Aug 11, 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!

Paillat-dev Aug 11, 2026

Choose a reason for hiding this comment

Uh oh!

JustaSqu1d Aug 11, 2026

Choose a reason for hiding this comment

Uh oh!

ToothyDev Aug 11, 2026

Choose a reason for hiding this comment

Uh oh!

Paillat-dev commented Aug 11, 2026

Uh oh!

Uh oh!

Uh oh!

ToothyDev commented Aug 12, 2026

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Paillat-dev left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

ToothyDev commented Jun 5, 2026 •

edited by Paillat-dev

Loading

ToothyDev Aug 11, 2026 •

edited

Loading