Change Log

​

Provisional Accounts Documentation Restructure

• Overview — core concepts, the account lifecycle, and how to choose an authentication method.
• Creating accounts: Bot Token Endpoint, External Credentials Exchange, and Public Client Integration.
• Reference and lifecycle: Configuring Identity Providers, Managing Provisional Accounts, Merging Accounts, and Unmerging Accounts.

​

Resolved Channel app_permissions in Interactions

​

Deprecation: Riot Games Connections in Get Current User Connections

​

Discord Social SDK Release 1.9.17379

​

Stability

• Fixed a crash caused by re-entrant HTTP requests during connection teardown on PlayStation 5.

​

Discord Social SDK Release 1.9.17228

​

Authentication

• Fixed an issue where AUTHORIZE_REQUEST events would not re-subscribe after Discord disconnected and reconnected while the SDK was already running.

​

Noise Suppression

• Krisp noise suppression binaries and model files are now included in Unity and Unreal plugin packages for Windows, macOS, Android, and iOS.

​

Attachment Editing and is_spoiler Param

​

Documentation Fix: Subscription Status Values

​

Changes to Privileged Intent Access for Discord Apps

If your app is accessible to fewer than 10,000 users, these changes do not impact your app.

​

What’s Changing

​

1. The review threshold is now based on user count, not server count

​

2. Apps must now reapply annually for continued access

​

3. Apps can keep growing during Privileged Intent review

​

4. App Verification and Privileged Intent review are now separate

​

What This Means For Your App

​

Updated Documentation & Resources

• Updated Privileged Intents documentation to reflect the new threshold and review process.
• New Getting Started with Privileged Intents Review guide.
• New You Might Not Need a Privileged Intent guide to help you determine whether you need a privileged intent or whether an alternative approach will work for your use case.

​

Discord Social SDK Release 1.9.16441

​

Playstation 5

• Fixed crash caused by use-after-free in WebSocket callbacks

​

New Lobby HTTP API Endpoints

• Create or Join Lobby (PUT /lobbies) — create a lobby for your application or join an existing one by secret in a single call.
• Send Lobby Message (POST /lobbies/{lobby.id}/messages) — send a message into a lobby on behalf of an authenticated member.
• Get Lobby Messages (GET /lobbies/{lobby.id}/messages) — fetch up to 200 of the most recent messages from a lobby the calling user is a member of.
• Create Lobby Channel Invite for Self and for User — generate a single-use, one-hour guild invite to a lobby’s linked channel.

​

Discord Social SDK Release Cadence & Support

• Our new three-per-year minor release cadence (April, July, November)
• A new support window covering the five most recent minor versions, with hotfix patches (bug fixes and security fixes) for older supported minor releases
• How new Xbox and PlayStation OS SDK supports ship in new Social SDK releases only — each release bundles roughly the last 18 months of console OS SDKs
• The new end-of-life process for older minor releases

​

What this means for you

• Over a year and a half of support per minor release. Three minor releases of the Social SDK per year combined with a 5-version support window means every minor release you ship with gets more than 18 months of patch coverage.
• A predictable release calendar. Releases land in April, July, and November, so you can plan Social SDK upgrades and console certification windows well in advance.
• More bandwidth for new features and stability. A defined support window lets us focus engineering effort where it matters most, which means more capacity to build new features in current minor releases and keep the versions in the support window robust and reliable.

​

What changes with 1.10

• The supported version window will cover versions 1.6 through 1.10. Versions 1.5 and earlier will be end-of-life and no longer eligible for patch updates.
• New Xbox and PlayStation OS SDK support will ship in new Social SDK releases only, not as patches to older Social SDK versions. Each Social SDK release will bundle roughly the last 18 months of console OS SDK versions.

​

Account Linking Failure Modes

• Ban-Driven Unmerge documents the full lifecycle when a user’s Discord account is banned: tokens are deleted immediately, a new cross-platform-restricted provisional account is created carrying the original external identity, and merge attempts return error 530017 until the ban lifts (or, for permanent bans, indefinitely).
• Out-of-Band Revocation describes the auth-side observable signals (APPLICATION_DEAUTHORIZED webhook + invalid_grant on refresh) when a user removes your app from Discord or has their account banned.
• When Refresh Fails documents the /oauth2/token response when the underlying token has been deleted, and recommends treating invalid_grant as equivalent to receiving the webhook.

​

Discord Social SDK Release 1.9.15780

​

Xbox

• Added Xbox GDK 260400 support

​

Noise Suppression

• Integrated Krisp noise suppression across Android, iOS, macOS, and Windows

​

New flags_new Field on Application Object

​

User Premium Type Field Now Requires A Scope

​

Voice Muting Based on Player Blocks

​

Discord Social SDK Release 1.9.15332

​

Playstation 5

• Added OS 13.000 support

​

Activity Invites

