Introduce the `GUILD_MEDIA` channel type #6232

insacc · 2023-06-15T21:57:41Z

Description

Introduces the GUILD_MEDIA (16) channel type.

A GUILD_MEDIA is a channel that is very similar (from an API perspective) to a GUILD_FORUM channel, where only threads can be created in that channel and messages cannot be sent directly in that channel

Note: This feature is still in active development. Many aspects are subject to change

MinnDevelopment · 2023-06-15T22:04:47Z

docs/topics/Threads.md


-In forum channels, the first message in a thread and the channel topic can both contain markdown for bulleted lists and headings (unlike text channels).
+In thread-only channels, the first message in a thread and the channel topic can both contain markdown for bulleted lists and headings (unlike text channels).


Isn't this outdated anyway? I believe you can use lists and heading anywhere now.

This is probably more accurate:

Suggested change

In thread-only channels, the first message in a thread and the channel topic can both contain markdown for bulleted lists and headings (unlike text channels).

In thread-only channels, the channel topic can contain markdown for bulleted lists and headings (unlike text channels).

yes it's anywhere usable

We're going to update this in a new PR after this PR gets merged in, thank you for catching this 🙌

docs/resources/Channel.md

shaydewael

Some small wording changes, thanks :)

docs/Change_Log.md

docs/topics/Threads.md

onerandomusername · 2023-06-18T19:35:06Z

This implies support for webhooks but they are not visible to edit in the client.

discord/discord-api-docs#6232

docs/resources/Channel.md

docs/resources/Guild.md

discord/discord-api-docs#6232

IllagerCaptain · 2023-06-27T19:19:23Z

My server had access to this experiment early on, so it has some pretty old media channels. This doesn't apply to any new media channels I create, but older ones appear with type GUILD_FORUM with the flags field set with the 1 << 10 bitwise operator. Additionally, webhooks are fully functional in these older ones, and appear on the client, regardless if any are created. This is not true for recently created media channels.

docs/resources/Channel.md

Co-authored-by: Danny <[email protected]>

Co-authored-by: shay <[email protected]>

insacc · 2023-07-21T19:05:25Z

My server had access to this experiment early on, so it has some pretty old media channels. This doesn't apply to any new media channels I create, but older ones appear with type GUILD_FORUM with the flags field set with the 1 << 10 bitwise operator. Additionally, webhooks are fully functional in these older ones, and appear on the client, regardless if any are created. This is not true for recently created media channels.

Thank you reporting this. Just to confirm, you're saying webhooks aren't working for the GUILD_MEDIA channel type, right? I'll create a ticket and investigate this.

docs/topics/Threads.md

valdotle · 2023-07-21T18:46:02Z

docs/topics/Threads.md

