> 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 with Blizzard's own sign-in.

## Connect Battle.net

1. Open **Settings** and pick the **Connections** tab.
2. Under **Connect through authentication directly**, click **Connect** on the **Battle.net** row.
3. Blizzard's sign-in page opens. Sign in, review the access RivalRyze asks for, and approve it.
4. You're sent back to the page you started from and see **Battle.net account connected successfully**.

RivalRyze never sees your Battle.net password.

## What Battle.net adds

* Your **BattleTag** appears in the **Platforms** list on your profile.
* It counts as a connected gaming account, for example for the onboarding steps.

## Disconnecting Battle.net

Click **Disconnect** on the Battle.net row in **Settings → Connections**. You see **Battle.net account disconnected successfully**.

Disconnecting deletes the Battle.net data RivalRyze stored (your account ID, BattleTag and access token). Linking a different Battle.net account works the same way: the previous account's data is deleted.

## Messages you may see

| Message                                                                           | What to do                                                                                                                 |
| --------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| **This Battle.net account is already linked to another RivalRyze account.**       | Sign in to that RivalRyze account and disconnect Battle.net there, or [contact support](/help-and-faq/contact-support.md). |
| **This Battle.net authorization is no longer valid. Start the connection again.** | The sign-in took too long or was already used. Click **Connect** again.                                                    |
| **Battle.net connections are briefly unavailable. Please try again in a moment.** | Wait a moment, then try again.                                                                                             |
| **We could not link your Battle.net account. Please try again.**                  | Try again. If it keeps failing, contact support.                                                                           |
| **Your Battle.net connection changed. Refresh the page and try again.**           | Your connection changed in another tab or window. Refresh the page.                                                        |
| **Failed to start Battle.net connection**                                         | RivalRyze couldn't open Blizzard's sign-in. Try again.                                                                     |
| **Battle.net authorization failed. Please try again.**                            | Something went wrong on Blizzard's page. Click **Connect** again.                                                          |

## Related

* [Troubleshooting Sync Issues](/connecting-gaming-platforms/troubleshooting-sync.md)