• Accepting an activity invite over RPC now uses the application_id from the invite when provided, fixing cases where invites from sibling applications were sometimes attributed to the wrong app. This only affects teams leveraging Publisher Level Account Linking for having a single auth flow across all the games in their portfolio.

​

Proximity Voice Chat Guide for Game Developers

​

Security Updates for Provisional Account OIDC Integrations

​

Voice Channel Status and Start Time Documentation

​

Permission

​

Gateway Events

• Voice Channel Status Update — fired when a channel’s status changes.
• Voice Channel Start Time Update — fired when a voice session’s start time changes.

​

Audit Log

​

Deprecation: OAuth2 Refresh Token Grant for OIDC Provisional Accounts

​

Message Forwarding Requires Message Content Access

​

Discord Social SDK Release 1.8.14985

​

Xbox

• Added Xbox GDK 251002 support

​

RPC over IPC Documentation

• IPC socket paths for Windows and Linux/macOS
• Handshake flow and opcodes
• IPC-specific events (READY, ERROR, and GUILD_STATUS)

​

Discord Social SDK Release 1.8.14856

​

iOS Unity & Unreal

• Unity and Unreal packages now include Debug plugins, which have support for logging at the Info and Verbose severity levels

​

Party Privacy

• Fixed bug in which changes to party privacy settings didn’t propagate when calling Client::UpdateRichPresence, meaning switching a party from private to public wouldn’t update the join button in Discord

​

Search Guild Messages

​

Discord Social SDK Release 1.8.14587

​

Debug Support

• Added Debug library support for the following:
  • Unity plugin & sample
  • Unreal plugin & sample
  • Windows, Mac, Linux libraries
  • Android library
  • PS5 11.000 & 12.000 library
  • PS4 12.000 & 12.500 library
  • Scarlett & Xbox One 250400 GDK library

​

Developer Portal & Docs Refresh

​

Developer Portal

• New dev portal home page with quick access to apps, docs, and new developer videos.
• New theme with updated navigation and updated light/dark support.
• New Localization support! This will use the same language you have set in the Discord client.

​

Developer Docs

• Reorganized structure with new tabs for each feature area and new sidebars for easier navigation.
• New guides and overviews for platform-wide features and use cases, with more on the way!
• AI & MCP support: Docs now work with AI development tools via Copy-as-Markdown, an LLMs.txt file, and an MCP server, available at https://docs.discord.com/mcp
• Existing docs URLs are stable and were preserved during the reorganization. Some titles and content were updated or moved for clarity.

​

What’s Next

​

Discord Social SDK Release 1.8.14437

​

Security

• Filter the bearer token in all levels of logging
• Release builds only emit log statements for Error or Warning levels of severity
• Debug builds will still have logs for Info and Verbose levels of severity
• Added a DEBUG BUILD Warning at the top of the debug log that indicates it should not be used in production

​

Discord Social SDK Release 1.7.14433

​

Security

• Filter the bearer token in all levels of logging
• Release builds only emit log statements for Error or Warning levels of severity
• Debug builds will still have logs for Info and Verbose levels of severity
• Added a DEBUG BUILD Warning at the top of the debug log that indicates it should not be used in production

​

Discord Social SDK Release 1.6.14448

​

Security

• Filter the bearer token in all levels of logging
• Release builds only emit log statements for Error or Warning levels of severity
• Debug builds will still have logs for Info and Verbose levels of severity
• Added a DEBUG BUILD Warning at the top of the debug log that indicates it should not be used in production

​

Updates to Context Menu Commands

​

Refreshed UI

• Commands are now organized by their application, providing hierarchy
• Frequently used commands are now hoisted to the top for easy access
• A new search bar lets you quickly find the exact command you’re looking for

​

A Higher Limit

​

Developer Resources

​

Server-Side Message Moderation

​

Discord Social SDK Release 1.8.14026

​

Stabilization

• Fixed an occasional crash when linking your Discord account to your Application while in a Voice Call

​

Publisher Level Account Linking

• Setting up parent-child application hierarchies between publisher and game applications
• Exchanging parent access tokens for child access tokens
• Integrating child tokens with the Discord Social SDK
• Understanding token lifecycles and revocation

​

Discord Social SDK Release 1.8.13870

​

Playstation 5

• Added OS 12.000 support

​

iOS

• Added code stripping to iOS builds to reduce size

​

Community Invite Guide

​

Radio Groups, Checkbox Groups, and Checkboxes in Modals

​

The New Components

• Radio Group: A single-selection component for choosing exactly one option from a list. Supports the required field to allow optional selections.
• Checkbox Group: A multi-selection component with configurable min_values and max_values constraints for flexible selection requirements.
• Checkbox: A simple boolean toggle for yes/no style questions.

​

Developer Resources

• Using Modal Components - Learn how to create modals
• Component Reference - Complete documentation for all available components

​

Next Generation Docs Project

​

Our Goal

