> 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 most powerful platform integration on RivalRyze. Connecting it once unlocks **four** things:

1. The RivalRyze Bot in any server you're in.
2. Guild Contests restricted to specific Discord communities.
3. Role-based Contest access (Contests open only to a specific Discord role).
4. **Quick-linking your other gaming accounts** — PSN, Steam, and Xbox can all be pulled from your Discord connections.

PSN is **Discord-only** (no direct sign-in). Steam and Xbox both support direct sign-in too, but Discord is faster if you've already connected them there.

## If you signed up with Discord

You're already connected — no action needed. Your Discord account was linked automatically during signup.

## If you signed up with email

1. Open **Account Settings → Connections**.
2. Find **Discord** and click **Connect**.
3. You'll be redirected to Discord. Click **Authorize**.
4. You'll be sent back to RivalRyze with Discord linked.

## Linking gaming accounts via Discord

Discord has its own **Connections** feature that links your PSN, Steam, Xbox, and other accounts to your Discord profile. Once linked there, RivalRyze can read them in one click — no second sign-in needed.

### How to link a gaming account in Discord

1. Open Discord (app or [discord.com](https://discord.com)) and sign in.
2. Click the **gear icon** at the bottom-left to open **User Settings**.
3. Select **Connections** from the left menu.
4. Click **+** and pick the platform (PlayStation Network, Steam, Xbox, etc.).
5. Sign in to that platform when prompted.
6. **Toggle "Display on profile" to ON** for the connection.

{% hint style="warning" %}
"Display on profile" must be ON for RivalRyze to read the connection. Discord doesn't default it to ON for all users — check manually each time you link a new platform.
{% endhint %}

### Then on RivalRyze

For each gaming platform you linked in Discord:

1. Open **Account Settings → Connections** on RivalRyze.
2. Find the platform and click **Connect via Discord**.
3. RivalRyze pulls the account ID from your Discord connection.
4. Sync starts.

## What RivalRyze sees on Discord

We request the minimum permissions needed:

* Your Discord **user ID** and **username** (to identify you).
* The list of **servers** you're a member of (to show you guild Contests you're eligible for).
* Your **public connections** with "Display on profile" enabled (to pull PSN, Steam, Xbox IDs).

We do **not** read your messages, see your DMs, or post on your behalf.

## What this unlocks

* **Guild Contests** — Contests restricted to members of a specific Discord server become visible to you if you're a member.
* **Discord Bot commands** — `/profile`, `/balance`, `/leaderboard`, and others (in any server where the bot is installed) recognize you as a RivalRyze user.
* **Role-based access** — if a Contest requires a specific Discord role, RivalRyze can check whether you have it.
* **Quick PSN / Steam / Xbox linking** — covered above.

## Disconnecting Discord

You can unlink Discord from **Account Settings → Connections**, but you'll lose access to:

* All guild-only Contests you're currently in.
* Bot commands that identify you in Discord chats.
* **Your PSN connection** — PSN is linked through Discord, so unlinking Discord disconnects PSN entirely.
* Steam and Xbox connections that were linked via Discord (you can reconnect those directly without Discord if you want).

If Discord is your only login method, you'll need to [set an email and password](/your-account/email-password-settings.md) first.

## Troubleshooting

### "Authorization failed" when I clicked Connect

Make sure you're logged into the correct Discord account in your browser. If you have multiple Discord accounts, switch to the one you want to link before clicking Connect again.

### The bot can't see me in a server

The bot needs to be installed on that server first. Ask the server admin to set it up — see [Adding the Bot to Your Server](/for-guild-admins/adding-the-bot.md).

### "User does not have a PSN/Steam/Xbox connection" when linking via Discord

In Discord, open **User Settings → Connections**. Verify the platform is listed and **"Display on profile"** is toggled **ON**. Then retry **Connect via Discord** on RivalRyze.

## Related

* [Connecting PlayStation Network](/connecting-gaming-platforms/playstation-network.md) — the full PSN-via-Discord flow
* [Connecting Steam](/connecting-gaming-platforms/steam.md) — Discord or direct
* [Connecting Xbox](/connecting-gaming-platforms/xbox.md) — Discord or direct


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.rivalryze.com/connecting-gaming-platforms/discord.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
