> 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)


---

# 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/xbox.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.