• Discord Apps and Bots - The foundation of our ecosystem, extending Discord’s functionality with custom apps, commands, and integrations
• Discord Activities - Real-time games and social experiences that users can launch directly inside Discord
• Social SDK for Games - Bringing Discord-powered features like voice, chat, rich presence, and social graph to games

​

Our Next Gen Docs Journey

• Migrated to Mintlify for a modern documentation experience
• For this migration, we preserved our existing content and familiar design but plan to evolve this over time
• We no longer have to maintain and build our own documentation platform and can instead focus on making content and improving our developer experience
• Gained new capabilities:
  • PR Previews - See documentation changes before they go live! This works locally as well as in your pull requests
  • More Components and Docs Features - We now have access to all of Mintlify’s documentation components that will continue to grow over time
  • AI features & improved search - You can now send our docs to your LLM of choice or access them via MCP (more on this soon!)

​

Why This Matters

• Reduces time-to-first-success for new developers
• Scales with complexity as your projects grow
• Stays current with our rapidly evolving platform
• Serves all skill levels from beginners to experts

​

Contributing to Our Vision

• Feedback on what’s working and what isn’t
• Content contributions through our existing PR process
• Bug reports when documentation doesn’t match reality

​

Community Invites Update

• Get Target Users returns a standardized CSV file with a header user_id and each user ID on its own line. If you relied on the header you submitted or weren’t reading it from the file you got back you’ll need to update to expect only user_id as the header in the csv now.
• Get Channel Invites returns a partial for roles instead of the full role object. This is a breaking change as it used to return the full role object and now only contains id, name, position, color, colors, icon, and unicode_emoji.

​

Relationships.read scope

​

New Invite Endpoints

• target_users_file: A CSV file with user IDs to specify who can accept the invite
• role_ids: Role IDs for roles to assign to users when they accept the invite

• Get Target Users: Gets the users allowed to see and accept an invite
• Update Target Users: Updates the users allowed to see and accept an invite
• Get Target Users Job Status: Checks the status of the job that processes the target users for an invite from file upload

​

Discord Social SDK Release 1.8.13395

​

Moderation Metadata Support

• [Coming Soon] Messages will soon support MessageHandle::ModerationMetadata, a set of custom string key-value pairs that can be used to communicate moderation-related information between your game backend and client.
  • This SDK version includes the functionality to support this upcoming feature, but it will only become available after an upcoming Discord API change.

​

WebSocket Reporting

• WebSocket connection failures will now report an HTTP status code to the SDK log.

​

PlayStation 5

• Improved accuracy of timing metrics used for monitoring the health of connections and voice calls.

​

Discord Social SDK Release 1.7.13357

• Fixed a crash on Steam Deck when calling RegisterLaunchCommand
• Fixed a crash on iOS when Deeplink Authentication fails.

​

New Social SDK Guide: Account Linking from Discord

• Connected Game Flow (recommended): Uses new callback methods to launch account linking directly in your game when players click Discord’s entry points
• Web Flow: Routes players through a web-based OAuth flow (currently only available for select partners)

​

Discord Social SDK Release 1.6.13305

• Fixed a crash on Steam Deck when calling RegisterLaunchCommand
• Fixed a crash on iOS when Deeplink Authentication fails.

​

Get Guild Role Member Counts Endpoint

​

Discord Social SDK Release 1.7.13152

​

macOS

• Added support for macOS 10.15 to the build. The minimum versions are now 10.15 for Intel Macs and 11.0 for Apple Silicon Macs.

​

Permission Changes Going into Effect February 2026 for PIN_MESSAGES, BYPASS_SLOWMODE, CREATE_GUILD_EXPRESSIONS, and CREATE_EVENTS

​

What’s Changing?

• The PIN_MESSAGES permission (1 << 51) was split from MANAGE_MESSAGES on August 20, 2025.
• Read the change log.
• Starting February 23, 2026, users and bots will need the PIN_MESSAGES permission to pin messages. MANAGE_MESSAGES alone will no longer be sufficient.

• The BYPASS_SLOWMODE permission (1 << 52) is being split from MANAGE_MESSAGES, MANAGE_CHANNEL, and MANAGE_THREADS.
• Read the change log.
• Note: This primarily affects users, as bots are not affected by slowmode restrictions.
• Starting on February 23, 2026, users will need the BYPASS_SLOWMODE permission to not be affected by slowmode restrictions.

• The CREATE_GUILD_EXPRESSIONS permission (1 << 43) was created in July 2023 and split from MANAGE_GUILD_EXPRESSIONS for users in December 2023. Read the change log.
• As of today, bots now have access to the CREATE_GUILD_EXPRESSIONS permission.
• Read the change log.
• Starting on February 23, 2026, bots will need the CREATE_GUILD_EXPRESSIONS permission to create custom emoji and stickers. MANAGE_GUILD_EXPRESSIONS alone will no longer be sufficient.

