> 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/xbox.md).

# Xbox

Link your Xbox account to track achievements, gamerscore, and game library activity. You have two paths to connect: via Discord (faster if you already have Xbox linked there) or directly with your Microsoft account.

## Option 1 — Connect via Discord (faster if Discord is linked)

If you've already linked Xbox to your Discord account (User Settings → Connections), RivalRyze can pull it in one click.

1. Open **Account Settings → Connections** on RivalRyze.
2. Find **Xbox** and click **Connect via Discord**.
3. RivalRyze reads your Xbox account from your Discord connection.
4. Your initial sync starts immediately.

For this to work, the Xbox connection on Discord must have **"Display on profile"** toggled **ON**. See [Connecting Discord](/connecting-gaming-platforms/discord.md) for the Discord-side setup.

## Option 2 — Direct sign-in

1. Open **Account Settings → Connections** on RivalRyze.
2. Find **Xbox** and click **Connect**.
3. You'll be redirected to Microsoft's official sign-in page. Sign in with your Microsoft account (the one tied to your gamertag).
4. Approve the connection. You'll be sent back to RivalRyze.
5. Your initial sync starts immediately.

## Make your Xbox profile shareable

Xbox sync depends on your privacy settings.

1. Go to [account.xbox.com/Settings](https://account.xbox.com/Settings) (or **Settings → Account → Privacy & online safety → Xbox privacy** on your console).
2. Under **You can see and upload community-created content**, allow it.
3. Under **Others can see your game and app history**, set to **Everyone**.

Without these, your game library and achievements won't sync.

## What gets synced

* **Game library** — every Xbox game tied to your gamertag.
* **Achievements** — unlock status and gamerscore for each.
* **Total gamerscore** — your cumulative score.
* **Completion percentage** — for games with achievements.

## How often does it sync?

| Tier      | Xbox sync frequency |
| --------- | ------------------- |
| Free      | Every 4 hours       |
| Supporter | Every hour          |
| Pro       | Every 30 minutes    |

You can also trigger an **on-demand sync** from your profile any time.

## What Contests can I join with Xbox?

All achievement and completion-based Objective Modes are supported on Xbox:

**Battles** (leaderboard):

* Achievement Points
* Completion Achievement Points

**Bounties** (objective):

* Achievement Hunter
* Completion Hunter

See [Objective Modes](/contests/objective-modes.md).

## Disconnecting Xbox

Unlink from **Account Settings → Connections**. Active Xbox-based Contests will remove you.

If you linked via Discord and want to disconnect at the Discord layer, open Discord → **User Settings → Connections** → remove the Xbox connection.

## Troubleshooting

### "Game history isn't visible"

Update your Xbox privacy settings as described above, then trigger an on-demand sync.

### An achievement isn't appearing

* Make sure it's actually unlocked on Xbox Live (check your achievement page on xbox.com).
* Trigger an on-demand sync.
* Microsoft sometimes delays the achievement appearing on their API. Wait a few minutes and try again.

### "User does not have an Xbox connection" (when using Connect via Discord)

In Discord, open **User Settings → Connections**, verify Xbox is listed and **"Display on profile"** is toggled **ON**. Then retry on RivalRyze.

## Related

* [Connecting Discord](/connecting-gaming-platforms/discord.md) — the quick-link path
* [Troubleshooting Sync Issues](/connecting-gaming-platforms/troubleshooting-sync.md)
* [Fair Play](/fair-play/auto-pop-and-fair-play.md)