From 217396e977cf7f5943515b4e1165892fa86d83f9 Mon Sep 17 00:00:00 2001 From: Droid <174426320+Droid00000@users.noreply.github.com> Date: Fri, 17 Apr 2026 17:37:57 -0400 Subject: [PATCH 1/5] Add Server Guide Documentation --- developers/reference.mdx | 50 ++++++++++++------------ developers/resources/audit-log.mdx | 4 +- developers/resources/guild.mdx | 63 ++++++++++++++++++++++++++++++ 3 files changed, 91 insertions(+), 26 deletions(-) diff --git a/developers/reference.mdx b/developers/reference.mdx index c674d8fa07..709f46559e 100644 --- a/developers/reference.mdx +++ b/developers/reference.mdx @@ -353,30 +353,32 @@ Discord uses ids and hashes to render images in the client. These hashes can be **CDN Endpoints** -| Type | Path | Supports | -|-----------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------| -| Custom Emoji | emojis/[emoji_id](/developers/resources/emoji#emoji-object).png \*\*\*\*\* | PNG, JPEG, WebP, GIF | -| Guild Icon | icons/[guild_id](/developers/resources/guild#guild-object)/[guild_icon](/developers/resources/guild#guild-object).png \* | PNG, JPEG, WebP, GIF | -| Guild Splash | splashes/[guild_id](/developers/resources/guild#guild-object)/[guild_splash](/developers/resources/guild#guild-object).png | PNG, JPEG, WebP | -| Guild Discovery Splash | discovery-splashes/[guild_id](/developers/resources/guild#guild-object)/[guild_discovery_splash](/developers/resources/guild#guild-object).png | PNG, JPEG, WebP | -| Guild Banner | banners/[guild_id](/developers/resources/guild#guild-object)/[guild_banner](/developers/resources/guild#guild-object).png \* | PNG, JPEG, WebP, GIF | -| User Banner | banners/[user_id](/developers/resources/user#user-object)/[user_banner](/developers/resources/user#user-object).png \* | PNG, JPEG, WebP, GIF | -| Default User Avatar | embed/avatars/[index](/developers/resources/user#user-object).png \*\* \*\*\* | PNG | -| User Avatar | avatars/[user_id](/developers/resources/user#user-object)/[user_avatar](/developers/resources/user#user-object).png \* | PNG, JPEG, WebP, GIF | -| Guild Member Avatar | guilds/[guild_id](/developers/resources/guild#guild-object)/users/[user_id](/developers/resources/user#user-object)/avatars/[member_avatar](/developers/resources/guild#guild-member-object).png \* | PNG, JPEG, WebP, GIF | -| Avatar Decoration | avatar-decoration-presets/[avatar_decoration_data_asset](/developers/resources/user#avatar-decoration-data-object).png | PNG | -| Application Icon | app-icons/[application_id](/developers/resources/application#application-object)/[icon](/developers/resources/application#application-object).png | PNG, JPEG, WebP | -| Application Cover | app-icons/[application_id](/developers/resources/application#application-object)/[cover_image](/developers/resources/application#application-object).png | PNG, JPEG, WebP | -| Application Asset | app-assets/[application_id](/developers/resources/application#application-object)/[asset_id](/developers/events/gateway-events#activity-object-activity-assets).png | PNG, JPEG, WebP | -| Achievement Icon | app-assets/[application_id](/developers/resources/application#application-object)/achievements/[achievement_id](https://github.com/discord/discord-api-docs/blob/legacy-gamesdk/docs/game_sdk/Achievements.md#user-achievement-struct)/icons/[icon_hash](https://github.com/discord/discord-api-docs/blob/legacy-gamesdk/docs/game_sdk/Achievements.md#user-achievement-struct).png | PNG, JPEG, WebP | -| Store Page Asset | app-assets/[application_id](/developers/resources/application#application-object)/store/asset_id | PNG, JPEG, WebP | -| Sticker Pack Banner | app-assets/710982414301790216/store/[sticker_pack_banner_asset_id](/developers/resources/sticker#sticker-pack-object).png | PNG, JPEG, WebP | -| Team Icon | team-icons/[team_id](/developers/topics/teams#data-models-team-object)/[team_icon](/developers/topics/teams#data-models-team-object).png | PNG, JPEG, WebP | -| Sticker | stickers/[sticker_id](/developers/resources/sticker#sticker-object).png \*\*\* \*\*\*\* | PNG, Lottie, GIF | -| Role Icon | role-icons/[role_id](/developers/topics/permissions#role-object)/[role_icon](/developers/topics/permissions#role-object).png | PNG, JPEG, WebP | -| Guild Scheduled Event Cover | guild-events/[scheduled_event_id](/developers/resources/guild-scheduled-event#guild-scheduled-event-object)/[scheduled_event_cover_image](/developers/resources/guild-scheduled-event#guild-scheduled-event-object).png | PNG, JPEG, WebP | -| Guild Member Banner | guilds/[guild_id](/developers/resources/guild#guild-object)/users/[user_id](/developers/resources/user#user-object)/banners/[member_banner](/developers/resources/guild#guild-member-object).png \* | PNG, JPEG, WebP, GIF | -| Guild Tag Badge | guild-tag-badges/[guild_id](/developers/resources/guild#guild-object)/[badge_hash](/developers/resources/user#user-object-user-primary-guild).png | PNG, JPEG, WebP | +| Type | Path | Supports | +|------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------| +| Custom Emoji | emojis/[emoji_id](/developers/resources/emoji#emoji-object).png \*\*\*\*\* | PNG, JPEG, WebP, GIF | +| Guild Icon | icons/[guild_id](/developers/resources/guild#guild-object)/[guild_icon](/developers/resources/guild#guild-object).png \* | PNG, JPEG, WebP, GIF | +| Guild Splash | splashes/[guild_id](/developers/resources/guild#guild-object)/[guild_splash](/developers/resources/guild#guild-object).png | PNG, JPEG, WebP | +| Guild Discovery Splash | discovery-splashes/[guild_id](/developers/resources/guild#guild-object)/[guild_discovery_splash](/developers/resources/guild#guild-object).png | PNG, JPEG, WebP | +| Guild Banner | banners/[guild_id](/developers/resources/guild#guild-object)/[guild_banner](/developers/resources/guild#guild-object).png \* | PNG, JPEG, WebP, GIF | +| User Banner | banners/[user_id](/developers/resources/user#user-object)/[user_banner](/developers/resources/user#user-object).png \* | PNG, JPEG, WebP, GIF | +| Default User Avatar | embed/avatars/[index](/developers/resources/user#user-object).png \*\* \*\*\* | PNG | +| User Avatar | avatars/[user_id](/developers/resources/user#user-object)/[user_avatar](/developers/resources/user#user-object).png \* | PNG, JPEG, WebP, GIF | +| Guild Member Avatar | guilds/[guild_id](/developers/resources/guild#guild-object)/users/[user_id](/developers/resources/user#user-object)/avatars/[member_avatar](/developers/resources/guild#guild-member-object).png \* | PNG, JPEG, WebP, GIF | +| Avatar Decoration | avatar-decoration-presets/[avatar_decoration_data_asset](/developers/resources/user#avatar-decoration-data-object).png | PNG | +| Application Icon | app-icons/[application_id](/developers/resources/application#application-object)/[icon](/developers/resources/application#application-object).png | PNG, JPEG, WebP | +| Application Cover | app-icons/[application_id](/developers/resources/application#application-object)/[cover_image](/developers/resources/application#application-object).png | PNG, JPEG, WebP | +| Application Asset | app-assets/[application_id](/developers/resources/application#application-object)/[asset_id](/developers/events/gateway-events#activity-object-activity-assets).png | PNG, JPEG, WebP | +| Achievement Icon | app-assets/[application_id](/developers/resources/application#application-object)/achievements/[achievement_id](https://github.com/discord/discord-api-docs/blob/legacy-gamesdk/docs/game_sdk/Achievements.md#user-achievement-struct)/icons/[icon_hash](https://github.com/discord/discord-api-docs/blob/legacy-gamesdk/docs/game_sdk/Achievements.md#user-achievement-struct).png | PNG, JPEG, WebP | +| Store Page Asset | app-assets/[application_id](/developers/resources/application#application-object)/store/asset_id | PNG, JPEG, WebP | +| Sticker Pack Banner | app-assets/710982414301790216/store/[sticker_pack_banner_asset_id](/developers/resources/sticker#sticker-pack-object).png | PNG, JPEG, WebP | +| Team Icon | team-icons/[team_id](/developers/topics/teams#data-models-team-object)/[team_icon](/developers/topics/teams#data-models-team-object).png | PNG, JPEG, WebP | +| Sticker | stickers/[sticker_id](/developers/resources/sticker#sticker-object).png \*\*\* \*\*\*\* | PNG, Lottie, GIF | +| Role Icon | role-icons/[role_id](/developers/topics/permissions#role-object)/[role_icon](/developers/topics/permissions#role-object).png | PNG, JPEG, WebP | +| Guild Scheduled Event Cover | guild-events/[scheduled_event_id](/developers/resources/guild-scheduled-event#guild-scheduled-event-object)/[scheduled_event_cover_image](/developers/resources/guild-scheduled-event#guild-scheduled-event-object).png | PNG, JPEG, WebP | +| Guild Member Banner | guilds/[guild_id](/developers/resources/guild#guild-object)/users/[user_id](/developers/resources/user#user-object)/banners/[member_banner](/developers/resources/guild#guild-member-object).png \* | PNG, JPEG, WebP, GIF | +| Guild Tag Badge | guild-tag-badges/[guild_id](/developers/resources/guild#guild-object)/[badge_hash](/developers/resources/user#user-object-user-primary-guild).png | PNG, JPEG, WebP | +| Guild New Member Action Icon | /new-member-actions/[channel_id](/developers/resources/channel#channel-object)/[action_icon](/developers/resources/guild#guild-home-settings-object-new-member-action-structure).png | PNG, JPEG, WebP | +| Guild Resource Channel Icon | /resource-channels/[channel_id](/developers/resources/channel#channel-object)/[channel_icon](/developers/resources/guild#guild-home-settings-object-resource-channel-structure).png | PNG, JPEG, WebP | \* In the case of endpoints that support GIFs, the hash will begin with `a_` if it is available in an animated format (example: `a_1269e74af4df7417b13759eae50c83dc`). These images can be retrieved as animated WebP using the `.webp` file extension and `?animated=true` querystring parameter. diff --git a/developers/resources/audit-log.mdx b/developers/resources/audit-log.mdx index 3dd34b53db..76b9246e22 100644 --- a/developers/resources/audit-log.mdx +++ b/developers/resources/audit-log.mdx @@ -151,8 +151,8 @@ You should assume that your app may run into any field for the changed object, t | ONBOARDING_PROMPT_DELETE | 165 | Guild Onboarding Question was deleted | [Onboarding Prompt Structure](/developers/resources/guild#guild-onboarding-object-onboarding-prompt-structure) | | ONBOARDING_CREATE | 166 | Guild Onboarding was created | [Guild Onboarding](/developers/resources/guild#guild-onboarding-object) | | ONBOARDING_UPDATE | 167 | Guild Onboarding was updated | [Guild Onboarding](/developers/resources/guild#guild-onboarding-object) | -| HOME_SETTINGS_CREATE | 190 | Guild Server Guide was created | | -| HOME_SETTINGS_UPDATE | 191 | Guild Server Guide was updated | | +| HOME_SETTINGS_CREATE | 190 | Guild Server Guide was created | [Guild Home Settings](/developers/resources/guild#guild-home-settings-object) | +| HOME_SETTINGS_UPDATE | 191 | Guild Server Guide was updated | [Guild Home Settings](/developers/resources/guild#guild-home-settings-object) | \* Object has exception(s) to available keys. See the [exceptions](/developers/resources/audit-log#audit-log-change-object-audit-log-change-exceptions) section below for details. diff --git a/developers/resources/guild.mdx b/developers/resources/guild.mdx index f97c43458a..25be813d2e 100644 --- a/developers/resources/guild.mdx +++ b/developers/resources/guild.mdx @@ -742,6 +742,60 @@ We are making significant changes to the Membership Screening API specifically r } ``` +### Guild Home Settings Object + +Represents the [server guide](https://support.discord.com/hc/en-us/articles/13497665141655-Server-Guide-FAQ) for a guild. + + +###### Guild Home Settings Structure + +| Field | Type | Description | +|--------------------|---------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------| +| guild_id | snowflake | the ID of the guild the home settings are for | +| enabled | boolean | whether home settings are enabled in the guild | +| welcome_message? | [welcome message](/developers/resources/guild#guild-home-settings-object-welcome-message-structure) object | the message shown to new members who join the guild | +| new_member_actions | array of [new memeber action](/developers/resources/guild#guild-home-settings-object-new-member-action-structure) objects | the actions that new members are prompted to complete | +| resource_channels | array of [resource channel](/developers/resources/guild#guild-home-settings-object-resource-channel-structure) objects | the read-only resource channels that are shown to new members | + + +###### New Member Action Structure + +| Field | Type | Description | +|-------------|-----------------------------------------------------------------------------------|-----------------------------------------------------------------------| +| title | string | the title of the action | +| channel_id | snowflake | the ID of the channel where the action should be completed | +| action_type | [action type](/developers/resources/guild#guild-home-settings-object-action-type) | the type of the action | +| description | string | the description of the action | +| emoji? | partial [emoji](/developers/resources/emoji#emoji-object) object | the emoji of the action | +| icon? | string | the [icon hash](/developers/reference#image-formatting) of the action | + + +###### Resource Channel Structure + +| Field | Type | Description | +|-------------|------------------------------------------------------------------|---------------------------------------------------------------------------------| +| title | string | the title of the resource channel | +| channel_id | snowflake | the ID of the channel the resource channel references | +| description | string | the description of the resource channel | +| emoji? | partial [emoji](/developers/resources/emoji#emoji-object) object | the emoji of the resource channel | +| icon? | string | the [icon hash](/developers/reference#image-formatting) of the resource channel | + + +###### Welcome Message Structure + +| Field | Type | Description | +|------------------------|-------------------------------------|-----------------------------------------------------------------------------| +| message | string | the message shown to new members who join the guild | +| author_ids | array of snowflakes | the IDs of the users who are credited as the authors of the welcome message | + + +###### Action Type + +| Name | Value | Description | +|-------|-------|-----------------------------------------------| +| VIEW | 0 | The member must view the channel | +| TALK | 1 | The member must send a message in the channel | + ## Get Guild /guilds/[\{guild.id\}](/developers/resources/guild#guild-object) @@ -1514,3 +1568,12 @@ Both `invites_disabled_until` and `dms_disabled_until` can be enabled for a maxi | dms_disabled_until? | ?ISO8601 timestamp \* | when direct messages will be enabled again | \* Supplying `null` disables the action. + +## Get Guild New Member Welcome +/guilds/[\{guild.id\}](/developers/resources/guild#guild-object)/new-member-welcome + + +If the new member welcome experience has been disabled, and the application does not have the `MANAGE_GUILD` permission, the endpoint will unexpectedly return a 204 empty response. + + +Returns the [Home Settings](/developers/resources/guild#guild-onboarding-object) object for the guild. \ No newline at end of file From b88e8c73d1110ecd5a4164cf0eea5c916a1b2846 Mon Sep 17 00:00:00 2001 From: Droid <174426320+Droid00000@users.noreply.github.com> Date: Wed, 13 May 2026 21:39:21 -0400 Subject: [PATCH 2/5] Add Home Header --- developers/reference.mdx | 1 + developers/resources/guild.mdx | 3 +++ 2 files changed, 4 insertions(+) diff --git a/developers/reference.mdx b/developers/reference.mdx index 709f46559e..68b3c6c392 100644 --- a/developers/reference.mdx +++ b/developers/reference.mdx @@ -379,6 +379,7 @@ Discord uses ids and hashes to render images in the client. These hashes can be | Guild Tag Badge | guild-tag-badges/[guild_id](/developers/resources/guild#guild-object)/[badge_hash](/developers/resources/user#user-object-user-primary-guild).png | PNG, JPEG, WebP | | Guild New Member Action Icon | /new-member-actions/[channel_id](/developers/resources/channel#channel-object)/[action_icon](/developers/resources/guild#guild-home-settings-object-new-member-action-structure).png | PNG, JPEG, WebP | | Guild Resource Channel Icon | /resource-channels/[channel_id](/developers/resources/channel#channel-object)/[channel_icon](/developers/resources/guild#guild-home-settings-object-resource-channel-structure).png | PNG, JPEG, WebP | +| Guild Home Header | /home-headers/[guild_id](/developers/resources/emoji#emoji-object)/[guild_home_header](/developers/resources/guild#guild-object).png | PNG, JPEG, WebP | \* In the case of endpoints that support GIFs, the hash will begin with `a_` if it is available in an animated format (example: `a_1269e74af4df7417b13759eae50c83dc`). These images can be retrieved as animated WebP using the `.webp` file extension and `?animated=true` querystring parameter. diff --git a/developers/resources/guild.mdx b/developers/resources/guild.mdx index 25be813d2e..5228443154 100644 --- a/developers/resources/guild.mdx +++ b/developers/resources/guild.mdx @@ -63,6 +63,7 @@ Fields specific to the `GUILD_CREATE` event are listed in the [Gateway Events do | premium_progress_bar_enabled | boolean | whether the guild has the boost progress bar enabled | | safety_alerts_channel_id | ?snowflake | the id of the channel where admins and moderators of Community guilds receive safety alerts from Discord | | incidents_data | ?[incidents data](/developers/resources/guild#incidents-data-object) object | the incidents data for this guild | +| home_header | ?string | the [home header hash](/developers/reference#image-formatting) for the guild's home settings banner | \* These fields are only sent when using the [GET Current User Guilds](/developers/resources/user#get-current-user-guilds) endpoint and are relative to the requested user @@ -268,6 +269,7 @@ A partial [guild](/developers/resources/guild#guild-object) object. Represents a | approximate_presence_count | integer | approximate number of online members in this guild | | description | ?string | the description for the guild | | stickers | array of [sticker](/developers/resources/sticker#sticker-object) objects | custom guild stickers | +| home_header | ?string | [home header hash](/developers/reference#image-formatting) | ###### Example Guild Preview @@ -933,6 +935,7 @@ Attempting to add or remove the `COMMUNITY` [guild feature](/developers/resource | description | ?string | the description for the guild | | premium_progress_bar_enabled | boolean | whether the guild's boost progress bar should be enabled | | safety_alerts_channel_id | ?snowflake | the id of the channel where admins and moderators of Community guilds receive safety alerts from Discord | +| home_header | ?[image data](/developers/reference#image-data) | base64 4:1 1920x480 png/jpeg image for the guild home header | ## Get Guild Channels /guilds/[\{guild.id\}](/developers/resources/guild#guild-object)/channels From 57f448e0d2c3ae6aaba0f76ef9102bae9265f9ec Mon Sep 17 00:00:00 2001 From: Droid Date: Tue, 16 Jun 2026 14:25:55 -0400 Subject: [PATCH 3/5] Apply suggestions from code review Co-authored-by: Colin Loretz --- developers/reference.mdx | 6 +++--- developers/resources/guild.mdx | 4 ++-- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/developers/reference.mdx b/developers/reference.mdx index 68b3c6c392..81b4cc1962 100644 --- a/developers/reference.mdx +++ b/developers/reference.mdx @@ -377,9 +377,9 @@ Discord uses ids and hashes to render images in the client. These hashes can be | Guild Scheduled Event Cover | guild-events/[scheduled_event_id](/developers/resources/guild-scheduled-event#guild-scheduled-event-object)/[scheduled_event_cover_image](/developers/resources/guild-scheduled-event#guild-scheduled-event-object).png | PNG, JPEG, WebP | | Guild Member Banner | guilds/[guild_id](/developers/resources/guild#guild-object)/users/[user_id](/developers/resources/user#user-object)/banners/[member_banner](/developers/resources/guild#guild-member-object).png \* | PNG, JPEG, WebP, GIF | | Guild Tag Badge | guild-tag-badges/[guild_id](/developers/resources/guild#guild-object)/[badge_hash](/developers/resources/user#user-object-user-primary-guild).png | PNG, JPEG, WebP | -| Guild New Member Action Icon | /new-member-actions/[channel_id](/developers/resources/channel#channel-object)/[action_icon](/developers/resources/guild#guild-home-settings-object-new-member-action-structure).png | PNG, JPEG, WebP | -| Guild Resource Channel Icon | /resource-channels/[channel_id](/developers/resources/channel#channel-object)/[channel_icon](/developers/resources/guild#guild-home-settings-object-resource-channel-structure).png | PNG, JPEG, WebP | -| Guild Home Header | /home-headers/[guild_id](/developers/resources/emoji#emoji-object)/[guild_home_header](/developers/resources/guild#guild-object).png | PNG, JPEG, WebP | +| Guild New Member Action Icon | new-member-actions/[channel_id](/developers/resources/channel#channel-object)/[action_icon](/developers/resources/guild#guild-home-settings-object-new-member-action-structure).png | PNG, JPEG, WebP | +| Guild Resource Channel Icon | resource-channels/[channel_id](/developers/resources/channel#channel-object)/[channel_icon](/developers/resources/guild#guild-home-settings-object-resource-channel-structure).png | PNG, JPEG, WebP | +| Guild Home Header | home-headers/[guild_id](/developers/resources/guild#guild-object)/[home_header](/developers/resources/guild#guild-object).png | PNG, JPEG, WebP | \* In the case of endpoints that support GIFs, the hash will begin with `a_` if it is available in an animated format (example: `a_1269e74af4df7417b13759eae50c83dc`). These images can be retrieved as animated WebP using the `.webp` file extension and `?animated=true` querystring parameter. diff --git a/developers/resources/guild.mdx b/developers/resources/guild.mdx index 5228443154..b4482fc879 100644 --- a/developers/resources/guild.mdx +++ b/developers/resources/guild.mdx @@ -756,7 +756,7 @@ Represents the [server guide](https://support.discord.com/hc/en-us/articles/1349 | guild_id | snowflake | the ID of the guild the home settings are for | | enabled | boolean | whether home settings are enabled in the guild | | welcome_message? | [welcome message](/developers/resources/guild#guild-home-settings-object-welcome-message-structure) object | the message shown to new members who join the guild | -| new_member_actions | array of [new memeber action](/developers/resources/guild#guild-home-settings-object-new-member-action-structure) objects | the actions that new members are prompted to complete | +| new_member_actions | array of [new member action](/developers/resources/guild#guild-home-settings-object-new-member-action-structure) objects | the actions that new members are prompted to complete | | resource_channels | array of [resource channel](/developers/resources/guild#guild-home-settings-object-resource-channel-structure) objects | the read-only resource channels that are shown to new members | @@ -1579,4 +1579,4 @@ Both `invites_disabled_until` and `dms_disabled_until` can be enabled for a maxi If the new member welcome experience has been disabled, and the application does not have the `MANAGE_GUILD` permission, the endpoint will unexpectedly return a 204 empty response. -Returns the [Home Settings](/developers/resources/guild#guild-onboarding-object) object for the guild. \ No newline at end of file +Returns the [Home Settings](/developers/resources/guild#guild-home-settings-object) object for the guild. \ No newline at end of file From 36b3af0d03e845484e50dc30d78fcdbf5a3f9fb5 Mon Sep 17 00:00:00 2001 From: Droid Date: Tue, 16 Jun 2026 14:30:09 -0400 Subject: [PATCH 4/5] fix: don't remove newline --- developers/resources/audit-log.mdx | 1 + 1 file changed, 1 insertion(+) diff --git a/developers/resources/audit-log.mdx b/developers/resources/audit-log.mdx index 5c7d650e1b..f9eb4e3835 100644 --- a/developers/resources/audit-log.mdx +++ b/developers/resources/audit-log.mdx @@ -83,6 +83,7 @@ If no object is noted, there won't be a `changes` array in the entry, though oth You should assume that your app may run into any field for the changed object, though none are guaranteed to be present. In most cases only a subset of the object's fields will be in the `changes` array. + | Event | Value | Description | Object Changed | |---------------------------------------------|-------|-----------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------| | GUILD_UPDATE | 1 | Server settings were updated | [Guild](/developers/resources/guild#guild-object) | From 09ae7bbc929537d4a712411c746ecb8fa434e5e8 Mon Sep 17 00:00:00 2001 From: Droid <174426320+Droid00000@users.noreply.github.com> Date: Tue, 16 Jun 2026 15:59:32 -0400 Subject: [PATCH 5/5] fix: tables --- developers/reference.mdx | 6 +++--- developers/resources/audit-log.mdx | 1 + developers/resources/guild.mdx | 28 ++++++++++++++-------------- 3 files changed, 18 insertions(+), 17 deletions(-) diff --git a/developers/reference.mdx b/developers/reference.mdx index 81b4cc1962..29fde9477e 100644 --- a/developers/reference.mdx +++ b/developers/reference.mdx @@ -377,9 +377,9 @@ Discord uses ids and hashes to render images in the client. These hashes can be | Guild Scheduled Event Cover | guild-events/[scheduled_event_id](/developers/resources/guild-scheduled-event#guild-scheduled-event-object)/[scheduled_event_cover_image](/developers/resources/guild-scheduled-event#guild-scheduled-event-object).png | PNG, JPEG, WebP | | Guild Member Banner | guilds/[guild_id](/developers/resources/guild#guild-object)/users/[user_id](/developers/resources/user#user-object)/banners/[member_banner](/developers/resources/guild#guild-member-object).png \* | PNG, JPEG, WebP, GIF | | Guild Tag Badge | guild-tag-badges/[guild_id](/developers/resources/guild#guild-object)/[badge_hash](/developers/resources/user#user-object-user-primary-guild).png | PNG, JPEG, WebP | -| Guild New Member Action Icon | new-member-actions/[channel_id](/developers/resources/channel#channel-object)/[action_icon](/developers/resources/guild#guild-home-settings-object-new-member-action-structure).png | PNG, JPEG, WebP | -| Guild Resource Channel Icon | resource-channels/[channel_id](/developers/resources/channel#channel-object)/[channel_icon](/developers/resources/guild#guild-home-settings-object-resource-channel-structure).png | PNG, JPEG, WebP | -| Guild Home Header | home-headers/[guild_id](/developers/resources/guild#guild-object)/[home_header](/developers/resources/guild#guild-object).png | PNG, JPEG, WebP | +| Guild New Member Action Icon | new-member-actions/[channel_id](/developers/resources/channel#channel-object)/[action_icon](/developers/resources/guild#guild-home-settings-object-new-member-action-structure).png | PNG, JPEG, WebP | +| Guild Resource Channel Icon | resource-channels/[channel_id](/developers/resources/channel#channel-object)/[channel_icon](/developers/resources/guild#guild-home-settings-object-resource-channel-structure).png | PNG, JPEG, WebP | +| Guild Home Header | home-headers/[guild_id](/developers/resources/guild#guild-object)/[home_header](/developers/resources/guild#guild-object).png | PNG, JPEG, WebP | \* In the case of endpoints that support GIFs, the hash will begin with `a_` if it is available in an animated format (example: `a_1269e74af4df7417b13759eae50c83dc`). These images can be retrieved as animated WebP using the `.webp` file extension and `?animated=true` querystring parameter. diff --git a/developers/resources/audit-log.mdx b/developers/resources/audit-log.mdx index f9eb4e3835..66bccee9ac 100644 --- a/developers/resources/audit-log.mdx +++ b/developers/resources/audit-log.mdx @@ -156,6 +156,7 @@ You should assume that your app may run into any field for the changed object, t | VOICE_CHANNEL_STATUS_CREATE | 192 | A voice channel status was set by a user | | | VOICE_CHANNEL_STATUS_DELETE | 193 | A voice channel status was deleted by a user | | + \* Object has exception(s) to available keys. See the [exceptions](/developers/resources/audit-log#audit-log-change-object-audit-log-change-exceptions) section below for details. diff --git a/developers/resources/guild.mdx b/developers/resources/guild.mdx index 7a3ad22964..dcf05347f9 100644 --- a/developers/resources/guild.mdx +++ b/developers/resources/guild.mdx @@ -751,13 +751,13 @@ Represents the [server guide](https://support.discord.com/hc/en-us/articles/1349 ###### Guild Home Settings Structure -| Field | Type | Description | -|--------------------|---------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------| -| guild_id | snowflake | the ID of the guild the home settings are for | -| enabled | boolean | whether home settings are enabled in the guild | -| welcome_message? | [welcome message](/developers/resources/guild#guild-home-settings-object-welcome-message-structure) object | the message shown to new members who join the guild | +| Field | Type | Description | +|--------------------|--------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------| +| guild_id | snowflake | the ID of the guild the home settings are for | +| enabled | boolean | whether home settings are enabled in the guild | +| welcome_message? | [welcome message](/developers/resources/guild#guild-home-settings-object-welcome-message-structure) object | the message shown to new members who join the guild | | new_member_actions | array of [new member action](/developers/resources/guild#guild-home-settings-object-new-member-action-structure) objects | the actions that new members are prompted to complete | -| resource_channels | array of [resource channel](/developers/resources/guild#guild-home-settings-object-resource-channel-structure) objects | the read-only resource channels that are shown to new members | +| resource_channels | array of [resource channel](/developers/resources/guild#guild-home-settings-object-resource-channel-structure) objects | the read-only resource channels that are shown to new members | ###### New Member Action Structure @@ -785,18 +785,18 @@ Represents the [server guide](https://support.discord.com/hc/en-us/articles/1349 ###### Welcome Message Structure -| Field | Type | Description | -|------------------------|-------------------------------------|-----------------------------------------------------------------------------| -| message | string | the message shown to new members who join the guild | -| author_ids | array of snowflakes | the IDs of the users who are credited as the authors of the welcome message | +| Field | Type | Description | +|------------|---------------------|-----------------------------------------------------------------------------| +| message | string | the message shown to new members who join the guild | +| author_ids | array of snowflakes | the IDs of the users who are credited as the authors of the welcome message | ###### Action Type -| Name | Value | Description | -|-------|-------|-----------------------------------------------| -| VIEW | 0 | The member must view the channel | -| TALK | 1 | The member must send a message in the channel | +| Name | Value | Description | +|------|-------|-----------------------------------------------| +| VIEW | 0 | The member must view the channel | +| TALK | 1 | The member must send a message in the channel | ## Get Guild /guilds/[\{guild.id\}](/developers/resources/guild#guild-object)