• The CREATE_EVENTS permission (1 << 44) was created in July 2023 and split from MANAGE_EVENTS for users in December 2023. Read the change log.
• As of today, bots now have access to the CREATE_EVENTS permission.
• Read the change log.
• Starting on February 23, 2026, bots will need the CREATE_EVENTS permission to create scheduled events. MANAGE_EVENTS alone will no longer be sufficient.

​

What Do You Need to Do?

• Pins messages: Request the Pin Messages permission
• Creates custom emoji or stickers: Request the Create Expressions permission
• Creates scheduled events: Request the Create Events permission

​

New BYPASS_SLOWMODE Permission & Permission Split

• The BYPASS_SLOWMODE permission (1 << 52) is being split from MANAGE_MESSAGES, MANAGE_CHANNEL, and MANAGE_THREADS.
• Note: This primarily affects users, as bots are not affected by slowmode restrictions.
• Starting on February 23, 2026, users will need the BYPASS_SLOWMODE permission to not be affected by slowmode restrictions.

​

Guild Expressions and Events Permissions now available to developers

• The CREATE_GUILD_EXPRESSIONS permission (1 << 43) was created in July 2023 and split from MANAGE_GUILD_EXPRESSIONS for users in December 2023.
• As of today, bots now have access to the CREATE_GUILD_EXPRESSIONS permission.
• Starting on February 23, 2026, bots will need the CREATE_GUILD_EXPRESSIONS permission to create custom emoji and stickers. MANAGE_GUILD_EXPRESSIONS alone will no longer be sufficient.

• The CREATE_EVENTS permission (1 << 44) was created in July 2023 and split from MANAGE_EVENTS for users in December 2023.
• As of today, bots now have access to the CREATE_EVENTS permission.
• Starting on February 23, 2026, bots will need the CREATE_EVENTS permission to create scheduled events. MANAGE_EVENTS alone will no longer be sufficient.

​

Discord Social SDK Release 1.7.13024

​

Windows

• Fixed default audio device selection to once again prefer the default system audio device instead of the default communications device.

​

Xbox

• Added support for GDK 240605 to the build.

​

Discord Social SDK Release 1.7

​

Authentication

• Sign in with Apple and PlayStation Network are now supported as external identity providers.

​

Linked Channels

• The results of Client::GetGuildChannels are now sorted in the order in which they appear in the Discord client. Additional properties added to GuildChannel for type, position and parent category ID.

​

PlayStation 5

• Added Low Energy Mode support. Explicit control of SDK thread affinity is provided by cpuAffinityMask property of ClientCreateOptions.
• Fixed a crash when destroying and recreating Client.

​

Windows

• Fixed an issue which caused local crash dumps to be disabled in processes which load the Social SDK.

​

Voice

• The Social SDK now uses our latest audio subsystem on Windows, bringing it more in line with the desktop client. Improves device compatibility and fixes some long-standing issues like Bluetooth devices changing profiles on startup.
• Desktop clients now use WebRTC m130 internally (upgraded from m116).
• Bug fixes and improvements to DAVE E2EE protocol implementation.

​

Discord Social SDK Release 1.6.12767

​

Discord Social SDK Release 1.5.12211

​

Bug Fix

• Fixed a crash when calling Client::GetUserGuilds on iOS devices. First occurrence of this crash introduced in 1.5.10839

​

Discord Social SDK Release 1.6.12170

​

New Features

• You can now provide custom art to display as a banner image in game invites that appear in Discord. This is done one of two ways:
  • By specifying a URL or an asset key to an image in the activity.assets.inviteCoverImage parameter when calling Client::UpdateRichPresence. This method even affords you the ability to set a unique image on each invite if you want!
  • By uploading cover image art in the Rich Presence tab in the Developer Portal for your Application. Note: This will be used as the fallback image if you don’t specify one via activity.assets.inviteCoverImage
• It’s now possible to customize the displayed name for your Application in Discord’s Rich Presence. To do so, set the activity.name parameter when calling Client::UpdateRichPresence
• Added support for Microsoft Xbox GDK version 2025.04
• Fixed a crash when calling Client::GetUserGuilds on iOS devices

​

Introducing the File Upload component in Modals

​

The New Component:

• File Upload

​

Developer Resources

• Using Modal Components - Dive into creating a modal
• Check out our Component Reference for details on all available components.

​

Discord Social SDK Release 1.6

​

✨ New Features

• When calling Client::GetGuildChannels, channels are now sorted by their position field, which matches how they are sorted in the Discord client.
• Messages received via the Social SDK, no longer create notifications in a Discord client for the same user, to avoid double notification on the same machine.

• Game Profile Integration: New functionality to display game data on Discord user profiles. This includes UserApplicationProfile support with two new methods: Client::GetUserApplicationProfiles and Client::GetUserApplicationProfilesNoLock on the Users class, which retrieve game identity data from external authentication providers.
• In-Discord Authentication Flow: Support for users to start account linking directly from Discord (rather than having to initiate it from within your game). Added Client::RegisterAuthorizeRequestCallback and Client::RemoveAuthorizeRequestCallback methods to handle authentication requests that originate from various Discord entry points. These functions support upcoming Discord client experiments that will be gradually rolled out to users over time.

