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

# Linked Channels Design Guidelines

> Design guidelines for integrating Discord channel functionality into your application.

## Link in-game chats to Discord

Empower players to continue their conversations beyond the game. Now you can link an in-game chat to a text-channel on Discord.

<img src="https://mintcdn.com/discord-platform-username/QOcOWyXoil5ne6It/images/social-sdk/design-guidelines/animated/LinkedChannel-Setup.gif?s=0db9fa48b37a280ee587aed284084fa9" alt="Linking a channel via the game" width="1920" height="1078" data-path="images/social-sdk/design-guidelines/animated/LinkedChannel-Setup.gif" />

## Style guidelines

#### Feature Name & Language

The official feature-name that will be reflected across the Discord client is "Linked Channels." Please use the following language when referring to this feature to promote player comprehension across clients.

* "Linked to \{Discord/GameTitle}"
* "Link a \{groupChat} to Discord"
* "Edit/Remove Channel Link"

#### Entrypoints

Please use the string guidance from above: "Link \{groupChat} to Discord." For interface, use whichever UI treatment that fits your game's needs.

<img src="https://mintcdn.com/discord-platform-username/Z5-dy2Vp33QrO7f-/images/social-sdk/design-guidelines/LinkedChannels-04.png?fit=max&auto=format&n=Z5-dy2Vp33QrO7f-&q=85&s=43ee387e893574f7387d9f8c97c73c58" alt="Linked channel style guidelines" width="3840" height="2160" data-path="images/social-sdk/design-guidelines/LinkedChannels-04.png" />

## Selecting a channel

Players require a channel-selection flow where they can pick a text-channel to link their game-chat with. Only one text-channel can be linked at a time. Furthermore, the player must have the permissions to manage the channel.

Please include the following in the selection UI:

#### UI Elements

* Description of what a channel link does and **who can read and write to the channel** after establishing the link
* List of **servers** and their nested **text-channels** with respective iconography (ie, private channel has a lock)
* **Search bar** for channel-names

<img src="https://mintcdn.com/discord-platform-username/Z5-dy2Vp33QrO7f-/images/social-sdk/design-guidelines/LinkedChannels-05.png?fit=max&auto=format&n=Z5-dy2Vp33QrO7f-&q=85&s=7a6d519ea2b7f1a5219c1a77e7d34d69" alt="Selecting a channel" width="3840" height="2160" data-path="images/social-sdk/design-guidelines/LinkedChannels-05.png" />

## Setup warning

Players can link channels with **limited access** on Discord. Doing so will allow players from their game-chat to also read and send messages to this channel, **regardless of whether or not they have permissions on Discord**. In short, linking a game-channel will bypass that channel's existing permissions on Discord.

Show a **warning** when a user is about to link to a channel with limited access. We strongly recommend you use the copy shown to the right image.

<img src="https://mintcdn.com/discord-platform-username/Z5-dy2Vp33QrO7f-/images/social-sdk/design-guidelines/LinkedChannels-06.png?fit=max&auto=format&n=Z5-dy2Vp33QrO7f-&q=85&s=72a3551d3c22adc8330618082250b00e" alt="Setup warning" width="3840" height="2160" data-path="images/social-sdk/design-guidelines/LinkedChannels-06.png" />

## Success state & Entrypoint

Once the channel link is established, show a **success state** to the user detailing which text-channel they've linked to on Discord.

Separately, create a **persistent entrypoint** somewhere in the game UI. This persistent entrypoint should also show details such as the Discord server and channel name. It will also serve as the entrypoint for managing the linked channel (next slide).

[You can download the official "Linked Channels" channel-icon in our GitHub repository.](https://github.com/discord/discord-api-docs/blob/main/resources/discord-social-sdk)

<img src="https://mintcdn.com/discord-platform-username/Z5-dy2Vp33QrO7f-/images/social-sdk/design-guidelines/LinkedChannels-07.png?fit=max&auto=format&n=Z5-dy2Vp33QrO7f-&q=85&s=79ca5f29add1d8e5201d742f2fde4522" alt="Success state & Entrypoint" width="3840" height="2160" data-path="images/social-sdk/design-guidelines/LinkedChannels-07.png" />

## Removing Channel Link

Players can navigate to the relevant channel settings on Discord from the "**Edit settings**" menu item. Please pair with an "open in new window" icon.

Players can remove the channel link from either the game client or the Discord client.

When "Remove channel-link" is interacted with, show the player a **confirmation** dialog to confirm this action.

<img src="https://mintcdn.com/discord-platform-username/QOcOWyXoil5ne6It/images/social-sdk/design-guidelines/animated/LinkedChannels-08.gif?s=0a4bb560f68c501f5d236b876afbbc74" alt="Removing Channel Link" width="1920" height="1079" data-path="images/social-sdk/design-guidelines/animated/LinkedChannels-08.gif" />

***

## Resources

* [Development Guide: Linked Channels](/developers/discord-social-sdk/development-guides/linked-channels)
* [Design Assets: Linked Channel Icon](https://github.com/discord/discord-api-docs/blob/main/resources/discord-social-sdk)

## Change Log

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