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

# Battle.net

Link your Battle.net account to track progress across Blizzard's games — including **Overwatch**, **Diablo**, **World of Warcraft**, and **Hearthstone**.

## What gets synced

* **Game library** — every Blizzard game tied to your Battle.net account.
* **Account-level data** — your BattleTag and linked profiles.
* **Overwatch** — competitive rank and stats.
* **Diablo** — character progression and seasonal data.

Depth of data varies by game depending on what Blizzard's API exposes.

## How to connect

1. Open **Account Settings → Connections**.
2. Find **Battle.net** and click **Connect**.
3. You'll be redirected to Battle.net's official sign-in page. Sign in.
4. Approve the connection. You'll be sent back to RivalRyze.
5. Initial sync runs immediately.

{% hint style="info" %}
Battle.net sign-in covers all your linked Blizzard games at once.
{% endhint %}

## How often does it sync?

Battle.net data is **synced on demand**, plus a daily background refresh. Trigger a sync from your profile whenever you want the most recent data — for example, right after a competitive Overwatch session.

This applies on all tiers.

## What Battles can I join with Battle.net?

Battles that focus on the games Battle.net covers — competitive rank challenges, win-streak races, seasonal progression battles. The exact mix depends on what's currently available; check the Battles browse page filtered by Battle.net.

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

## Disconnecting Battle.net

Unlink from **Account Settings → Connections**. You'll be removed from any active Battle.net-based Battles.

## Troubleshooting

**"No characters found."** Make sure your Battle.net account has actively played at least one supported game in the current season. Blizzard's API often doesn't return data for inactive accounts.

**Overwatch rank isn't updating.**

* Trigger an on-demand sync.
* Blizzard's competitive stats can take up to an hour to propagate after a game ends. If you've waited and it's still not updated, contact [support](/readme.md).

**Region issues.** Battle.net data is region-specific. RivalRyze pulls from the region your account is registered in. If you play across regions, only the registered region is tracked.


---

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