Skip to content
github-actions[bot] edited this page Oct 14, 2026 · 6 revisions

wow-pvp-history

A World of Warcraft addon that remembers your PvP matches. Arenas, Solo Shuffle, battlegrounds, Blitz, duels and World PvP are all saved, along with everyone who played in them, so you can look back at how a match went, how your rating moved, and who you've played with and against.

The game doesn't keep this for you: the scoreboard disappears when you leave the match. The addon saves your history in the game's own addon files on your computer, and there's nothing else to install or sign up for.

These pages describe version 0.68.22. Each version, with what it changed and its download, is listed on the releases page, newest first.

Getting started

New to the addon? Getting started goes step by step from installing it to your first saved match. In short:

  1. Install it from the releases page: download the zip under the newest release, close the game, and unzip it into the _retail_\Interface\AddOns folder inside your World of Warcraft folder, so that a WowPvpHistory folder sits there. Or install it through the CurseForge app from its CurseForge page or the Wago app from its Wago page, which keep it up to date.
  2. Log in. The addon starts recording on its own, with nothing to set up.
  3. Play a match, then open your history with any of these:
    • type /pvph
    • click the minimap button
    • pick it from the addon menu beside the minimap
    • set a key for Open the match history under Key Bindings, in the AddOns section, under PvP History

Using it

Page What it covers
Getting started Installing it, checking it loaded, and your first match, step by step
Questions Short answers to what people ask most
Match history window The main window: your matches, searching them, a window of its own for each one you open, and the recent results bar
Summary and rating graph Your win rate, rating, and the graph, and choosing a time range
Solo Shuffle Round by round: who was with you, who won, and fixing a missing result
Compositions Which teams you struggle against
Specs Every spec you've met in Solo Shuffle, on your team and against you
Ask Five questions about your history, answered from what you have played
Players and notes Everyone you've played with, and your notes and ratings on them
Alerts Being told when you meet someone you've played before, your notes on tooltips and in the group finder, and the minimap button
Duels and unfinished matches Duels, and matches you left early
World PvP Your kills and deaths in the open world with War Mode on
Settings and storage Settings, backups, moving your history, and starting over
Commands Every /pvph command
Words used here What the words on these pages mean, such as MMR, comp and spec

When something's wrong

Page What it covers
Troubleshooting Common problems and how to fix them
What it cannot record Things the game doesn't let any addon see
Debug log The addon's own log, for reporting a problem

For developers

Page What it covers
For developers Commands for working on the addon or testing it

Clone this wiki locally