Uncommon Tooltips

Background

So, you run a World of Warcraft fansite. You probably link to Wowhead for items and battle pets. And you probably use Wowhead's Tooltips.

However, maybe you're not happy with Wowhead's tooltips. You don't want to rely on ZAM to keep their site performant, and to keep the data accurate. Maybe you don't like the ads on Wowhead. Or, you might prefer to use official Blizzard data sources. For whatever reason, you want to try a new tooltip library. Maybe one you can host yourself.

Another Option

Uncommon Tooltips was built as an alternative World of Warcraft tooltip library for the Web. It gets data directly from Blizzard's Battle.net API, so it's performant, accurate, and up-to-date. The tooltips are designed to match the in-game appearance as much as possible, even using all the official in-game labels direct from the source.

Drop-In Compatibility

If you'd like to try Uncommon Tooltips on your site, but you already use Wowhead tooltips, you won't have to rewrite every link. The Uncommon Tooltips library supports Wowhead's link formats, so all you'd need to do to switch is remove the Wowhead script tag, and insert the Uncommon Tooltips tag.

Installing on Your Site

Since Uncommon Tooltips uses the Battle.net API for data, you'll need to get an API key from them. Fortunately, it's easy and free to get one.

  1. Register for an Battle.net API account if you don't have one yet.
  2. Log in to the Battle.net API Developer Portal.
  3. Click the "Applications" tab.
  4. Click the "Create a New Application" link.
  5. Fill out the form and describe your website.
    • You can mention "Uncommon Tooltips" in the "Describe what your application will do" if you want.
    • You can leave the "Register Callback URL" field blank.
  6. Once your application is registered, find it under the "Keys" or "Applications" tabs.
  7. Copy the "Key" (NOT the "Secret") for your application to your clipboard. You'll use it to initialize the Uncommon Tooltips library.
  8. In your site code, paste this tag on your page:
    <script src="https://js.uncommon-tooltips.com/uncommon-tooltips.js" onload="uncommonTooltips='KEY';" async></script>
  9. Replace the KEY in the above tag with your key you copied in step 7.
  10. Make sure you remove Wowhead's "power.js" script tag if you're already using it.

That sounds like a lot of work.

It's certainly a lot easier to use Wowhead's tooltips on your website. If you're not comfortable with editing HTML and all the steps above, you should probably stick with Wowhead, it's pretty epic. Uncommon Tooltips is offered only as an alternative for those seeking something different.

Self-Hosting Option

We recommend that you link directly to the script, as in the above example, so your site will always get the latest data and functionality updates. However, if you're concerned about performance or privacy, you can host the script yourself.
  1. Download the main script file to save on your site.
  2. Also download the localization json for all the languages you're using:
    English German Spanish French Italian Portuguese Russian Korean
  3. When you include the script, you'll need to tell the script where your locale files are saved. If, for example, all the files are in your /tooltips/ path, it would look like:
    <script src="/tooltips/uncommon-tooltips.js" async></script> <script> uncommonTooltips = {     key: 'KEY',     localesPrefix: '/tooltips/', }; </script>
  4. Icon images are pulled from Blizzard's CDN. If you prefer to use a different icon location, use the same structure as above, but include:
    iconsPrefix: '/icons/',

Feature Comparison

Hover over any cell to see the output from each library.

Tag UsageUncommon
Tooltips
WowheadWowDB
Wowhead Link Format Yes Yes No
Wowhead Rel Format Yes Yes No
Wowhead Data Format Yes Yes No
WowDB Link Format Yes No Yes
WowDB Data Format No No Yes
Tooltip Disable Flag rel="nt" rel="np" data-disable-tip="true"
LanguageUncommon
Tooltips
WowheadWowDB
English Yes Yes Yes
German Yes Yes No
Spanish Yes Yes No
French Yes Yes No
Italian Yes Yes No
Portuguese Yes Yes No
Russian Yes Yes No
Korean Yes Yes No
Chinese No Yes No
PTR No Yes Yes
EntityUncommon
Tooltips
WowheadWowDB
Item Yes Yes Yes
Battle Pet Yes Yes Yes
Achievement Yes Yes Yes
Spell No Yes Yes
Quest No Yes Yes
Pet Ability No Yes Yes
Affix No Yes Yes
Currency No Yes Yes
NPC No Yes Yes
Item Set No Yes No
Object No Yes No
Zone No Yes No
Event No Yes No
Item SupportUncommon
Tooltips
WowheadWowDB
Descriptive Name Yes Yes Yes
Item Level (Weapons & Armor) Yes Yes
Upgrade Level No Yes Yes
Binds Yes Yes Yes
Binds to Battle.Net No Yes Yes
Begins a Quest No Yes Yes
Unique/Max Count Yes Yes Yes
Max Stack No Yes Yes
Unique-Equipped No Yes Yes
Conjured Tag No Yes Yes
Toy Tag Yes Yes Yes
Crafting Reagent Tag Yes Yes Yes
Mount Tag Yes Yes No
Mount Description No Yes No
Mount Source No Yes Yes
Bag Slots Yes Yes Yes
Inventory Slot/Type Yes Yes Yes
Gem Stats Yes Yes Yes
Relic Stats Some Yes Yes
Weapon Damage Yes Yes Yes
Weapon/Armor Stats Yes Yes Yes
Classic Random Enchants Yes Yes No
BC Random Enchants Yes Yes No
Random Enchants via Bonus Yes Yes Yes
Bonuses Yes Yes Yes
Scaling Bonuses Yes Yes No
Heirloom Scaling No Yes No
Enchants Yes Yes Yes
Socketed Gems Yes With Errors Can't Skip Slots
Socket Bonus Yes Not Lit Wrong
Socketed Relics Not really Yes Without Bonuses
Spell On Use Yes Yes Yes
Spell On Equip Mostly Yes Yes
Spell On Proc Mostly Yes Yes
Spell On Pickup Yes Yes Yes
Learn Spell Yes Yes Yes
Recipe Output No Yes Yes
Recipe Reagents No Yes No
Charges Yes Yes Yes
Item Set Pieces Yes Yes Yes
Durability Yes Yes No
Allowed Races Yes Yes Yes
Allowed Classes Yes Yes Yes
Required Level Yes Yes Yes
Required Skill Yes Yes Yes
Required Ability Yes Yes Yes
Required Faction Yes Yes Yes
Flavor Text Yes Yes Yes
Drop Info No Yes Dungeon Journal
Sell Price No Yes Yes

About the Author

Uncommon Tooltips was created by Erorus, a former Wowhead developer who's also behind The Undermine Journal, Realm Pop, WoW Token Info, and Does the API Work. You can view most of his projects on everynothing.net.

Uncommon Tooltips was made primarily to support The Undermine Journal, but it's also a neat experiment to see how far the Battle.net API can go.

You can check out the source code on Github.

Getting Support

If you have any questions, feature requests, or bug reports for this project, you are welcome to submit them to the project's issues on Github.
World of Warcraft, Warcraft, Battle.net and Blizzard Entertainment are trademarks or registered trademarks of Blizzard Entertainment, Inc. in the U.S. and/or other countries.