Skip to content

TheWoWDB · Free website tooltips

A little Azeroth.
On your site.

WoW tooltips with auction prices.

Give an item link its stats, Alliance and Horde buyouts, and the time each price was scanned. Your readers get the details without leaving your guide.

Get the embed code

Free for guild sites, blogs and forums. No account or API key.

Advertisement

Try the links

Hover a link, focus it with Tab, or tap. Tap again to open the item.

Linen ClothWoW Forever · faction buyoutsLionheart HelmWoW Forever · item statsFireballWoW Forever · spell detailsLinen ClothRetail · all-region average

Also works with quests, NPCs and sounds.

Inside the tooltipLive data

Know what the price means

WoW Forever
Separate lowest buyouts for Alliance and Horde, with the realm and each quote’s UTC scan time.
Retail
An average of the lowest buyout in each connected realm group, across all available regions. Regional commodity prices apply to each group.
Freshness
Prices come from the last available scan. Missing data stays unavailable; the timestamp tells you how recent a quote is.

The installation guide

One script. Your existing links.

You need access to your site’s HTML or a place that accepts custom JavaScript. The tooltip’s styles are isolated from your site’s styles.

Add the loader once

Paste this just before </body> in your page or shared site layout. A shared footer makes it available on every page. It loads asynchronously.

Tooltip loader
<script src="https://thewowdb.com/embed/tooltips.js" async></script>

Already using it? Keep one copy per page. This stable URL receives future loader fixes.

Link the right game version

Copy an item, spell, quest or NPC URL from TheWoWDB and use it as an ordinary link. The loader recognizes it automatically. /wow-forever/ selects Forever; /item/ selects Retail.

WoW Forever item link
<a href="https://thewowdb.com/wow-forever/item/linen-cloth-2589/">Linen Cloth</a>
Retail item link
<a href="https://thewowdb.com/item/linen-cloth-2589/">Linen Cloth</a>

No special class or attribute is needed for a TheWoWDB link.

Save, publish and try a link

Open the saved page in your browser, then hover the item link. Keyboard readers can use Tab; on touch screens, the first tap shows the tooltip and the second follows the link.

Try it on the actual page. Some editors don’t execute scripts inside their preview.

Find the right place to paste

Make it part of your site

HTML

HTML & site builders

Use your builder’s custom-code or footer-script area, or paste the loader into your shared HTML layout before </body>.

In a JavaScript app, load it once in the application shell. Links added later are recognized automatically, including posts loaded without a full page refresh.

WP

WordPress

For site-wide use, add the loader with your theme’s custom-code feature or a header/footer script tool. For one page, use a Custom HTML block that permits JavaScript.

WordPress may remove scripts when your role or site settings don’t permit them. Ask your site administrator to install the loader; then add item links in the normal editor.

WordPress Custom HTML documentation ↗
FORUM

Discourse

Put the loader in a theme component’s common/body_tag.html, or its equivalent </body> custom HTML field. Attach the component to your active theme.

Members can then paste TheWoWDB links into their posts. Posts loaded later also work. Installing the component requires theme administration access.

Discourse theme structure documentation ↗

A few useful variations

More than an ordinary link

Add a tooltip to text

Use data-thewowdb with version:kind:id. Add tabindex="0" so keyboard readers can focus it. forever:item:12640 selects the Forever item; item:12640 defaults to Retail.

Tooltip on text
<span tabindex="0" data-thewowdb="forever:item:12640">Lionheart Helm</span>
Try Lionheart Helm here

Embed a card that stays visible

An iframe displays the same card without a loader script on the host page. Use it where your platform permits iframes. Adjust the height for longer items.

Always-visible item card
<iframe src="https://thewowdb.com/embed/card/forever/item/2589"
  width="280" height="280" loading="lazy"
  style="border:0;max-width:100%"
  title="Linen Cloth auction prices from TheWoWDB"></iframe>

URL format: /embed/card/version/kind/id. Use forever or retail for the version.

Turn off tooltips for one link or section

Put data-thewowdb="off" on the link or any enclosing element.

Opt-out attribute
<div data-thewowdb="off">
  <!-- Links in this block keep their normal behavior. -->
</div>
Pin a specific loader version

Use this instead of the stable loader if you want to control when its code updates. Auction data still comes from the current API; pinning the loader does not freeze prices.

Version-pinned loader
<script src="https://thewowdb.com/assets/embed/thewowdb-tooltips.js?v=20261031news1" async></script>

If something doesn’t appear

Check these first

The link opens, but no tooltip appears

Check that the saved page contains the loader, the link points to a supported TheWoWDB page, and no parent has data-thewowdb="off". Test the published page, then look for a blocked script or request in your browser’s console. Editors can strip scripts when saving.

My site blocks third-party scripts or frames

Ask your administrator to permit the loader and tooltip requests in the site’s existing Content Security Policy. Script and API requests use https://thewowdb.com; item images can also come from https://render.worldofwarcraft.com. Iframe cards need the TheWoWDB origin allowed in frame-src.

Strict style policies can also block the hover card’s embedded stylesheet. An iframe may fit your policy better. Keep your site’s security policy in place.

MDN guide to Content Security Policy ↗
An item has no auction price, or an older timestamp

The card needs an available auction scan for that item and market. An unlisted item or missing scan can have no quote. The timestamp is the source scan time, not the time you opened the page. It is shown in UTC so readers in different time zones see the same reference.

Free, with attribution. Commercial and community sites can use these tooltips. Keep the card’s TheWoWDB link.

Tooltip API requests omit cookies and identify the requested entity and game version. The service receives normal request metadata. Tooltip data is requested when a reader hovers, focuses or taps; the always-visible iframe demos load when displayed.

Building an integration or fetching data in bulk? Use the public API. TheWoWDB is a fan site, unaffiliated with Blizzard Entertainment.