​

⚠️ Deprecations

• Deprecated Client::GetCurrentUser API in favor of Client::GetCurrentUserV2 which returns optional values instead of potentially invalid handles.

​

🚀 Performance Improvements

• This update implements caching capabilities for the Client::GetUserMessagesWithLimit function to avoid unnecessary remote API calls when sufficient messages are already cached locally.

​

🎤 Voice Communications Fixes and Improvements

• Fixed an issue where voice calls would sometimes transition to Disconnected state instead of reconnecting properly after a network interruption.
• Extended AGC2 (Automatic Gain Control 2) support to mobile platforms

​

🐛 General Stability and Bug Fixes

• Fixed critical bug where activity party privacy wasn’t properly set, causing “ask to join” to appear instead of “join” for public parties.
• Fixed critical memory safety issue preventing connection objects from being deallocated during timer callbacks.
• Fixed C# marshaling alignment bugs and double-free crashes.
• Improved gateway resilience with fallback to generic URLs on zonal gateway failures.
• Fixed WebSocket write-after-close errors preventing connection issues.

​

Adding More Modal Components!

​

Components Now Supported in Modals:

• User Select
• Role Select
• Mentionable Select
• Channel Select
• Text Display

​

Getting Started

• Using Modal Components - Dive into creating a modal

​

Developer Resources

​

Banner, avatar, and bio can be set on modify current member

​

Deprecating Non-E2EE Voice Calls

​

Developer Impact

​

Implementing E2EE Voice

​

Discord Social SDK Release 1.5.11353

​

Unity Plugin

• Fixed a crash primarily affecting low-end Android devices (those with armv7 architecture) in Client::CreateOrJoinLobbyWithMetadata
• Fixed a crash when passing large amounts of metadata in Client::CreateOrJoinLobbyWithMetadata

​

Introducing New Modal Components!

​

What’s New

• String Selects now work in modals when placed inside a Label component
• Text Inputs can also be used inside a Label component
• When a Text Input is used in a Label component the label field on the Text Input is not allowed in favor of label on the Label component
• ActionRow + TextInput is now deprecated in favor of the new Label component for better accessibility
• The required field is now available on String Selects (defaults to true in modals, ignored in messages)
• The disabled field on String Selects is not currently allowed in modals, and will trigger an error if used

​

New Layout Component

• Label - A new top-level component that lets you add a title and description to your modal components!

​

Updates to Modal Components

• Text Input - Text Input can now be used in a Label
• String Select - String Selects can be used in modals! Place them in a Label

​

Getting Started

• Using Modal Components - Dive into creating a modal

​

Developer Resources

​

Pin Permission Split

​

Discord Social SDK Release 1.5

​

DM History Support

• Added Client::GetUserMessageSummaries and Client::GetUserMessagesWithLimit to retrieve direct message history

​

Rich Presence

• Added support for additional activity types (Listening, Watching, Competing)
• Added support for new clickable URL fields and additional user status customization
• Support for server-to-server rich presence invites and gateway-based invite handling. This means an invite can be accepted on a different device and the Client::SetActivityInviteCreatedCallback will be invoked on connected SDK sessions.

​

Linked Channels

• Added Client::JoinLinkedLobbyGuild to allow members of linked lobbies to join the linked lobby’s guild from in-game

​

Android

• Implemented native authentication support
• Fixed native authentication callback when activities are terminated
• Added an experimental audio setting on Android to avoid setting the OS to voice comms mode when connected to a Bluetooth headset on Android. This may be used if you wish to avoid the transition to voice volume controls and other related changes when connected to Bluetooth. To enable this setting, pass a ClientCreateOptions when instantiating the client and set the experimentalAndroidPreventCommsForBluetooth flag

​

iOS

• Added native authentication support
• The experimental Game audio subsystem now makes use of the iOS 18.2+ echo canceller when available and falls back to Standard mode otherwise.

​

Windows

• Added ARM64 support

​

Linux

• Ensured glibc 2.31 compatibility

​

Bug Fixes

• Fixed bug where Client::SetVoiceLogDir didn’t have any effect
• Added better error event handling to distinguish server authorization errors from user cancellations
• Fixed activity platform validation for console games
• Fixed crash safety issues with Client::GetCurrentUser when the client is in an unexpected non-Ready state. Added Client::GetCurrentUserV2 which explicitly returns an optional handle instead of dummy data in this situation. This issue also affected the Unity and Unreal versions of the SDK
• Fixed Call::SetPTTActive

​

Known Issues

• When the network is disconnected temporarily, active Calls may sometimes enter the Disconnected state instead of reconnecting. If a Call reaches Disconnected state, you must end and rejoin the call to reconnect if desired.
• For DM chat history
  • No SDK-side caching for Client::GetUserMessagesWithLimit
    • Every invocation of Client::GetUserMessagesWithLimit will directly query the backend rather than using local SDK-side caching. This may have performance implications, particularly under high-frequency usage.
  • Provisional account merge message retrieval
    • After a provisional account is merged into a full account, messages sent while the user was on the provisional account cannot be retrieved.

