LibItemDB — Offline Item Database for WoW
LibItemDB is a lightweight library that lets any addon look up World of Warcraft items offline — resolve an item's name to its link or id (and back), and filter by type and subtype — without the item being in the game's cache.
WoW ships no searchable item table and no “find item by name” API. LibItemDB solves that by shipping a pre-built database captured from a full client item scan, so players never wait for a scan and addon authors get instant, reliable lookups.
This is a developer library. Install it if another addon lists it as a dependency, or depend on it if you are an addon author.
What it can do
- Resolve a name to a full, clickable item link — even for items you've never seen
- Resolve a name to an item id, or an id to name / quality / type / subtype / equip slot
- Search by name substring, filtered by item type (class) and subtype (subclass)
- Enumerate the item types and subtypes present in the data
- Iterate the entire database
For addon authors
local DB = LibStub("LibItemDB-1.0", true)
if DB and DB:IsReady() then
local link = DB:GetLink(19019) -- coloured, interactive Thunderfury link
local id = DB:GetID("Black Lotus") -- 13468
for _, r in ipairs(DB:Search({ query = "lotus" })) do print(r.link) end
end
Key methods: IsReady, Count, GetMeta, GetName, GetInfo, GetQuality, GetLink, HasItem, GetID, GetClasses, GetSubClasses, Search, Iterate.
Data coverage
Item names are localized and item sets differ between game versions, so data is shipped per game version and per language. LibItemDB is available for every version except Retail.
- WoW Classic (Era / Hardcore / Anniversary) — English — 24,000+ items
More versions and locales are added as they are captured.
Requirements
- Ace3 and VersionCheck-1.0 — auto-installed by CurseForge (they back the optional guild version-check)
Recent Updates
v0.0.1 (2026-05-30) — Initial release
- First release of LibItemDB — offline item lookups (name ↔ id ↔ link, type / subtype filtering) exposed as a LibStub library for addon authors.
- WoW Classic (Era) English data — 24,000+ items.
- Available for every version except Retail.
Support
Questions, bug reports, or coverage requests — reach out on Discord.