+
+### Creating Threads in Forum and Media Channels
+
+Within thread-only channels, threads appear as posts. Threads can be created using the [`POST /channels/<channel_id>/threads`](#DOCS_RESOURCES_CHANNEL/start-thread-in-forum-channel) endpoint with [slightly different parameters](#DOCS_RESOURCES_CHANNEL/start-thread-in-forum-channel-jsonform-params) than threads in text channels. For example, when creating threads in a threads-only channel, a message is created that has the same ID as the thread which requires you to pass parameters for both a thread *and* a message.


I think it's not ideal to use the term "thread-only channel" without really explaining that it's referring to Forum and Media Channels. This might add add unnecessary confusion, especially given that in other places this is not abbreviated in this way.
Maybe the Forum and Media channel sections could be grouped under a "thread-only channels" section to make the definition more clear.

valdotle · 2023-07-21T18:51:24Z

docs/resources/Channel.md

@@ -67,6 +67,9 @@ Represents a guild or DM channel within Discord.
 | GUILD_STAGE_VOICE   | 13  | a voice channel for [hosting events with an audience](https://support.discord.com/hc/en-us/articles/1500005513722)                                         |
 | GUILD_DIRECTORY     | 14  | the channel in a [hub](https://support.discord.com/hc/en-us/articles/4406046651927-Discord-Student-Hubs-FAQ) containing the listed servers                 |
 | GUILD_FORUM         | 15  | Channel that can only contain threads                                                                                                                      |
+| GUILD_MEDIA         | 16  | Channel that can only contain threads, similar to `GUILD_FORUM` channels                                                                                     |


docs/Change_Log.md

Lulalaby · 2023-07-21T20:11:24Z

Thank you reporting this. Just to confirm, you're saying webhooks aren't working for the GUILD_MEDIA channel type, right? I'll create a ticket and investigate this.

If I'm not mistaken, it should be already on the bug list. I remember it being mentioned in ddevs

IllagerCaptain · 2023-07-23T15:44:42Z

My server had access to this experiment early on, so it has some pretty old media channels. This doesn't apply to any new media channels I create, but older ones appear with type GUILD_FORUM with the flags field set with the 1 << 10 bitwise operator. Additionally, webhooks are fully functional in these older ones, and appear on the client, regardless if any are created. This is not true for recently created media channels.

Thank you reporting this. Just to confirm, you're saying webhooks aren't working for the GUILD_MEDIA channel type, right? I'll create a ticket and investigate this.

Correct. However, after posting this, my media channels automatically converted to type 16. Attempting to create a webhook via the API returns an error.

Jiralite · 2023-07-27T22:31:31Z

docs/topics/Threads.md


 - The `last_message_id` field is the ID of the most recently created thread in that channel. As with messages, your app will not receive a `CHANNEL_UPDATE` event when the field is changed. Instead clients should update the value when receiving [Thread Create](#DOCS_TOPICS_GATEWAY_EVENTS/thread-create) events.
 - The `topic` field is what is shown in the "Guidelines" section within the Discord client.
- The `rate_limit_per_user` field limits how frequently threads can be created. There is a new `default_thread_rate_limit_per_user` field on forums as well, which limits how often messages can be sent _in a thread_. This field is copied into `rate_limit_per_user` on the thread at creation time.
+- The `rate_limit_per_user` field limits how frequently threads can be created. There is a new `default_thread_rate_limit_per_user` field on thread-only channels as well, which limits how often messages can be sent _in a thread_. This field is copied into `rate_limit_per_user` on the thread at creation time.


The create guild channel endpoint respects default_thread_rate_limit_per_user for media channels (as well as announcement channels and forums channels). Perhaps this should be documented in the JSON parameters of this endpoint and the channel types should be noted in the channel structure.

Add default_thread_rate_limit_per_user to Create Guild Channel #5978

Co-authored-by: Valle <[email protected]>

advaith1 · 2023-08-01T21:24:54Z

docs/topics/Threads.md


-A thread can be pinned within a forum, which will be represented as the [`PINNED` flag](#DOCS_RESOURCES_CHANNEL/channel-object-channel-flags) in the `flags` field within a forum channel. A thread that is pinned will have the `(1 << 1)` flag set, and archiving that thread will unset the flag. A pinned thread will *not* auto-archive.
+A thread can be pinned within a thread-only, which will be represented as the [`PINNED` flag](#DOCS_RESOURCES_CHANNEL/channel-object-channel-flags) in the `flags` field within a thread-only channel. A thread that is pinned will have the `(1 << 1)` flag set, and archiving that thread will unset the flag. A pinned thread will *not* auto-archive.


this should say "thread-only channel"

Common functionality between ForumChannel and MediaChannel was extracted to a new ThreadOnlyChannel supertype. See discord/discord-api-docs#6232

Common functionality between ForumChannel and MediaChannel was extracted to a new ThreadOnlyChannel supertype. see discord/discord-api-docs#6232

Common functionality between ForumChannel and MediaChannel was extracted to a new ThreadOnlyChannel supertype. See discord/discord-api-docs#6232

See discord/discord-api-docs#6232.

* Add docs about GUILD_MEDIA channel type * Add more information about media channels * Create a changelog for the `GUILD_MEDIA` channel type * Update docs/resources/Channel.md Co-authored-by: Danny <[email protected]> * Update the change log Co-authored-by: shay <[email protected]> * Update the wording on the change log Co-authored-by: shay <[email protected]> * Update more wording on the change log Co-authored-by: shay <[email protected]> * Move info to the intro Co-authored-by: shay <[email protected]> * Remove the moved info Co-authored-by: shay <[email protected]> * Replace slash with `and` Co-authored-by: shay <[email protected]> * Update the beta state Co-authored-by: shay <[email protected]> * Fix more wording Co-authored-by: shay <[email protected]> * Address more pr comments * Address more pr comments * Fix broken links * Fix typo Co-authored-by: Valle <[email protected]> * Address more pr comments --------- Co-authored-by: shay <[email protected]> Co-authored-by: Danny <[email protected]> Co-authored-by: Valle <[email protected]>

MinnDevelopment reviewed Jun 15, 2023

View reviewed changes

Rapptz reviewed Jun 15, 2023

View reviewed changes

docs/resources/Channel.md Outdated Show resolved Hide resolved

onerandomusername reviewed Jun 15, 2023

View reviewed changes

docs/resources/Channel.md Show resolved Hide resolved

seailz mentioned this pull request Jun 16, 2023

Media Channels discord-jar/discord.jar#187

Closed

3 tasks

shaydewael approved these changes Jun 16, 2023

View reviewed changes

HTGAzureX1212 mentioned this pull request Jun 17, 2023

Support Media Channels twilight-rs/twilight#2221

Closed

onerandomusername mentioned this pull request Jun 18, 2023

feat: support media channels DisnakeDev/disnake#1050

Merged

8 tasks

suneettipirneni mentioned this pull request Jun 20, 2023

feat(model): Add support for guild media channels twilight-rs/twilight#2222

Merged

Jiralite mentioned this pull request Jun 20, 2023

feat: Add media channels discordjs/discord.js#9662

Merged

DonovanDMC added a commit to OceanicJS/Oceanic that referenced this pull request Jun 21, 2023

media channel

b1e2885

discord/discord-api-docs#6232

LordOfPolls mentioned this pull request Jun 22, 2023

feat: support media channels interactions-py/interactions.py#1458

Merged

13 tasks

Jiralite reviewed Jun 22, 2023

View reviewed changes

Jiralite mentioned this pull request Jun 22, 2023

feat: Add Media channels discordjs/discord-api-types#777

Merged

ooliver1 reviewed Jun 22, 2023

View reviewed changes

docs/resources/Channel.md Show resolved Hide resolved

docs/resources/Guild.md Outdated Show resolved Hide resolved

docs/resources/Guild.md Outdated Show resolved Hide resolved

DonovanDMC added a commit to OceanicJS/Oceanic that referenced this pull request Jun 22, 2023

media channel

e6e1dfd

discord/discord-api-docs#6232

DonovanDMC added a commit to OceanicJS/Oceanic that referenced this pull request Jun 22, 2023

media channel

0860c50

discord/discord-api-docs#6232

sebm253 mentioned this pull request Jun 30, 2023

Add Media Channels disgoorg/disgo#285

Merged

seailz mentioned this pull request Jul 6, 2023

feat(channels): media channels discord-jar/discord.jar#195

Merged

4 tasks

Panthr75 mentioned this pull request Jul 7, 2023

[Feature] Media channel support Panthr75/Based-Discord.Net#1

Merged

1 task

Misha-133 reviewed Jul 7, 2023

View reviewed changes

docs/resources/Channel.md Outdated Show resolved Hide resolved

Misha-133 mentioned this pull request Jul 7, 2023

[Feature] Media channel support discord-net/Discord.Net#2725

Merged

insacc and others added 7 commits July 21, 2023 13:46

Add docs about GUILD_MEDIA channel type

3aad729

Add more information about media channels

16ab0b8

Create a changelog for the GUILD_MEDIA channel type

5d08e6e

Update docs/resources/Channel.md

a5f8498

Co-authored-by: Danny <[email protected]>

Update the change log

2cdd1bd

Co-authored-by: shay <[email protected]>

Update the wording on the change log

cc72f68

Co-authored-by: shay <[email protected]>

Update more wording on the change log

d24f8ce

Co-authored-by: shay <[email protected]>

insacc and others added 5 commits July 21, 2023 13:46

Replace slash with and

daaf57a

Co-authored-by: shay <[email protected]>

Update the beta state

8d7f4fb

Co-authored-by: shay <[email protected]>

Fix more wording

7029bd8

Co-authored-by: shay <[email protected]>

Address more pr comments

bcddc6c

Address more pr comments

44c9932

insacc force-pushed the task/add-guild-media-docs branch from 92cf21b to 44c9932 Compare July 21, 2023 17:47

valdotle reviewed Jul 21, 2023

View reviewed changes

Fix broken links

d4bfe97

Jiralite reviewed Jul 27, 2023

View reviewed changes

insacc and others added 2 commits August 1, 2023 12:58

Fix typo

2c216d8

Co-authored-by: Valle <[email protected]>

Address more pr comments

34f43bc

insacc merged commit 107de2d into main Aug 1, 2023

insacc deleted the task/add-guild-media-docs branch August 1, 2023 21:14

advaith1 reviewed Aug 1, 2023

View reviewed changes

lukellmann added a commit to kordlib/kord that referenced this pull request Aug 3, 2023

Add MediaChannels

308f5e8

Common functionality between ForumChannel and MediaChannel was extracted to a new ThreadOnlyChannel supertype. See discord/discord-api-docs#6232

lukellmann mentioned this pull request Aug 3, 2023

Add MediaChannels kordlib/kord#853

Merged

lukellmann added a commit to kordlib/kord that referenced this pull request Aug 3, 2023

Add MediaChannels

a49c648

Common functionality between ForumChannel and MediaChannel was extracted to a new ThreadOnlyChannel supertype. see discord/discord-api-docs#6232

lukellmann added a commit to kordlib/kord that referenced this pull request Aug 26, 2023

Add MediaChannels

8494434

Common functionality between ForumChannel and MediaChannel was extracted to a new ThreadOnlyChannel supertype. see discord/discord-api-docs#6232

lukellmann added a commit to kordlib/kord that referenced this pull request Sep 3, 2023

Add MediaChannels

2756a4d

Common functionality between ForumChannel and MediaChannel was extracted to a new ThreadOnlyChannel supertype. see discord/discord-api-docs#6232

lukellmann added a commit to kordlib/kord that referenced this pull request Sep 3, 2023

Add MediaChannels

fa7ab03

Common functionality between ForumChannel and MediaChannel was extracted to a new ThreadOnlyChannel supertype. See discord/discord-api-docs#6232

lukellmann added a commit to kordlib/kord that referenced this pull request Sep 3, 2023

Add MediaChannels

94b1864

Common functionality between ForumChannel and MediaChannel was extracted to a new ThreadOnlyChannel supertype. See discord/discord-api-docs#6232

lukellmann added a commit to kordlib/kord that referenced this pull request Sep 3, 2023

Add MediaChannels

e80d5c8

Common functionality between ForumChannel and MediaChannel was extracted to a new ThreadOnlyChannel supertype. See discord/discord-api-docs#6232

lukellmann added a commit to kordlib/kord that referenced this pull request Sep 3, 2023

Add MediaChannels

09d34aa

Common functionality between ForumChannel and MediaChannel was extracted to a new ThreadOnlyChannel supertype. See discord/discord-api-docs#6232

lukellmann added a commit to kordlib/kord that referenced this pull request Sep 3, 2023

Add MediaChannels (#853)

4aa9701

Common functionality between ForumChannel and MediaChannel was extracted to a new ThreadOnlyChannel supertype. See discord/discord-api-docs#6232

Nihlus added a commit to Remora/Remora.Discord that referenced this pull request Sep 17, 2023

Implement initial support for media channels.

3b43ec0

See discord/discord-api-docs#6232.

Azn9 mentioned this pull request Mar 20, 2024

Add support for the GUILD_MEDIA channel type Discord4J/Discord4J#1193

Open

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Introduce the `GUILD_MEDIA` channel type #6232

Introduce the `GUILD_MEDIA` channel type #6232

insacc commented Jun 15, 2023

MinnDevelopment Jun 15, 2023

Lulalaby Jun 15, 2023

insacc Aug 1, 2023

shaydewael left a comment

onerandomusername commented Jun 18, 2023

IllagerCaptain commented Jun 27, 2023

insacc commented Jul 21, 2023

valdotle Jul 21, 2023 •

edited

Loading

valdotle Jul 21, 2023

Lulalaby commented Jul 21, 2023

IllagerCaptain commented Jul 23, 2023

Jiralite Jul 27, 2023

advaith1 Jul 27, 2023

advaith1 Aug 1, 2023


		In forum channels, the first message in a thread and the channel topic can both contain markdown for bulleted lists and headings (unlike text channels).
		In thread-only channels, the first message in a thread and the channel topic can both contain markdown for bulleted lists and headings (unlike text channels).

	In thread-only channels, the first message in a thread and the channel topic can both contain markdown for bulleted lists and headings (unlike text channels).
	In thread-only channels, the channel topic can contain markdown for bulleted lists and headings (unlike text channels).


		### Creating Threads in Forum and Media Channels

		Within thread-only channels, threads appear as posts. Threads can be created using the [`POST /channels/<channel_id>/threads`](#DOCS_RESOURCES_CHANNEL/start-thread-in-forum-channel) endpoint with [slightly different parameters](#DOCS_RESOURCES_CHANNEL/start-thread-in-forum-channel-jsonform-params) than threads in text channels. For example, when creating threads in a threads-only channel, a message is created that has the same ID as the thread which requires you to pass parameters for both a thread and a message.

	\| GUILD_MEDIA \| 16 \| Channel that can only contain threads, similar to `GUILD_FORUM` channels \|
	\| GUILD_MEDIA\* \| 16 \| Channel that can only contain threads, similar to `GUILD_FORUM` channels \|


		A thread can be pinned within a forum, which will be represented as the [`PINNED` flag](#DOCS_RESOURCES_CHANNEL/channel-object-channel-flags) in the `flags` field within a forum channel. A thread that is pinned will have the `(1 << 1)` flag set, and archiving that thread will unset the flag. A pinned thread will not auto-archive.
		A thread can be pinned within a thread-only, which will be represented as the [`PINNED` flag](#DOCS_RESOURCES_CHANNEL/channel-object-channel-flags) in the `flags` field within a thread-only channel. A thread that is pinned will have the `(1 << 1)` flag set, and archiving that thread will unset the flag. A pinned thread will not auto-archive.

Introduce the GUILD_MEDIA channel type #6232

Introduce the GUILD_MEDIA channel type #6232

Conversation

insacc commented Jun 15, 2023

Description

MinnDevelopment Jun 15, 2023

Choose a reason for hiding this comment

Lulalaby Jun 15, 2023

Choose a reason for hiding this comment

insacc Aug 1, 2023

Choose a reason for hiding this comment

shaydewael left a comment

Choose a reason for hiding this comment

onerandomusername commented Jun 18, 2023

IllagerCaptain commented Jun 27, 2023

insacc commented Jul 21, 2023

valdotle Jul 21, 2023 • edited Loading

Choose a reason for hiding this comment

valdotle Jul 21, 2023

Choose a reason for hiding this comment

Lulalaby commented Jul 21, 2023

IllagerCaptain commented Jul 23, 2023

Jiralite Jul 27, 2023

Choose a reason for hiding this comment

advaith1 Jul 27, 2023

Choose a reason for hiding this comment

advaith1 Aug 1, 2023

Choose a reason for hiding this comment

Introduce the `GUILD_MEDIA` channel type #6232

Introduce the `GUILD_MEDIA` channel type #6232

valdotle Jul 21, 2023 •

edited

Loading