​

Introducing Rate Limit When Requesting All Guild Members

​

What’s changing?

• Rate Limit: 1 request per guild per bot every 30 seconds
• Scope: The limit applies per guild per bot (one bot can request members for different guilds within the 30-second window)
• Behavior: Requests that exceed this limit will receive a RATE_LIMITED event as a response:

{
  "op": 0
  "t": "RATE_LIMITED",
  "d": {
    "opcode": 8,
    "retry_after": ...,
    "meta": {
      "guild_id": ...,
      "nonce": ...
    }
  }
}

​

Impact on Applications

​

Timeline

​

What you need to do

• Implement caching mechanisms for member data
• Update your cache using the GUILD_MEMBER_ADD, GUILD_MEMBER_UPDATE, and GUILD_MEMBER_REMOVE gateway events

​

Discord Social SDK Communication Features - General Availability

• Direct Messages: One-on-one private chat functionality
• Discord voice chat: Real-time voice communication inside game lobbies
• Lobbies & In-Game text chat: Virtual spaces where players can interact through voice and text chat
• Linked Channels: Integration with Discord’s server-based text channels directly in your game UI

​

New Application Process for Full Access

​

Get Started with the Social SDK

​

Embedded App SDK Version 2.1 & 2.2

​

Changes in version 2.1

​

New URL fields

• state_url - URL that is linked to when clicking on the state text in the activity card
• details_url - URL that is linked to when clicking on the details text in the activity card
• assets.large_url - URL that is linked to when clicking on the large image in the activity card
• assets.small_url - URL that is linked to when clicking on the small image in the activity card

​

Changes in version 2.2

​

patchUrlMappings

​

Remove .proxy/ from Discord Activity proxy path

​

Before

https://<application_id>.discordsays.com/.proxy/api/endpoint

​

After

https://<application_id>.discordsays.com/api/endpoint

​

Technical Details

• CSP Update: The Content Security Policy now allows requests to https://<app_id>.discordsays.com/* instead of the more restrictive https://<app_id>.discordsays.com/.proxy/*
• Proxy Behavior: Both URL patterns work identically - your existing proxy mappings (e.g., /api -> example.com) will function the same way regardless of whether you use /.proxy/api or /api
• Performance: No performance differences between the two approaches

​

Developer Tooling Updates

​

Backward Compatibility

• Continue using existing /.proxy/ URLs
• Switch to the new, simplified URLs
• Use both patterns simultaneously in the same application

​

Guild Create Deprecation

​

Clickable Links and Customizable Statuses in Rich Presence

• You can now add clickable links to the state text, details text, large image & small image
• You can now choose which field (name, state, or details) is used in users’ status text in the member list (e.g. instead of “Listening to MyMusic” you can now have your status text show “Listening to Rick Astley”)

​

Gradient Roles and Guild Tags

​

Gradient Role Colors

• The guild feature ENHANCED_ROLE_COLORS will let you know if a guild is able to set gradient colors to roles.
• Guild roles now have colors as part of the structure.
• color on guild roles is deprecated but will still be returned by the API and continues to work for backwards compatibility.
• Role color structure

​

Guild Tags

• Guild tags can be retrieved through the primary_guild field on the user object.
• User Primary Guild

​

Discord Social SDK Release 1.4

​

Lobby Chat History

• Added Client::GetLobbyMessagesWithLimit to retrieve lobby message histories based on a provided lobby ID, with a maximum of 200 messages and up to 72 hours.
• Only messages from lobbies the user is currently a member of can be retrieved.
• DM history will be coming soon too!

​

Unified Friends List

• Added Client::GetRelationshipsByGroup which both logically groups a user’s relationships for the purpose of rendering a friends list and sorts users based on our Unified Friends List design guidelines. Before, it was necessary to call Client::GetRelationships and manually partition each relationship into the appropriate friend group, as well as write your own sorting operations.
• Added Client::SetRelationshipGroupsUpdatedCallback which fires whenever a user change occurs which could invalidate a previously sorted friends list retrieved from Client::GetRelationshipsByGroup. Call Client::GetRelationshipsByGroup again to maintain an up-to-date friends list.
• Added IsSpamRequest to RelationshipHandle, returns true if Discord believes the request to be spam.

​

Audio Changes

• A new experimental audio mode has been added for mobile devices which uses standard media audio streams instead of voice-specific processing. On iOS this causes the voice engine to use the Remote I/O Audio Unit instead of Voice Processing I/O and likewise on Android, media stream types are used instead of voice communication types. This mode may be enabled by creating a Client with a ClientCreateOptions parameter whose experimentalAudioSystem property is set to AudioSystem::Game. In this case, you should also set Client::SetEngineManagedAudioSession to true. We do not recommend using this for production - however, if you are interested in trying it out, we are looking for feedback!
• Added Client::SetAecDump to enable recording of audio diagnostic information.

