FANDOM


Using this template on an article page creates a formatted information box in the upper right-hand corner of that page. It is also called by {{item}} and {{loot}} to display that information box as a tooltip. You can supply any number of the optional parameters to display specific text in the tooltip.

Tooltips for other purposes can be created using the templates {{abilitytip}}, {{effecttip}}, {{settip}}, {{achievementbox}}, and {{proftip}}. The development version of this template can be found at {{Tooltip/Dev}}

Examples

A link to an item

Inv sword 48 [Ashbringer]

The item
Inv sword 48
  • Ashbringer
  • Item Level 76
    Disenchants into:
    Not disenchantable
  • Requires level 60
  • Chance on hit: Blasts a target for 700 Fire damage.
  • "Blade of the Scarlet Highlord"
  • Icon-3D-48x48

Required Minimum Syntax

The following parameters are required for every tooltip template, and the entire block should always be the first thing on an article page. However, without any further parameters, only an empty box will display:

<onlyinclude>{{{{{tpl|tooltip}}}
|mode={{{mode|}}}
|arg={{{arg|}}}
}}</onlyinclude>

Item and Loot

For {{item}} and {{loot}} to work, the following minimum parameters are required:

<onlyinclude>{{{{{tpl|tooltip}}}
|mode={{{mode|}}}
|arg={{{arg|}}}
|name=<item_name>
|quality=<quality_value>
|bind=<bind_value>
}}</onlyinclude>

DE

Use {{DE}} to automatically show a tooltip of disenchanting results when mousing over the Item Level number on the article page, the following are required:

<onlyinclude>{{{{{tpl|tooltip}}}
|mode={{mode|}}}
|arg={{{arg|}}}
|name=<item_name>
|quality=<quality_value>
|slot=<slot_value>
|ilvl=<item_ilvl>
}}</onlyinclude>

Named parameters

This is the full list of named parameters listed in order that they appear in the displayed/in-game tooltip. Parameters that apply color to text in the finished tooltip have the same color here.

|icon=
icon to display. omit Image:/File: and extension (.png). Uses {{icon}}.
Example: |icon=INV Ingot Titansteel red
|stack=
stack size for stackable items. Uses {{icon}}.
|name=
item name as it appears in-game.
|disambigpage=
name of WoWWiki page for this item, if different from |name=.
Example: |disambigpage=Atiesh, Greatstaff of the Guardian (Mage)
|quality=
item quality, passed to {{quality}} to generate formatted item name.
|heroic=
if the item is Heroic. Can be used in combination with |elite=1.
Example: |heroic=1
|elite=
if the item is Elite. Can be used in combination with |heroic=1.
Example: |elite=1
|mythic=
if the item is Mythic. Can be used in combination with |warforged=1.
Example: |mythic=1
|timewarped=
if the item is Timewarped item. Can be used in combination with |warforged=1.
Example: |timewarped=1
|raidfinder=
if the item is Raid Finder.
Example: |raidfinder=1
|thunderforged=
if the item is Thunderforged.
Example: |thunderforged=1
|warforged=
if the item is Warforged. Can be used in combination with |baleful=1.
Example: |warforged=1
|baleful=
if the item is Baleful. Can be used in combination with |warforged=1.
Example: |baleful=1
|season=
if the item is from a specific Arena season.
Example: |season=9
|conjured=
conjured item.
Example: |conjured=1
|instancebind=
the zone that the item is bound to.
Example: |instancebind=Tempest Keep
|cooking=
shows Cooking Ingredient
Example: |cooking=
|crafting=
shows Crafting Ingredient
Example: |crafting=
|bind=
soul binding type. Options are 'BoE', 'BoU', 'BoP' or 'BtA'.
  • If 'BoP' and 'BtA', you can also optionally use |account=Account-wide for things like mounts.
