Skip to content

Social SDK: Add Social Settings Design Guideline #7548

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
May 9, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions docs/discord-social-sdk/design-guidelines.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,7 @@ subpages:
- design-guidelines/branding-guidelines.mdx
- design-guidelines/unified-friends-list.mdx
- design-guidelines/direct-messages.mdx
- design-guidelines/social-settings.mdx
- design-guidelines/provisional-accounts.mdx
- design-guidelines/status-rich-presence.mdx
- design-guidelines/consoles.mdx
Expand Down Expand Up @@ -42,6 +43,9 @@ If you are looking for a place to get started, we recommend you start with [Prin
<Card title="Direct Messages" link="/docs/discord-social-sdk/design-guidelines/direct-messages" icon="ChatIcon">
Best practices for enabling direct messaging between players, facilitating private communication, and enhancing social interactions.
</Card>
<Card title="Social Settings" link="/docs/discord-social-sdk/design-guidelines/social-settings" icon="ChatIcon">
Best practices for implementing and managing access to the Discord social settings in games using the Discord Social SDK
</Card>
<Card title="Provisional Accounts" link="/docs/discord-social-sdk/design-guidelines/provisional-accounts" icon="UserIcon">
Designing around provisional accounts for users who prefer not to link their Discord accounts, allowing them to enjoy social features still.
</Card>
Expand Down
45 changes: 45 additions & 0 deletions docs/discord-social-sdk/design-guidelines/social-settings.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,45 @@
---
sidebar_label: Social Settings
---

[Home](/docs/intro) > [Discord Social SDK](/docs/discord-social-sdk/overview) > [Design Guidelines](/docs/discord-social-sdk/design-guidelines) > Social Settings

# Social Settings

## Evolving with users

Discord is listening to feedback and releasing settings for players to tailor their social experience to their needs. These settings will continue to change and evolve with the SDK and Discord client.

Discord Social SDK settings are global, meaning they will impact all games that use the Discord Social SDK. These settings live in the Discord client.

![Evolving with users](images/social-sdk/design-guidelines/SocialSettings-02.webp)

## Main entrypoint

An entrypoint is required in games to
[send players to the relevant Discord client settings page](/docs/discord-social-sdk/development-guides/sending-direct-messages#ingame-direct-message-settings).
Only players who have their Discord account connected should see this.

Exactly like the auth flow, players will be redirected to the Discord client to manage their social settings. If they do not have the client, the browser will be the fallback.

![Main entrypoint](images/social-sdk/design-guidelines/SocialSettings-03.webp)

## Content guidelines

The official settings title for players is "Discord Social Experience." Use this language when referring to Social SDK settings to players.

The description is optional, but if your game settings has the space, we recommend describing what users should expect to find when they navigate to Discord.

![Content guidelines](images/social-sdk/design-guidelines/SocialSettings-04.webp)

---

## Resources

- [Development Guide: Direct Messages](/docs/discord-social-sdk/development-guides/sending-direct-messages)

## Change Log

| Date | Changes |
|--------------|-----------------|
| May 08, 2025 | initial release |
Binary file not shown.
Binary file not shown.
Binary file not shown.