​

Auth

• Publisher Auth
  • Publisher Auth is a new feature which makes authorization easier for publishers with multiple games. This is an early release of this feature and only available to a limited number of partners for now.
  • Added Client::ExchangeChildToken to facilitate child token exchange for public clients. Confidential clients will require a server to server implementation, but this method may be useful for development.
  • Invites from sibling applications will be visible to the SDK. They can be identified by the applicationId field on the ActivityInvite payload.
  • Messages sent from other sibling applications will be visible to the SDK. They can be identified by the ApplicationId method on the MessageHandle.
• Added Client::RevokeToken and Client::UnmergeIntoProvisionalAccount to allow games leveraging Public Clients to perform token revocation or unmerge operations directly from clients.

​

Android

• The SDK is now compatible with 16KB page size.

​

Misc

• Improved activity serialization, avoiding including null/empty keys in the JSON payload.

​

Paginated Pin Endpoints

​

New Endpoints

​

Deprecated Endpoints

​

Discord Social SDK Release 1.3

​

Authentication

• Added an APPLICATION_DEAUTHORIZED webhook event which can be configured in the developer portal. When a user unlinks their account or revokes authorization for your application in any way, this event will be sent to configured webhooks. The payload will contain serialized user information. See Webhook Events docs for more information on configuring webhook events.

​

PC

• Added configurable request timeout SDK HTTP client requests. Support is on PC in this release with console and mobile support coming in future release. Timeout default value is 30000ms (30 seconds) and can be configured using the new Client API: Client::SetHttpRequestTimeout
• Fixed a crash that can occur when handling certain failed HTTP requests

​

Mobile

• Client::SetSpeakerMode is now deprecated. Unless Client::SetEngineManagedAudioSession is used, audio routing will be handled automatically by the SDK

​

Android

• Fixed routing of game and voice audio when external audio devices are connected and/or disconnected. Client::SetEngineManagedAudioSession has been added to communicate that the SDK should not manage audio routing and automatically enter and leave MODE_IN_COMMUNICATION when joining and leaving calls.
• Fixed an issue with the Authorize method when a device configuration change needs to restart the activity

​

iOS

• Various fixes for audio routing and session management. When using the Unity plugin, game audio will no longer stop playing when ending a call. For standalone SDK use, a method Client::SetEngineManagedAudioSession has been added to communicate that the SDK should not automatically start and stop the AVAudioSession when joining and leaving calls.
• Corrected supported platform values in Info.plist for iOS .frameworks.

​

Consoles

• Standalone archives now only contain console-specific files, like the Unity and Unreal Engine archives

​

Misc

• Fixed a thread safety issue with Client::AddLogCallback
• Added [Flags] declaration for bit flags enums in C#

​

Discord Social SDK Release 1.2

​

Rich Presence

• Added support for adding custom buttons on activity cards via Activity::AddButton

​

Packaging

• Unity and Unreal plugin artifacts now contain just the additional files for console support so they can be extracted on top of the base plugin
• Unity plugin is now packaged as a .zip that you should extract inside the Packages directory of your project to enable the above
• Console archives now contain a small README with some console-specific documentation

​

Misc

• Added Client::OpenConnectedGamesSettingsInDiscord for deeplinking into Discord’s settings for connected games, which provides players some control over who can DM them
• Fixed a hang that could occur on Linux in Client::RegisterLaunchCommand and Client::RegisterLaunchSteamApplication
• Client::RegisterLaunchCommand and Client::RegisterLaunchSteamApplication now work from inside the Steam Runtime on Linux
• Fixed a crash on exit that could occur when there were pending callbacks in the queue

​

Raised Component Limits

​

What’s New

• Total components: The limit for total components in a message has been increased to 40.
• Top-level components: There is no longer a limit on top level components in a message (previously it was 10).
• Container Component: There is no longer a limit on the number of components in a Container Component (previously it was 10).

​

Developer Resources

• Check out our Component Reference for detailed specifications on all available components.
• Learn how to build rich message layouts with components with Using Message Components.

​

Introducing New Components for Messages!

​

Why We Built Components V2

• Content, attachments, embeds, and components had to follow fixed vertical positioning rules
• Visual styling options were limited
• It was difficult to make visually cohesive experiences that combined the various functionalities of messages given they were expressed in a non-unified system

​

What’s New

​

New Layout Components

• Section - Combine text with an accessory component for contextually linked elements
• Container - Create visually distinct groupings with a customizable accent color
• Separator - Add visual spacing and dividers between components

​

New Content Components

• Text Display - Add rich markdown-formatted text anywhere in your messages
• Thumbnail - An image used in a section
• Media Gallery - Present collections of images and videos in an organized grid
• File - Embed file attachments as part of your message layout

​

Getting Started

