> ## 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.

# Designing for Account Linking

> Design guidelines for implementing Discord sign-in flows and authentication.

<Info>
  Any in-game imagery used in is purely fictional for concept purposes.
</Info>

## Overall flow

Sign-in or log-in flows all begin with the interaction of a [**Discord-styled button**](/developers/discord-social-sdk/design-guidelines/branding-guidelines#buttons).

The Discord Social SDK will support the user-journeys for those who already **have a Discord account** and those who **do not**. We will similarly support those who have Discord installed as well as those who do not (via browser).

A player can also proceed **without** connecting their Discord and continue onwards to playing their game.

<img src="https://mintcdn.com/discord/DCDjFHiqz1h7oI8V/images/social-sdk/design-guidelines/SigningIn-02.png?fit=max&auto=format&n=DCDjFHiqz1h7oI8V&q=85&s=94b7766ce706bae92a4bfce17ef8b2db" alt="Overall Flow" width="3840" height="2160" data-path="images/social-sdk/design-guidelines/SigningIn-02.png" />

### Connecting your Discord account via Browser (gif)

<img src="https://mintcdn.com/discord/eiEEruEfypjAPE6V/images/social-sdk/design-guidelines/animated/Connecting-via-Browser.gif?s=0b7634eb01361d7dfc785c2ff655f73d" alt="Connecting your Discord account via Browser" width="2098" height="1180" data-path="images/social-sdk/design-guidelines/animated/Connecting-via-Browser.gif" />

## Overlay Authorization

Discord's [Overlay](https://support.discord.com/hc/en-us/articles/217659737-Game-Overlay-101) feature can be used to enable authorization without ever leaving the game. This is available for games who support the feature.

<img src="https://mintcdn.com/discord/DCDjFHiqz1h7oI8V/images/social-sdk/design-guidelines/SigningIn-05.png?fit=max&auto=format&n=DCDjFHiqz1h7oI8V&q=85&s=0e695a4675d967bd36c721989dbe7a94" alt="Overlay Authorization" width="3840" height="2160" data-path="images/social-sdk/design-guidelines/SigningIn-05.png" />

## Before the user connects

We recommend adding a **one-time user education** modal based on feedback we've heard from developers and players.

This modal should include some of the key value props that the Discord Social SDK provides. The modal should be placed contextually **in the game**.

#### Suggested Moments

* Trigger upon game-start for first time after the Discord Social SDK integration is launched to players
* Show when player interacts with the friends list for the first time
* Show in the authorization flow once a player taps the Discord connection point

<img src="https://mintcdn.com/discord/DCDjFHiqz1h7oI8V/images/social-sdk/design-guidelines/SigningIn-06.png?fit=max&auto=format&n=DCDjFHiqz1h7oI8V&q=85&s=fbb090824ae81b6b8eb8260b9d4df34c" alt="Before the user connects" width="3840" height="2160" data-path="images/social-sdk/design-guidelines/SigningIn-06.png" />

## After the user connects

We recommend adding a **success state** in the game when the authorization completes — styled in a way that fits the game's aesthetic.

#### Content

Include the following points sequentially in the game' s writing-style. Remove any points that covers features that the game does not utilize.

* You successfully connected your Discord account
* You can chat with your friends here and on Discord
* It might take some time for your game friends to show up in your Discord

<img src="https://mintcdn.com/discord/DCDjFHiqz1h7oI8V/images/social-sdk/design-guidelines/SigningIn-07.png?fit=max&auto=format&n=DCDjFHiqz1h7oI8V&q=85&s=ae9520658d928cda2e4fc8b1b2974adf" alt="After the user connects" width="3840" height="2160" data-path="images/social-sdk/design-guidelines/SigningIn-07.png" />

## Error State

The user will also need to be shown an **error state** if the authorization fails — also styled in a way that fits the game's aesthetic.

Please include these key points sequentially in the game's writing-style:

* We were unable to connect your Discord account
* A call-to-action that redirects back to Discord with the initial authorization modal

<img src="https://mintcdn.com/discord/DCDjFHiqz1h7oI8V/images/social-sdk/design-guidelines/SigningIn-08.png?fit=max&auto=format&n=DCDjFHiqz1h7oI8V&q=85&s=c8d2e7434e3f8f0f28c8670478a7e080" alt="Error State" width="3840" height="2160" data-path="images/social-sdk/design-guidelines/SigningIn-08.png" />

***

## Resources

* [Development Guide: Account Linking with Discord](/developers/discord-social-sdk/development-guides/account-linking-with-discord)

## Change Log

| Date           | Changes         |
| -------------- | --------------- |
| March 17, 2025 | initial release |