> ## Documentation Index
> Fetch the complete documentation index at: https://docs.discord.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Discord Social SDK on Mobile

> Add the Discord Social SDK to your iOS and Android games.

export const PlayIcon = props => <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="none"><path fill="currentColor" d="M9.25 3.35C7.87 2.45 6 3.38 6 4.96v14.08c0 1.58 1.87 2.5 3.25 1.61l10.85-7.04a1.9 1.9 0 0 0 0-3.22L9.25 3.35Z" /></svg>;

export const ShapesIcon = props => <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="none"><path fill="currentColor" d="M2.06 7.61c-.25.95.31 1.92 1.26 2.18l4.3 1.15c.94.25 1.91-.31 2.17-1.26l1.15-4.3c.25-.94-.31-1.91-1.26-2.17l-4.3-1.15c-.94-.25-1.91.31-2.17 1.26l-1.15 4.3ZM12.98 7.87a2 2 0 0 0 1.75 2.95H20a2 2 0 0 0 1.76-2.95l-2.63-4.83a2 2 0 0 0-3.51 0l-2.63 4.83ZM5.86 13.27a.89.89 0 0 1 1.28 0l.75.77a.9.9 0 0 0 .54.26l1.06.12c.5.06.85.52.8 1.02l-.13 1.08c-.02.2.03.42.14.6l.56.92c.27.43.14 1-.28 1.26l-.9.58a.92.92 0 0 0-.37.48l-.36 1.02a.9.9 0 0 1-1.15.57l-1-.36a.89.89 0 0 0-.6 0l-1 .36a.9.9 0 0 1-1.15-.57l-.36-1.02a.92.92 0 0 0-.37-.48l-.9-.58a.93.93 0 0 1-.28-1.26l.56-.93c.11-.17.16-.38.14-.59l-.12-1.08c-.06-.5.3-.96.8-1.02l1.05-.12a.9.9 0 0 0 .54-.26l.75-.77ZM18.52 13.71a1.1 1.1 0 0 0-2.04 0l-.46 1.24c-.19.5-.57.88-1.07 1.07l-1.24.46a1.1 1.1 0 0 0 0 2.04l1.24.46c.5.19.88.57 1.07 1.07l.46 1.24c.35.95 1.7.95 2.04 0l.46-1.24c.19-.5.57-.88 1.07-1.07l1.24-.46a1.1 1.1 0 0 0 0-2.04l-1.24-.46a1.8 1.8 0 0 1-1.07-1.07l-.46-1.24Z" /></svg>;

export const LinkIcon = props => <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="none"><path fill="currentColor" d="M16.32 14.72a1 1 0 0 1 0-1.41l2.51-2.51a3.98 3.98 0 0 0-5.62-5.63l-2.52 2.51a1 1 0 0 1-1.41-1.41l2.52-2.52a5.98 5.98 0 0 1 8.45 8.46l-2.52 2.51a1 1 0 0 1-1.41 0ZM7.68 9.29a1 1 0 0 1 0 1.41l-2.52 2.51a3.98 3.98 0 1 0 5.63 5.63l2.51-2.52a1 1 0 0 1 1.42 1.42l-2.52 2.51a5.98 5.98 0 0 1-8.45-8.45l2.51-2.51a1 1 0 0 1 1.42 0Z" /><path fill="currentColor" d="M14.7 10.7a1 1 0 0 0-1.4-1.4l-4 4a1 1 0 1 0 1.4 1.4l4-4Z" /></svg>;

export const MobilePhoneIcon = props => <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="none"><path fill="currentColor" fill-rule="evenodd" d="M5 4a3 3 0 0 1 3-3h8a3 3 0 0 1 3 3v16a3 3 0 0 1-3 3H8a3 3 0 0 1-3-3V4Zm5 16a1 1 0 0 1 1-1h2a1 1 0 1 1 0 2h-2a1 1 0 0 1-1-1ZM8 3a1 1 0 0 0-1 1v12a1 1 0 0 0 1 1h8a1 1 0 0 0 1-1V4a1 1 0 0 0-1-1H8Z" clip-rule="evenodd" /></svg>;

This guide explains how to add the Discord Social SDK to your iOS and Android game. It covers what's supported on mobile, the mobile-specific setup you'll need, and where to go next for each game engine.

***

## Platform Support

The Discord Social SDK is **Generally Available** on both mobile platforms:

| Platform | Supported Versions | Standalone C++ | Unreal Engine | Unity |
| -------- | ------------------ | -------------- | ------------- | ----- |
| Android  | 7.0+               | ✅              | ✅             | ✅     |
| iOS      | 15.1+              | ✅              | ✅             | ✅     |

For the full cross-platform support matrix, see [Platform Compatibility](/developers/discord-social-sdk/core-concepts/platform-compatibility).

***

## Feature Availability on Mobile

All Discord Social SDK features are available on mobile. The table below lists mobile-specific setup or behavior differences where they apply.

