Documentation - Discord
Available Resources
Docs
Building Your First Activity in Discord: Step-by-step tutorial for creating your first Discord Activity.
Activity Design Patterns: Best practices and design principles for creating engaging Discord Activities.
Activity Development Guides Index: Development guides for building Discord Activities with the Embedded App SDK.
Assets and Metadata: Guide to managing Activity assets, metadata, and configuration.
Growth and Referrals: Implement growth strategies and referral systems in Discord Activities.
Layout: Design effective layouts and user interfaces for Discord Activities.
Local Development: Set up local development environment for Discord Activities.
Mobile: Design and optimize Discord Activities for mobile devices.
Multiplayer Experience: Design and implement engaging multiplayer experiences in Discord Activities.
Networking: Learn networking patterns and best practices for Discord Activities.
Production Readiness: Prepare your Discord Activity for production deployment.
User Actions: Implement user interactions and actions in Discord Activities.
How Activities Work: Understand the technical architecture and lifecycle of Discord Activities.
Activities Overview: Learn about Discord Activities - multiplayer games and social experiences.
Discord Bots & Companion Apps: Start building bots and companion apps for Discord.
Change Log: Discover the latest updates, new features, and bug fixes on the Discord Developer Platform. To join in on the conversation, join the Discord Developers Server.
Components Overview: Learn about Discord's interactive message components.
Component Reference
Using Message Components: Learn how to send interactive message components.
Using Modal Components: Guide to creating and displaying modal dialogs with text input fields.
Community Resources: Discover community-built libraries, tools, and resources for Discord development.
Embedded App SDK Reference
Social SDK Core Concepts: Overview of the Discord Social SDK's core concepts including features, communication, and platform compatibility.
Communication Features: Learn about Discord Social SDK's communication features including direct messages and voice chat.
Core Features: Overview of the Discord Social SDK's core features including user identity and relationships.
Integration Overview: High-level overview of integrating the Discord Social SDK into your application.
Discord Social SDK on Mobile: Add the Discord Social SDK to your iOS and Android games.
OAuth2 Scopes for the Social SDK: Learn about OAuth2 scopes required for Discord Social SDK features.
Platform Compatibility: Learn about Discord Social SDK platform support and compatibility.
Release Cadence & Support: Discord Social SDK release cadence, supported version window, and end-of-life process.
Branding Guidelines: Official branding guidelines for using Discord's brand assets in your integration.
Chat History Design Guidelines: Design guidelines for displaying and managing chat history from Discord.
Connection Points: Design guidelines for creating effective connection points between your application and Discord.
Console Design Guidelines: Design guidelines for implementing Discord Social SDK features on gaming consoles.
Direct Messages Design Guidelines: Design guidelines for implementing Discord direct messaging features in your application.
Game Friends Design Guidelines: Design guidelines for displaying and managing game friends and Discord relationships.
Linked Channels Design Guidelines: Design guidelines for integrating Discord channel functionality into your application.
Principles: Core design principles for creating effective Discord Social SDK integrations.
Provisional Accounts Design Guidelines: Design guidelines for handling provisional Discord accounts and onboarding users.
Designing for Account Linking: Design guidelines for implementing Discord sign-in flows and authentication.
Social Settings Design Guidelines: Design guidelines for implementing social settings and privacy controls.
User Status & Rich Presence Design Guidelines: Design guidelines for displaying user status and Rich Presence information.
Unified Friends List Design Guidelines: Design guidelines for creating unified friends lists that combine Discord relationships.
Account Linking from Discord: Adopt the new account linking APIs to allow Discord to show your players entry points for account linking within the Discord client
Account Linking on Consoles: Implement Discord account linking on gaming consoles.
Account Linking on Mobile: Implement OAuth2 authentication for iOS and Android with deep linking and PKCE.
Account Linking from Your Game: Implement account linking to connect user accounts between your application and Discord.
Creating a Unified Friends List: Build a unified friends list that combines Discord relationships with your application.
Linked Channels: Connect Discord channels with your application for seamless communication.
Managing Game Invites: Create and manage game invitations through Discord to bring friends into your application.
Creating and Managing Lobbies: Create and manage game lobbies with Discord Social SDK for matchmaking.
Managing Relationships in Your Game: Manage Discord user relationships including friends and blocked users in your application.
Managing Voice Chat: Integrate Discord voice chat features into your application.
Publisher Level Account Linking
Sending Direct Messages: Send direct messages to Discord users from your application.
Setting Rich Presence: Update Discord Rich Presence from your application to display activity information.
Using Provisional Accounts: Implement provisional Discord accounts for users who don't have Discord accounts yet.
Getting Started with the Discord Social SDK: Quick start guide for integrating the Discord Social SDK.
Getting Started with C++ and the Discord Social SDK: Get started with the Discord Social SDK in C++ applications.
Getting Started with Unity and the Discord Social SDK: Integrate the Discord Social SDK into Unity games.
Getting Started with Unreal Engine and the Discord Social SDK: Integrate the Discord Social SDK into Unreal Engine games.
How To Guides: How-to guides for integrating Discord Social SDK features into your game.
Debug & Log: Learn how to enable and use debug logging in the Discord Social SDK.
Handle Rate Limits: Detect and handle rate limit errors in the Discord Social SDK using ClientResult.
How To Handle Special Characters in Display Names: Properly handle and display Discord usernames with special characters and emojis.
Integrate Moderation: Implement moderation features and safety controls in your application.
Market Your Integration: Best practices for marketing and promoting your Discord Social SDK integration.
Use with Discord APIs: Combine Discord Social SDK with Discord's REST APIs for enhanced functionality.
Voice Muting Based on Player Blocks: Implement bi-directional voice muting for blocked players in lobby voice calls using lobby member metadata, populated client-side or server-side.
Integrating the Discord Social SDK: Learn how to integrate Discord-powered social features into your game.
Social SDK Reference: Complete API reference for the Discord Social SDK.
Discovery Best Practices: Tips and best practices for optimizing your app's discovery.
Enabling Discovery: Step-by-step guide to verify your app and enable discovery.
Discovery on Discord: Learn how to make your Discord app discoverable through the App Directory.
Gateway: Learn how to establish and maintain Gateway API connections with Discord.
Gateway Events: Complete reference for all Gateway events.
Overview of Events: Learn about the different ways apps can receive events from Discord.
Webhook Events: Learn how to receive Discord events over HTTP using webhooks.
How Can I Grow My Game?
Getting Started with Privileged Intent Review: Guide to understanding the privileged intent review process and how to submit your application for review.
You Might Not Need a Privileged Intent: Guide to understanding privileged intents and their alternatives for your Discord app.
Discord Development Guide Library: Guides to help you get started on your development journey with Discord.
Discord Activity Development Guides: Guides for developing embedded games and experiences on Discord.
Discord Bot Development Guides: Guides for developing bots on Discord.
Community Management Guides: Guides for managing your Discord community and server effectively.
Game Development Guides: Guides for creating games using Discord's APIs, SDKs, and communities.
Platform Feature Guides: Guides for using Discord's features across your game, app, and server experience.
Discord Social SDK Guides: Development guides for integrating the Discord Social SDK into your game.
Application Commands: Complete guide to creating slash commands, user commands, and message commands.
Interactions Overview: Learn about Discord's interactive features including commands and message components.
Receiving and Responding to Interactions
Discord Developer Platform: Build bots and integrations on Discord, or connect your game with rich presence, voice chat, and more.
Enabling Monetization: Step-by-step guide to meet eligibility requirements and enable monetization.
Implementing App Subscriptions: Learn how to implement recurring user and guild subscriptions for premium functionality.
Implementing In-App Purchases for Activities: Step-by-step guide to add monetization to Discord Activities.
Implementing One-Time Purchases: Guide to implementing durable and consumable one-time purchases.
Managing SKUs: Learn how to create and manage SKUs that represent your app's premium offerings.
Monetizing Your Discord App: Learn how to add premium features to your Discord app with subscriptions and purchases.
Account Linking: Connect a player's Discord account to their in-game account to unlock richer social experiences.
Activities: Build multiplayer games and social experiences that run directly inside Discord.
Premium Apps & Activities: Add subscriptions and one-time purchases to your Discord app with Premium Apps.
Bots & Companion Apps: Build bots and companion apps that connect to Discord and interact with servers, members, and events.
Claim Your Game: Learn how to claim your game on Discord to unlock a verified checkmark and take control of your game's profile.
Community Servers: Build and grow a player community around your game by building out a community server on Discord.
Components & Modals: Add interactive buttons, menus, layout elements, and modal dialogs to your Discord app.
App Discovery: Make your Discord app discoverable through the App Directory, App Launcher, and social sharing.
Game Profiles: Learn how Discord surfaces game information to users and where your game's profile appears across the platform.
Interactions & Commands: Build interactive slash commands, buttons, modals, and more using HTTP or the Gateway.
OAuth2 and Permissions: How OAuth2, scopes, and permissions work across the Discord platform.
Rich Presence: Display real-time game activity on Discord user profiles with rich presence.
Server and Channel Management: What Discord apps can do with servers and channels, and what permissions they need.
Social Layer for Games: Add Discord-powered social features directly into your game using the Discord Social SDK.
Webhooks: Send messages into Discord channels or receive event notifications from Discord delivered to your app over HTTP.
Developer Policy
Developer Terms of Service
Building your first Discord Bot: Step-by-step tutorial for building your first Discord app.
Overview of Discord Apps: Build Discord apps to customize, extend, and enhance Discord for millions of users.
API Reference: The 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.
Application Resource: Reference for Discord application objects and management endpoints.
Application Role Connection Metadata: Complete reference for application role connection metadata objects.
Audit Logs Resource: Reference for Discord audit log objects and endpoints.
Auto Moderation: Reference for Discord's Auto Moderation system and endpoints.
Channels Resource
Emoji Resource: Reference for Discord emoji objects and management endpoints.
Entitlement Resource: Reference for Discord entitlement objects that represent user access to premium features.
Guild Resource
Guild Scheduled Event: Reference for Discord scheduled event objects and management endpoints.
Guild Template Resource: Reference for Discord Guild Template objects and management endpoints.
Invite Resource
Lobby Resource: Reference for Discord lobby objects used for matchmaking.
Message Resource: Reference for Discord message objects and management endpoints.
Poll Resource: Reference for Discord poll objects and management endpoints.
SKU Resource: Reference for Discord SKU objects that represent premium app offerings.
Soundboard Resource: Reference for Discord soundboard objects and management endpoints.
Stage Instance Resource: Reference for Discord stage instance objects for managing live audio events.
Sticker Resource: Reference for Discord sticker objects and management endpoints.
Subscription Resource: Reference for Discord subscription objects that represent recurring payments.
User Resource: Reference for Discord user objects and management endpoints.
Voice Resource: Reference for Discord voice objects and connection endpoints.
Webhook Resource: Reference for Discord webhook objects and management endpoints.
Setting a User's Rich Presence
Social Commerce & Game Shops: Sell in-game items, cosmetics, and bundles directly within Discord through a user-facing Game Shop that lives directly in your server.
Certified Devices: Learn about Discord's Certified Device program for hardware integration.
OAuth2
Opcodes and Status Codes
Permissions: Learn how Discord's permission system works including bitwise operations.
Rate Limits: Understand Discord's rate limiting system including per-route and global limits.
RPC: Learn about Discord's RPC server for local application integration.
Managing Your Developer Team: Learn how to create and manage developer teams for collaborative development.
Threads: Learn about Discord threads - temporary sub-channels for organizing conversations.
Voice: Technical guide to implementing voice connections with Discord.
Configuring App Metadata for Linked Roles: Tutorial for setting up role connection metadata to link external app data with Discord roles.
Developing A User-Installable App: Tutorial for creating Discord apps that can be installed to user accounts.
Hosting a Reddit API Discord app on Cloudflare Workers: Tutorial for deploying Discord apps on Cloudflare Workers.
Using Community Invites: Automate role assignment and targeted invites using the Discord Community Invites API.
Additional Resources (Optional)
Optional
Developer Portal
Developer Community
How to Use This Skill
Reference these resources when working with Documentation - Discord.