• Using Message Components - Learn how to build rich message layouts with components
• Using Modal Components - Create interactive forms and dialogs

​

Compatibility Notes

• The content and embeds fields will no longer work but you’ll be able to use Text Display and Container as replacements
• Attachments need to be exposed through components to be visible. You can use a Media Gallery, Thumbnail, or File component to display them
• The poll and stickers fields are disabled
• A max of 10 top-level components and 30 total components in a message

​

Developer Resources

​

Discord Social SDK Release 1.1.8318

​

Platforms

• Playstation standalone archives now include linker stubs

​

Voice

• Fixed a regression in audio playback on Linux

​

Discord Social SDK Release 1.1

​

Platforms

• Added Xbox One and PS4 console support

​

Auth

• Added support for Unity Services as an external auth provider

​

Voice

• Client::StartCallWithAudioCallbacks now permits sample data to be modified during record and playback for custom effects processing
• Fixed a bug where the speaking state for a user could be stuck in the “on” state
• Added Call::GetPTTReleaseDelay
• Initialization of the voice engine is now delayed until it’s needed
• Fixed a deadlock with the Linux PulseAudio backend where malfunctioning audio devices could cause a voice engine lockup

​

Rich Presence

• Added support for sending rich presence updates and invites without connecting to the Discord gateway on desktop

​

Misc

• Added Linux support for Client::RegisterLaunchCommand and Client::RegisterLaunchSteamApplication
• Fixed a crash when a Unity Editor scripting domain reload (e.g. entering/exiting play mode) happens while an async completion callback is pending
• Fixed Client::RemoveDiscordAndGameFriend only working if you’re Discord friends
• Reduced some log spam from desktop client RPC message handling

​

Deprecating Guild Creation by Apps

​

Breaking Change

​

What’s Changing

• The Create Guild endpoint (POST /guilds) will be restricted for applications starting July 15, 2025
• Existing Guilds owned by bots will have their ownership transferred to a real user
• After the deprecation date, the endpoint will no longer be available

​

Timeline

• April 15, 2025: Deprecation announcement
• June 15, 2025: System DM/Email notifications sent to affected app owners and designated guild members
• July 15, 2025: Create Guild endpoint will no longer be available

​

Custom Incentivized Links

​

Custom Incentivized Links for Activities

• shareLink will now let you attach custom params to links you share about your game using custom_id.
• Removed referrer_id from shareLink API. Any uses of referrer_id should be moved over to use custom_id instead. Passing referrer_id to shareLink will silently fail.

​

Per-Attachment File Upload Behavior for Apps

• File size limits now apply to each individual attachment
• Previously, limits were applied to the combined size of all attachments in a message
• This aligns app attachment handling with user attachment behavior

​

Introducing the Discord Social SDK

• Account Linking
• Provisional Accounts
• Rich Presence
• Deeplink Game Invites

• Cross-Platform Messaging
• Linked Channels
• Voice Chat

​

Discord Social SDK Developer Resources

• Getting Started Guides for C++, Unity and Unreal Engine.
• Development Guides for building your game’s social features.
• Design Guidelines for designing your game’s social features.
• SDK Reference is now available.
• The Discord Social SDK binaries are available for download in the Developer Portal after enabling the Discord Social SDK for your application.

​

Default File Upload Limit Change

• This change will take effect on January 16, 2025.
• The 10 MiB limit will apply to both webhooks and interaction responses.

​

Premium Apps: Multiple Subscription Tiers

​

What’s Changed

​

Developer Portal

• Under the Monetization tab, you can now publish multiple subscription SKUs of the same type for your app.

​

App’s Store Page

• When multiple subscription SKUs are published: Users can now upgrade or downgrade between different published subscription SKUs.

​

User App Subscription Settings

• When multiple subscription SKUs are published: Users can now upgrade or downgrade between different published subscription SKUs.
• These settings are available under User Settings → Subscriptions → App Subscriptions.

​

Subscription Object

• New field renewal_sku_ids added to the subscription object response for SUBSCRIPTION_UPDATE events and API endpoints.
• renewal_sku_ids is a list of snowflakes that indicate the SKU(s) that the user will be subscribed to at renewal.

​

Updated Guide: Managing SKUs

• The Managing SKUs guide has been updated to include information about creating and managing multiple subscription SKUs.

​

Updated Guide: Implementing App Subscriptions

• The Implementing App Subscriptions guide has been updated to include information about supporting upgrades and downgrades between multiple subscription SKUs.

​

Entitlement Migration Completed

​

What’s Changed

• The documentation has been updated to reflect the new entitlement system as the standard behavior.
• ENTITLEMENT_UPDATE event for subscription-related entitlements now only occur when the subscription ends.
• The ends_at value on the entitlement object is now set when the subscription ends.
• To determine when a subscription was canceled, listen for SUBSCRIPTION_UPDATE events or use the Subscription API to retrieve the subscription’s status and canceled_at timestamp.

​

Webhook Events