> For the complete documentation index, see [llms.txt](https://docs.rivalryze.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rivalryze.com/connecting-gaming-platforms/discord.md).

# Discord

Discord is the account RivalRyze leans on most. Connecting it lets you:

* Join **Guilds**. A RivalRyze Guild mirrors a Discord server, so RivalRyze checks which servers you're in.
* Join guild-only and role-based Contests.
* Use the RivalRyze bot in servers where it's installed, as yourself.
* Link **PlayStation** (Discord is the only way) and, if you like, **Steam** through your Discord connections.
* Show your other Discord connections (YouTube, TikTok and more) as social links on your profile.

## If you signed up with Discord

You're already connected. Discord is also how you sign in, so you can't disconnect it.

## Connect Discord

1. Open **Settings** (in the sidebar, or from your account menu) and pick the **Connections** tab.
2. Under **Authenticate with your account**, find **Discord** and click **Connect**.
3. Discord opens and asks you to authorize RivalRyze. Click **Authorize**.
4. You land back on RivalRyze with Discord connected.

RivalRyze uses your Discord avatar as your profile picture.

Once Discord is connected, its row shows **Reconnect** and **Disconnect**.

## Linking games through your Discord connections

Discord has its own **Connections** list (in Discord: **User Settings → Connections**) where you can add PlayStation Network, Steam and other accounts. RivalRyze reads that list to link two platforms:

| Platform    | How RivalRyze links it                                                                                           |
| ----------- | ---------------------------------------------------------------------------------------------------------------- |
| PlayStation | Only through Discord. See [Connecting PlayStation Network](/connecting-gaming-platforms/playstation-network.md). |
| Steam       | Through Discord, or directly with Steam sign-in. See [Connecting Steam](/connecting-gaming-platforms/steam.md).  |

On the **Connections** tab, these rows sit under **Link your accounts through Discord connections**. They stay greyed out until Discord is connected.

1. In Discord, open **User Settings → Connections** and add the platform.
2. On RivalRyze, open **Settings → Connections** and click **Connect** on the **PlayStation** or **Steam** row under **Link your accounts through Discord connections**.

{% hint style="info" %}
RivalRyze reads your Discord connections list whether or not a connection is shown on your Discord profile, so **Display on profile** doesn't affect linking PlayStation or Steam. It does decide which connections appear as social links on your RivalRyze profile (see below).
{% endhint %}

## What RivalRyze reads and writes on Discord

When you authorize RivalRyze, Discord asks you to allow these permissions:

| Permission                                 | What RivalRyze uses it for                                                                       |
| ------------------------------------------ | ------------------------------------------------------------------------------------------------ |
| Your account (username, avatar) and email  | Identifying you and your profile picture                                                         |
| Your servers, and your member info in them | Finding which Guilds you can join, and checking your Discord roles for Contests that require one |
| Your connections                           | Linking PlayStation and Steam, and your social links                                             |
| Linked Roles                               | Sharing a few RivalRyze stats that Discord servers can use for Linked Roles                      |

RivalRyze doesn't ask for access to your messages and can't post as you.

### Social links

Connections you show on your Discord profile (with **Display on profile** turned on) for services such as TikTok, YouTube, X (Twitter), Instagram, Reddit, Roblox, Facebook and Spotify appear as social links on your RivalRyze profile and next to your name on leaderboards. Turn **Display on profile** off in Discord to remove one; RivalRyze picks the change up on its next sync.

### Linked Roles

Discord servers can use Linked Roles to give a role to members who meet a requirement. RivalRyze shares four values with Discord for this:

| Value                      | Requirement a server can set                                |
| -------------------------- | ----------------------------------------------------------- |
| Game Completions           | At least a number of completed games                        |
| Platinum Trophies          | At least a number of PlayStation platinums                  |
| Subscription Tier          | A specific RivalRyze subscription tier                      |
| Achievement Points Ranking | Your monthly achievement points rank at or above a position |

RivalRyze updates these values when you connect Discord and once a day after that.

## Reconnecting Discord

Discord can stop accepting RivalRyze's access, for example when you remove RivalRyze from your Discord **Authorized Apps** or change your Discord password. When that happens, actions that need Discord show:

> Your Discord connection has expired. Reconnect your Discord account to continue.

Click **Reconnect** on the Discord row in **Settings → Connections** (or the **Reconnect Discord** button where the prompt appears) and authorize RivalRyze again. If you started from a prompt, you're sent back to where you were.

If you see **We could not reach Discord. Please try again in a moment.**, Discord itself is unreachable. Wait a moment and try again.

## Disconnecting Discord

Click **Disconnect** on the Discord row. Disconnecting:

* Unlinks your **PlayStation** account, since it's linked through Discord.
* Unlinks **Steam** if you linked it through Discord. A Steam account linked directly with Steam sign-in stays.
* Revokes RivalRyze's access on Discord and deletes the Discord details RivalRyze stored.

Anything that needs Discord (joining Guilds, guild-only and role-based Contests, the bot recognising you) stops working until you connect again.

If you signed up with Discord, you can't disconnect it.

## Troubleshooting

### Discord authorization failed

Make sure you're signed in to the right Discord account in your browser, then click **Connect** again. If you have several Discord accounts, switch to the one you want first.

### "You are not in this guild's Discord server yet"

A Guild mirrors a Discord server. Join that server on Discord with the account you connected, then try again.

### The bot doesn't recognise me in a server

The bot must be installed on that server. Ask the server's admins, or see [Adding the Bot to Your Server](/for-guild-admins/adding-the-bot.md).

## Related

* [Connecting PlayStation Network](/connecting-gaming-platforms/playstation-network.md)
* [Connecting Steam](/connecting-gaming-platforms/steam.md)
* [Troubleshooting Sync Issues](/connecting-gaming-platforms/troubleshooting-sync.md)