GitHub release (latest by date) Release GitHub issues License on GitHub Packaged by wap Hosted on Curseforge


ItemVersion adds information to your tooltip about when an item was added to World of Warcraft.

Useful for

  • Clearing your bags and bank of old stuff
  • Identifying loot from your transmog runs
  • Looking back on WoW history


  • A complete database of the version/expansion in which every item was added.
  • Where-you-need-it accessibility in the item tooltip.
  • Weekly updates with the latest items. A refreshed release will automatically occur (at least) every Tuesday at 16:00 UTC, just slightly after reset.
  • API exposed for use by other addons.
  • Open source visibility.


Just install the addon like normal and mouse over any item!

Demo of tooltip

Access the options screen with /itemversion.

Options screen


See the API page


  • Beginners are welcome. If you are new to programming, Git, Lua, or anything related to the project, then I can help you. Just ask.
  • No contribution is too small! Please submit as many fixes for typos and grammar bloopers as you can.
  • Don't be afraid to open half-finished PRs, and ask questions if something is unclear!
  • Pull requests should be made on their own separate branches.
  • Try to limit each pull request to one idea only.
  • Please document how you tested your changes in your pull request.
  • Make sure your changes pass the status checks.
  • If you would like, please add your name to the AUTHORS.md file. Pseudonyms are fine.

See the Contributing document for more information.

Translators Needed

If you know another language and want to help translate ItemVersion, please check this out.

Translations are living things. If you see an improvement to make, don't hesitate to bring it up.


  • An item has the wrong version.

    First, verify it on wowhead.com.

    Note that, in some cases, items are added towards the end of an expansion that actually used in the next expansion, making them appear to have too early of a version. For example, Marrowroot, a herb used in Shadowlands, was actually added to the game during the previous expansion, Battle for Azeroth. And, ItemVersion will display Battle for Azeroth because it is canonically correct.

    However, to instead display the expansion that players probably expect in these cases, turn on the "Include community updates" option on the options screen. Then, the Marrowroot example would display Shadowlands.

    (These community updates are an ongoing effort. If you have discovered an item that feels like its in the wrong expansion, please lend a hand and create an issue on the GitHub project page.

  • An item still has the wrong version or An item is missing or I found a bug or I want to request a feature.

    Create an issue on the GitHub project page.

    Pull requests are also warmly welcome!


Copyright 2022 Tim Martin

Licensed under the GPLv3: https://www.gnu.org/licenses/gpl-3.0.en.html