|qitem=
quest item.
Example: |qitem=1
|unique=
unique items. Pass a number greater than 1 if required. If you want to use 1, use: &zwnj;1
Example: |unique=1 → Unique (1)
|unique-eq=
unique-equipped items. Same rules as |unique=. If you want to use 1, but have type appear, use: &zwnj;1
Example: |unique-eq=3 → Unique-Equipped (3)
Example: |unique-eq=1 → Unique-Equipped
|unique-type
Type of uniquely equipped item, such as Jeweler's Gems.
Example: |unique-type=Special Gem → Unique-Equipped: Special Gem
Example: |unique-eq=2|unique-type=Special Gem → Unique-Equipped: Special Gem (2)
|glyph=
glyph type: Major or Minor.
|duration=
duration this item persists for (time-limited items).
Example: |duration=2 Hours
|qbegin=
starts a quest. Provide WoWWiki's quest name, minus "Quest:".
Example: |qbegin=Ancient History
|slot=
equipment slot. ("Ranged", "Two-Hand", "Hands"...). See full list
|type=
armor/weapon type ("Axe", "Wand", "Cloth"...). See list
|speed=
weapon speed. Provide two decimal figures.
Example: |speed=4.56
|dmg=
basic weapon damage. Provide a range.
Example: |dmg=4 - 17
|dmgtype=
basic weapon damage school. Omit if physical.
Example: |dmgtype=Nature
|dps=
weapon dps. Provide one decimal. (FAP will be displayed automatically)
Example: |dps=186.4
|bonus=
bonus weapon damage. Provide a range if present ("13 - 17").
|bonustype=
bonus weapon damage school. Omit if physical.
|armor=
armor provided by the item.
|bonusarmor=
the bonus armor above and beyond normal for its item level
|block=
block value on a shield.
|attrib=
basic attributes. Split with <br /> tags, not line breaks.
Example: |attrib=+6 Stamina<br />+3 Intellect
|bonusattrib=
bonus attributes. Unclear what makes them "bonus", but they appear bright green
|req=
profession specialization required to use the item.
Example: |req=Gnomish Engineering
|relics=
item's artifact relic slots. Split with <br /> tags, not line breaks.
Example: |relics={{RelicSlot|Arcane}}<br />{{RelicSlot|Blood}}
|sockets=
item's sockets. Split with <br /> tags, not line breaks.
Example: |sockets={{socket|Blue}}<br />{{socket|Red}}
|sockbonus=
socket bonus for matching gem colors to socket colors.
Example: |sockbonus=+9 Spell Power
|durability=
item's durability. Provide the maximum, not the fraction.
Example: |durability=75
|locked=
lockpicking skill required to open or blank if item is just locked
Example: |locked=300
|bag=
if a bag, number of slots.
Example: |bag=16
|bagtype= (avoid in favour of |type=)
Full name of the bag type (i.e. "Soul Bag", "Enchanting Bag", ...).
If this bag is a quiver, ammo pouch, or the bag type ends in " Bag", use |type= instead.
|classes=
classes the item is usable by. Split with commas.
Example: |classes=Rogue, Mage, Priest
|rfaction=
faction name required to use this item. See also |rep=.
Example: |rfaction=Honor Hold
|rfactionlabel=
faction label if |rfaction= used. See also |rep=.
Example: |rfaction=Emperor Shaohao (faction) and |rfactionlabel=Emperor Shaohao
|rfactions=
if multiple factions required to use this item (overrides |rfaction=).
Example: |rfactions= (need example)
|rep=
faction reputation level required to use this item. See also |rfaction=.
Example: |rep=Exalted
|level=
character level required to use this item.
Example: |level=80
|ilvl=
item level.
Example: |ilvl=258
|upgradelevel=
upgrade level (usually only 0/1, 1/1, 0/2, 1/2 or 2/2).
Example: |upgradelevel=0/2
|hupgradelevel=
Heirloom upgrade level (usually only 0/2, 1/2 or 2/2).
Example: |hupgradelevel=0/2
|skill=
profession skill required to use item.
Example: |skill=Leatherworking (250)
|event=
event required to use item.
Example: |event=Hallow's End
|races=
races the item is usable by. Split with commas.
Example: |races=Gnome, Dwarf
Use |races=Alliance
for all Alliance 15 races: Human, Dwarf, Night Elf, Gnome, Draenei, Worgen
Use |races=Horde
for all Horde 15 races: Orc, Undead, Tauren, Troll, Blood Elf, Goblin
|rating=
personal and team arena rating required to buy the item.
Example: |rating=2250
|effect=
all of the green "Equip"/"Use" lines. Split with <br /> tags, not line breaks.
|create=
name of the item this item creates, or teaches the user to create.
Example: |create=Heavy Frostweave Bandage
|createq=
item quality of the item in the |create= line.
Example: |createq=Common
|createpage=
name of the page the created item is on, if different than the item name.
|mats=
materials to make the |create= item. Split with <br /> tags, not line breaks.
Example: |mats={{loot|common|Frostweave Cloth}} x2
|set=
the armor set this item belongs to.
|setpc=
number of items in the item's armor set.
|setpage=
set's WoWWiki page name, if different from the displayed set name.
|charges=
maximum number of times this item can be used.
Example: |charges=10
|flavor=
item's flavor text, without quotes.
Example: |flavor=Blade of the Highlord
|read=
display "<Right Click to Read>".
Example: |read=1
|open=
display "<Right Click to Open>".
Example: |open=1
|cooldown=
cooldown on the use effect of this item.
|cast=
cast time of the use effect of this item.
|vendor=
buy this item from a vendor. Use {{cost}}/{{costitem}}
Example: |vendor={{cost|123|45|67}}
|sell=
sell this item to a vendor and get gold. Use {{cost}}
Example: |sell={{cost|30|86|42}}
|id=
item id from DB to show Wowhead 3D model viewer button
Example: |id=1234
|objectid=
object id from DB to show Wowhead 3D model viewer button
Example: |objectid=1234
|subdomain=
if using id= specify alternate subdomain for Wowhead 3D model viewer link
Example: |subdomain=mop (for Mists-Logo-Small)

Display modes

Passing |mode= to the template (and, by extension to the item page syntax, any item page) affects how the template renders the tooltip. There are several valid mode values:

mode=home / mode=away
Displays the tooltip as if on its item page (home) or not on its item page (away). If mode is omitted, the appropriate one of those is chosen by default.
mode=link / mode=imlink
Return an item link (link) or an item link with an image (imlink) instead of the tooltip.
mode=arg (in combination with |arg=)
Returns the value of the arg parameter defined in the tooltip of that page, or "--" if it is not defined.

"type" and "slot" values

List of values that appear in tooltips.

type
Arrow, Axe, Bag, Bow, Bullet, Cloth, Crossbow, Dagger, Enchanting Bag, Engineering Bag, Fishing Pole, Fist Weapon, Gem Bag, Gun, Herb Bag, Idol, Leather, Leatherworking Bag, Libram, Mace, Mail, Mining Bag, Plate, Polearm, Shield, Sigil, Soul Bag, Staff, Sword, Thrown, Totem, Wand.
slot
Back, Chest, Feet, Finger, Hands, Head, Held in off-hand, Legs, Main Hand, Neck, Off Hand, One-Hand, Projectile, Ranged, Relic, Shirt, Shoulder, Tabard, Thrown, Trinket, Two-Hand, Waist, Wrist.
Community content is available under CC-BY-SA unless otherwise noted.