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