| Feature                                                                                              | Mobile-Specific Notes                                                                                                                                                                                                                                                                            |
| ---------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| [Account Linking](/developers/discord-social-sdk/development-guides/account-linking-with-discord)    | Requires deep linking (`discord-APP_ID:/authorize/callback`). Discord mobile app launches first for authentication, falls back to browser if not installed. See [Account Linking on Mobile](/developers/discord-social-sdk/development-guides/account-linking-on-mobile)                         |
| [Provisional Accounts](/developers/discord-social-sdk/development-guides/using-provisional-accounts) | No special considerations                                                                                                                                                                                                                                                                        |
| [Friends & Relationships](/developers/discord-social-sdk/development-guides/managing-relationships)  | No special considerations                                                                                                                                                                                                                                                                        |
| [Rich Presence](/developers/discord-social-sdk/development-guides/setting-rich-presence)             | Requires account linking. Unlike desktop, you cannot publish presence on mobile without account linking first                                                                                                                                                                                    |
| [Game Invites](/developers/discord-social-sdk/development-guides/managing-game-invites)              | Requires https URL configured in Developer Portal General tab and specifying supported mobile platforms. See [Supporting Mobile Game Invites](/developers/discord-social-sdk/development-guides/managing-game-invites#supporting-mobile-game-invites)                                            |
| [Direct Messages](/developers/discord-social-sdk/development-guides/sending-direct-messages)         | No special considerations                                                                                                                                                                                                                                                                        |
| [Lobbies & In-Game Chat](/developers/discord-social-sdk/development-guides/managing-lobbies)         | No special considerations                                                                                                                                                                                                                                                                        |
| [Voice Chat](/developers/discord-social-sdk/development-guides/managing-voice-chat)                  | Request microphone permissions. See platform-specific setup: [iOS](/developers/discord-social-sdk/development-guides/account-linking-on-mobile#2-set-microphone-usage-description), [Android](/developers/discord-social-sdk/development-guides/account-linking-on-mobile#3-android-permissions) |
| [Linked Channels](/developers/discord-social-sdk/development-guides/linked-channels)                 | No special considerations                                                                                                                                                                                                                                                                        |

***

## Prerequisites

Before integrating on mobile, make sure you have:

* A Discord application with the Social SDK enabled. See [Getting Started](/developers/discord-social-sdk/getting-started) to create your team, application, and enable the SDK.
* A mobile OAuth2 redirect URI configured in the format `discord-YOUR_APP_ID:/authorize/callback` (replace `YOUR_APP_ID` with your Discord application ID).
* Your development environment set up for your target platform (Xcode for iOS, Android Studio for Android).

<Tip>
  **Reduce binary size:** You can reduce the SDK's installation size on mobile by excluding Krisp noise cancellation. See [Excluding Krisp to Reduce Installation Size](/developers/discord-social-sdk/development-guides/managing-voice-chat#excluding-krisp-to-reduce-installation-size).
</Tip>

***

## Choose Your Getting Started Path

Select the integration that matches your project. Each guide covers download, project setup, and connecting to Discord, with mobile-specific notes where they apply.

<CardGroup cols={3}>
  <Card title="Standalone C++" href="/developers/discord-social-sdk/getting-started/using-c++" icon={<PlayIcon />}>
    For custom engines or standalone applications targeting iOS and Android.
  </Card>

  <Card title="Unity" href="/developers/discord-social-sdk/getting-started/using-unity" icon={<PlayIcon />}>
    For Unity projects building to mobile.
  </Card>

  <Card title="Unreal Engine" href="/developers/discord-social-sdk/getting-started/using-unreal-engine" icon={<PlayIcon />}>
    For Unreal Engine projects building to mobile.
  </Card>
</CardGroup>

***

## Samples

### Unity Mobile Sample

Check out our [Unity sample for the Discord Social SDK](https://github.com/discord/social-sdk-unity-sample), which includes a mobile scene (`Assets/Scenes/Mobile.unity`) that runs on Android and iOS. It contains easy to drop in prefabs with both code and UI to quickly integrate Discord's social features into your mobile game, with all mobile-specific configuration already set up:

* Mobile redirect URI (`discord-APP_ID:/authorize/callback`) registration
* Build processors that auto-inject the redirect scheme into Android manifest and iOS `Info.plist`
* Portrait-optimized UI that reuses the same Discord SDK integration as the desktop scene

See the **[Mobile Setup](https://github.com/discord/social-sdk-unity-sample#mobile-setup)** section in the sample's README for build instructions.

<video src="https://mintcdn.com/discord/aa39jJhCihZpqXmy/images/social-sdk/core-concepts/mobile/unity-mobile-sample.mov?fit=max&auto=format&n=aa39jJhCihZpqXmy&q=85&s=dbc431ca48ed8c455b96dcb972697071" controls width="400" data-path="images/social-sdk/core-concepts/mobile/unity-mobile-sample.mov" />

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Design Foundations" href="/developers/discord-social-sdk/design-guidelines/principles" icon={<ShapesIcon />}>
    UI patterns and principles for integrating Discord into your game.
  </Card>

  <Card title="Development Guides" href="/developers/discord-social-sdk/development-guides" icon={<MobilePhoneIcon />}>
    Add features like a unified friends list, rich presence, and more.
  </Card>
</CardGroup>

***

## Change Log

| Date          | Changes         |
| ------------- | --------------- |
| July 14, 2026 | Initial release |
