Repository navigation
Getting Started
This page takes you from nothing to your first saved match. It takes about five minutes, plus one match.
- Close the game.
- On the releases page, download the zip under the newest release.
- Open your World of Warcraft folder, then
_retail_, thenInterface, thenAddOns. - Unzip the download into
AddOns. The zip holds one folder,WowPvpHistory.
Or install it through the CurseForge app from its CurseForge page, or through the Wago app from its Wago page. Both carry the same zip and keep the addon up to date.
Check the folder before you start the game. You should now have
_retail_\Interface\AddOns\WowPvpHistory, and inside it a file called WowPvpHistory.toc. If that file
is one folder deeper, such as AddOns\WowPvpHistory-0.68.21\WowPvpHistory, move the inner
WowPvpHistory folder up into AddOns. The game only looks one folder down.
On the character select screen, click AddOns. WoW PvP History should be in the list with its box ticked. If it isn't there, go back to the check in step 1.
Log in. There's nothing to set up: the addon starts recording on its own. To be sure it loaded, type
/pvph status in chat. It answers with the version.
Any arena, Solo Shuffle, battleground, Blitz or duel counts. Play it to the end, because a match you leave early is saved with less in it.
When the match ends, the leave button is covered for a few seconds and reads Saving the match. That's
the addon reading the scoreboard. It turns to Saved and then lets go, and you can leave.
When you're back out of the instance:
- a line in chat says the match was recorded, with a link under it to open the match
- the match opens in its own window by itself
Type /pvph, or click the minimap button. This is the match history window.

What you're looking at:
- The format tabs: All, then one tab for each kind of match you've played.
- Your standing: your rating and win rate for the tab you're on.
- The search row: a search box and three dropdowns, for the spec, the result and the time range.
- The list: your matches, grouped by when you played them. Click a session to open it, then click a match to see everything about it.
- The tabs under the window: History, Players and Stats at the left, and About and Settings at the right.
- Write down what you thought of a player: Players and notes
- See your win rate and rating over time: Summary and rating graph
- Get told when you meet someone you've played before: Alerts
- Something doesn't look right: Troubleshooting
- A word on these pages you don't know: Words used here
These pages describe version 0.68.22 of the addon. Type /pvph status in game, or look at the
bottom right of the match history window, to see which version you have.
Using it
- Getting started
- Questions
- Match history window
- Summary and rating graph
- Solo Shuffle
- Compositions
- Specs
- Ask
- Players and notes
- Alerts
- Duels and unfinished matches
- World PvP
- Settings and storage
- Commands
- Words used here
When something's wrong
For developers