Welcome
App Fundamentals
Overview of AppsBuild Discord apps to customize, extend, and enhance Discord for millions of users.Discord BotsBuild bots and companion apps that connect to Discord and interact with servers, members, and events.OAuth2 & PermissionsHow OAuth2, scopes, and permissions work across the Discord platform.Interactions & CommandsBuild interactive slash commands, buttons, modals, and more using HTTP or the Gateway.Components & ModalsAdd interactive buttons, menus, layout elements, and modal dialogs to your Discord app.Server & Channel ManagementWhat Discord apps can do with servers and channels, and what permissions they need.WebhooksSend messages into Discord channels or receive event notifications from Discord delivered to your app over HTTP.
Game & Platform Features
Account LinkingConnect a player's Discord account to their in-game account to unlock richer social experiences.Social LayerAdd Discord-powered social features directly into your game using the Discord Social SDK.Rich PresenceDisplay real-time game activity on Discord user profiles with rich presence.ActivitiesBuild multiplayer games and social experiences that run directly inside Discord.Community ServersBuild and grow a player community around your game by building out a community server on Discord.
Growth & Distribution
App DiscoveryMake your Discord app discoverable through the App Directory, App Launcher, and social sharing.Game ProfilesLearn how Discord surfaces game information to users and where your game's profile appears across the platform.Claim Your GameLearn how to claim your game on Discord to unlock a verified checkmark and take control of your game's profile.Grow Your Game
Monetization
Tools & Resources
Policies and Agreements
Bots & Companion Apps
Interactions
Components
Monetization
App MonetizationLearn how to add premium features to your Discord app with subscriptions and purchases.Enabling MonetizationStep-by-step guide to meet eligibility requirements and enable monetization.Managing SKUsLearn how to create and manage SKUs that represent your app's premium offerings.Implementing App SubscriptionsLearn how to implement recurring user and guild subscriptions for premium functionality.Implementing One-Time PurchasesGuide to implementing durable and consumable one-time purchases.
Discovery
Tutorials
Configuring App Metadata for Linked RolesTutorial for setting up role connection metadata to link external app data with Discord roles.Developing A User-Installable AppTutorial for creating Discord apps that can be installed to user accounts.Hosting on Cloudflare WorkersTutorial for deploying Discord apps on Cloudflare Workers.Using Community InvitesAutomate role assignment and targeted invites using the Discord Community Invites API.You Might Not Need a Privileged IntentGuide to understanding privileged intents and their alternatives for your Discord app.Getting Started with Privileged Intent ReviewGuide to understanding the privileged intent review process and how to submit your application for review.
Discord Social SDK
Core Concepts
OverviewOverview of the Discord Social SDK's core concepts including features, communication, and platform compatibility.Core FeaturesOverview of the Discord Social SDK's core features including user identity and relationships.Communication FeaturesLearn about Discord Social SDK's communication features including direct messages and voice chat.Integration OverviewHigh-level overview of integrating the Discord Social SDK into your application.Platform CompatibilityLearn about Discord Social SDK platform support and compatibility.Release Cadence & SupportDiscord Social SDK release cadence, supported version window, and end-of-life process.OAuth2 ScopesLearn about OAuth2 scopes required for Discord Social SDK features.Mobile DevelopmentAdd the Discord Social SDK to your iOS and Android games.
Getting Started
Design Foundations
PrinciplesCore design principles for creating effective Discord Social SDK integrations.Branding GuidelinesOfficial branding guidelines for using Discord's brand assets in your integration.Designing Social SettingsDesign guidelines for implementing social settings and privacy controls.Designing for ConsolesDesign guidelines for implementing Discord Social SDK features on gaming consoles.
Provisional Accounts
OverviewImplement provisional Discord accounts for users who don't have Discord accounts yet.Bot Token EndpointCreate provisional accounts server-side from your game's own unique user IDs using your application's bot token.Identity ProvidersConfigure OIDC, Steam, EOS, and other identity providers for provisional accounts, including the full OIDC integration requirements.External Credentials ExchangeExchange an external provider token (OIDC, Steam, EOS, and more) server-side to create a provisional account.Public Client IntegrationCreate provisional accounts directly from the client when you don't have a backend server.Managing Provisional AccountsRefresh provisional account access tokens and set display names.Merging AccountsConvert a provisional account into a full Discord account, migrating the player's friends, DMs, and lobby memberships.Unmerging AccountsSever the link between a Discord account and a provisional account, and understand out-of-band and ban-driven unmerges.Designing for Provisional AccountsDesign guidelines for handling provisional Discord accounts and onboarding users.
Discord Account Linking
Account Linking from Your GameImplement account linking to connect user accounts between your application and Discord.Account Linking on MobileImplement OAuth2 authentication for iOS and Android with deep linking and PKCE.Account Linking on WebBuild the OAuth2 authorization flow to link players' Discord accounts to your game from a website or web app.Account Linking on ConsolesImplement Discord account linking on gaming consoles.Account Linking from DiscordAdopt the new account linking APIs to allow Discord to show your players entry points for account linking within the Discord clientUnlinking AccountsBest practices for unlinking a user's Discord account from your game, including when to revoke tokens and how to avoid relinking conflicts.Publisher Level Account LinkingDesigning for Account LinkingDesign guidelines for implementing Discord sign-in flows and authentication.Designing Connection PointsDesign guidelines for creating effective connection points between your application and Discord.
Friends & Relationships
Creating a Unified Friends ListBuild a unified friends list that combines Discord relationships with your application.Managing RelationshipsManage Discord user relationships including friends and blocked users in your application.Designing a Unified Friends ListDesign guidelines for creating unified friends lists that combine Discord relationships.Designing for Game FriendsDesign guidelines for displaying and managing game friends and Discord relationships.
Rich Presence & User Status
Game Invites
Direct Messages
Lobbies & Voice
Managing LobbiesCreate and manage game lobbies with Discord Social SDK for matchmaking.Linked ChannelsConnect Discord channels with your application for seamless communication.Managing Voice ChatIntegrate Discord voice chat features into your application.Designing for Chat HistoryDesign guidelines for displaying and managing chat history from Discord.Designing for Linked ChannelsDesign guidelines for integrating Discord channel functionality into your application.
Game Stats Widgets
OverviewDisplay game stats like rank, playtime, and wins on Discord user profiles using the Application Identity Profile API.Configuring Your WidgetConfigure your Game Stats Widget's layouts and fields in the Discord Developer Portal.Sending Game DataAuthorize requests and send player stats to the Application Identity Profile API.Widget Best PracticesWhen to sync profile data, manage player identity IDs, and design a widget that fits your game's style.
How To
OverviewHow-to guides for integrating Discord Social SDK features into your game.Debug & LogLearn how to enable and use debug logging in the Discord Social SDK.Use with Discord APIsCombine Discord Social SDK with Discord's REST APIs for enhanced functionality.Handle Rate LimitsDetect and handle rate limit errors in the Discord Social SDK using ClientResult.Integrate ModerationImplement moderation features and safety controls in your application.Market Your IntegrationBest practices for marketing and promoting your Discord Social SDK integration.Handle Special Characters in Display NamesProperly handle and display Discord usernames with special characters and emojis.Voice Muting Based on Player Blocks
Discord Activities
Development Guides
Guide IndexDevelopment guides for building Discord Activities with the Embedded App SDK.Local DevelopmentSet up local development environment for Discord Activities.User ActionsImplement user interactions and actions in Discord Activities.MobileDesign and optimize Discord Activities for mobile devices.LayoutDesign effective layouts and user interfaces for Discord Activities.NetworkingLearn networking patterns and best practices for Discord Activities.Multiplayer ExperienceDesign and implement engaging multiplayer experiences in Discord Activities.Growth and ReferralsImplement growth strategies and referral systems in Discord Activities.Assets and MetadataGuide to managing Activity assets, metadata, and configuration.Setting Rich PresenceProduction ReadinessPrepare your Discord Activity for production deployment.
Monetization
Best Practices
Guides
Building on Discord
Bot DevelopmentGuides for developing bots on Discord.Discord ActivitiesGuides for developing embedded games and experiences on Discord.Social SDKDevelopment guides for integrating the Discord Social SDK into your game.Platform FeaturesGuides for using Discord's features across your game, app, and server experience.
Communities & Servers
Building Games
Change Log
API Reference
API ReferenceThe Discord API is a REST API that allows you to interact with Discord data from your own applications. It's the primary way to interact with Discord from your own code.OAuth2Opcodes and Status CodesPermissionsLearn how Discord's permission system works including bitwise operations.Rate LimitsUnderstand Discord's rate limiting system including per-route and global limits.ThreadsLearn about Discord threads - temporary sub-channels for organizing conversations.
SDK Reference
HTTP API Resources
Application Identity Profile ResourceReference for Application Identity Profile objects and endpoints used to display game stats on Discord user profiles.Application Role Connection MetadataComplete reference for application role connection metadata objects.ApplicationReference for Discord application objects and management endpoints.Audit LogReference for Discord audit log objects and endpoints.Auto ModerationReference for Discord's Auto Moderation system and endpoints.ChannelEmojiReference for Discord emoji objects and management endpoints.EntitlementReference for Discord entitlement objects that represent user access to premium features.GuildGuild Scheduled EventReference for Discord scheduled event objects and management endpoints.Guild TemplateReference for Discord Guild Template objects and management endpoints.InviteLobbyReference for Discord lobby objects used for matchmaking.MessageReference for Discord message objects and management endpoints.PollReference for Discord poll objects and management endpoints.SKUReference for Discord SKU objects that represent premium app offerings.SoundboardReference for Discord soundboard objects and management endpoints.Stage InstanceReference for Discord stage instance objects for managing live audio events.StickerReference for Discord sticker objects and management endpoints.SubscriptionReference for Discord subscription objects that represent recurring payments.UserReference for Discord user objects and management endpoints.VoiceReference for Discord voice objects and connection endpoints.WebhookReference for Discord webhook objects and management endpoints.