> ## Documentation Index
> Fetch the complete documentation index at: https://discord-dependabot-npm-and-yarn-actions-core-3-0-1.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Game Friends Design Guidelines

> Design guidelines for displaying and managing game friends and Discord relationships.

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

## User needs

We've heard from players that they want more of a distinction between connections they make in-game, and friends they spend time with on Discord outside of and across games. Someone I party up with may not necessarily be my "friend".

Users want more controls over how in-game relationships extend beyond the game client with communication, presence, and identity.

<img src="https://mintcdn.com/discord-dependabot-npm-and-yarn-actions-core-3-0-1/0tOOxAmG8wslXAg0/images/social-sdk/design-guidelines/GameFriends-02.png?fit=max&auto=format&n=0tOOxAmG8wslXAg0&q=85&s=00bda58518971e3a6103fbe4c2e273e7" alt="User needs" width="3840" height="2160" data-path="images/social-sdk/design-guidelines/GameFriends-02.png" />

## Game Friends — A new tier

Discord is introducing a new tier of friendship called **Game Friends**.

Game Friends are a way to create an in-game relationship with another player that provides all of the in-game benefits, but limits how the relationship extends outside the game.

<img src="https://mintcdn.com/discord-dependabot-npm-and-yarn-actions-core-3-0-1/0tOOxAmG8wslXAg0/images/social-sdk/design-guidelines/GameFriends-03.png?fit=max&auto=format&n=0tOOxAmG8wslXAg0&q=85&s=6a10156e378c54ecd39527c408e6378a" alt="Game Friends" width="3840" height="2160" data-path="images/social-sdk/design-guidelines/GameFriends-03.png" />

## Game vs Discord Friends

### Communication

A Game Friend **can reach Discord-connected friends outside the game** by DMing those in the game who are offline — these messages will be received on the Discord client. Discord provides players a setting to disable receiving DMs from Game Friends.

### Presence

A Game Friend **cannot see your rich presence** beyond the game your friendship originated in. The exception is if both friends have their Discord accounts connected and are in a shared server.

<img src="https://mintcdn.com/discord-dependabot-npm-and-yarn-actions-core-3-0-1/0tOOxAmG8wslXAg0/images/social-sdk/design-guidelines/GameFriends-04.png?fit=max&auto=format&n=0tOOxAmG8wslXAg0&q=85&s=6da0719df525b670b3b8c8289799b8b4" alt="Game vs Discord Friends" width="3840" height="2160" data-path="images/social-sdk/design-guidelines/GameFriends-04.png" />

## Equally-weighted

When adding a new friend, **present two options to players with "Game Friends" listed first**, since it's the more localized/limited friend-tier. Please ensure that neither type of friend is pre-selected in the UI — present them equally to the user (ordering aside for above reasons).

<img src="https://mintcdn.com/discord-dependabot-npm-and-yarn-actions-core-3-0-1/0tOOxAmG8wslXAg0/images/social-sdk/design-guidelines/GameFriends-05.png?fit=max&auto=format&n=0tOOxAmG8wslXAg0&q=85&s=fdabe73535fd96e8e39f59bf9ceeefab" alt="Equally-weighted friend options" width="3840" height="2160" data-path="images/social-sdk/design-guidelines/GameFriends-05.png" />

## Adding friends

If the user is not yet a friend, show both options of adding as either a Game or Discord Friend.

If a user is already your Game Friend, show the action to also add them on Discord.

<img src="https://mintcdn.com/discord-dependabot-npm-and-yarn-actions-core-3-0-1/0tOOxAmG8wslXAg0/images/social-sdk/design-guidelines/GameFriends-06.png?fit=max&auto=format&n=0tOOxAmG8wslXAg0&q=85&s=09f0e0a342fc5d78632acdda0ebd32a3" alt="Adding friends" width="3840" height="2160" data-path="images/social-sdk/design-guidelines/GameFriends-06.png" />

## Removing friends

When removing a Game Friend or Discord Friend, show players the standard "Remove Friend" action. The SDK will remove the friend across whatever friendships are applicable.

<img src="https://mintcdn.com/discord-dependabot-npm-and-yarn-actions-core-3-0-1/0tOOxAmG8wslXAg0/images/social-sdk/design-guidelines/GameFriends-07.png?fit=max&auto=format&n=0tOOxAmG8wslXAg0&q=85&s=498250a34ab672f6747a79976893bc30" alt="Removing friends" width="3840" height="2160" data-path="images/social-sdk/design-guidelines/GameFriends-07.png" />

## Style guidelines

When removing a Game Friend or Discord Friend, show players the standard "Remove Friend" action. The SDK will remove the friend across whatever friendships are applicable.

<img src="https://mintcdn.com/discord-dependabot-npm-and-yarn-actions-core-3-0-1/0tOOxAmG8wslXAg0/images/social-sdk/design-guidelines/GameFriends-08.png?fit=max&auto=format&n=0tOOxAmG8wslXAg0&q=85&s=2853ff9658965a4be9ff6be1887fd298" alt="Removing friends" width="3840" height="2160" data-path="images/social-sdk/design-guidelines/GameFriends-08.png" />

## UX, not UI

The visual styling of the "Add Friend" menu-items is not intended to be prescriptive. So long as both options are equally-weighted, please use whichever UI fits your game's needs.

<img src="https://mintcdn.com/discord-dependabot-npm-and-yarn-actions-core-3-0-1/0tOOxAmG8wslXAg0/images/social-sdk/design-guidelines/GameFriends-09.png?fit=max&auto=format&n=0tOOxAmG8wslXAg0&q=85&s=996f29dd1522d361b17f7f1b41b849ff" alt="UX, not UI" width="3840" height="2160" data-path="images/social-sdk/design-guidelines/GameFriends-09.png" />

## Setting on Discord

This mock showcases how the corresponding DM looks within Discord's UI.

<img src="https://mintcdn.com/discord-dependabot-npm-and-yarn-actions-core-3-0-1/0tOOxAmG8wslXAg0/images/social-sdk/design-guidelines/GameFriends-10.png?fit=max&auto=format&n=0tOOxAmG8wslXAg0&q=85&s=106b009f6c1f95e9415ac3bc4dfe0445" alt="Removing friends" width="3840" height="2160" data-path="images/social-sdk/design-guidelines/GameFriends-10.png" />

***

## Resources

* [Development Guide: Managing Relationships](/developers/discord-social-sdk/development-guides/managing-relationships)

## Change Log

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