Template:Item link/doc

This subpage provides documentation for Template:Item link.

This template uses the following modules:

• Module:Item link

Shortcut

• {{il}}

Query based item link. Use this to link items from Template:Item

Overview

Creates a link to an item page that has the item information entered by Template:Item and includes the item info box on hover on the link.

Pages with broken item links with be added to the maintenance category Category:Pages with broken item links.

Parameters

Item selection

One of these is required. Do not specify more than one.

Parameter	Value	Description
metadata_id	str	Metadata ID of the item to search for
page	str	Name of the wiki page on which the item data resides
item_name	str	Name of the item to search for. The search query will also extend to aliases of the item (e.g., legacy names). The search may fail if there are multiple items with the given name. In that case, use a different item selection parameter, such as page.
item_name_exact	str	Exact name of the item to search for. The search may fail if there are multiple items with the given name. In that case, use a different item selection parameter, such as page.

Output overrides

All of these are optional and can be used to customize the item link.

Parameter	Value	Description
name	str	This parameter can be used to specify different link text than the item name. This should be used mainly for grammatical purposes. If the link text is significantly different than the item name, consider using a normal wikilink instead of this template. An empty value can be specified to avoid displaying a text link entirely; the link will consist of only the item icon.
large	boolean	If set to true, instead of the small icon in front of the name, a large inventory icon will be shown below the item (suitable for tables).
image	str or int	This can be used to link against an alternate art version of an item. Depending on which type is supplied: int: choose the alternate art based on the index (i.e. 1 for the first alternate art, 2 for the second, etc) str: choose the alternate based on the string given (i.e. "race season 1" would search for File:<itemname> race season 1 inventory icon.png and use it as image)
html	str	HTML to use for the itembox. May also be used to hide the item box entirely.
inventory_icon	str	File to use for the inline icon link.
skip_query	boolean	Skip querying for the item.
link	str	Which page to link to. This parameter can only be used if skip_query=true.

Errors

No pages found

When the search parameters can't find any items for the given parameter, a red error box will be shown. It can be caused by updates to the game that change the name of items, so links to the old name can no longer find the item with the new name.

The solution is to either use a different search parameter or making sure the parameter is correct.

Example:

Broken: {{Item link|item_name_exact=Pierce}}

Fixed: {{Item link|item_name_exact=Pierce Support}} Pierce SupportPierce SupportSupport, Projectile
Icon: p
Level: (1-20)
Cost & Reservation Multiplier: 120%Requires Level 4Supports projectile skills.Projectiles from Supported Skills Pierce (2-4) additional Targets
Supported Skills deal (0-19)% more Projectile Damage

Additional Effects From 1-20% Quality:
Supported Skills deal (0.5-10)% increased Projectile DamageThis is a Support Gem. It does not grant a bonus to your character, but to skills in sockets connected to it. Place into an item socket connected to a socket containing the Skill Gem you wish to augment. Right click to remove from a socket.

In rare cases, it's also possible it's caused by Database problems causing data to not be written on the target page. In those cases, null editing the target page should help. See Path of Exile Wiki:Known issues for more information.

Too many results found

When the search parameters find to many items, a red error box will be shown because the script doesn't know which one is the desired result. It is generally caused by items that share the same name, but have their own page such as variants of an unique item for example.

The solution is to use the page parameter to point to the page of the desired item.

Example:

Broken: {{Item link|item_name_exact=Two-Stone Ring}}

Fixed: {{Item link|page=Two-Stone Ring (ruby and topaz)}} Two-Stone RingTwo-Stone RingRequires Level 20+(12-16)% to Fire and Lightning Resistances

In rare cases, it's also possible it's caused by Database problems causing duplicate data on the target page. In those cases, null editing the target page should help. See Path of Exile Wiki:Known issues for more information.

Note

In some case, fixing the error requires to pipe the name to reflect the original wording and context such as in the patch notes section:

Broken: {{Item link|Projectiles Weakness }}

Fixed: {{Item link|Sniper's Mark|Projectiles Weakness}} Projectiles WeaknessSniper's MarkSpell, Curse, Mark
Level: (1-20)
Cost: (16-33) Mana
Cast Time: 0.50 secRequires Level 4Curses a single enemy, increasing the damage they take from projectiles, and making projectiles split when hitting them, to hit other targets around them. You can only have one Mark at a time.Cursed enemies take (10-29)% increased Damage from Projectile Hits
Projectiles which Hit Cursed Enemies Split towards 2 additional targets

Additional Effects From 1-20% Quality:
Cursed enemies take (0.25-5)% increased Damage from Projectile HitsPlace into an item socket of the right colour to gain this skill. Right click to remove from a socket.

Examples

Basic Usage

{{Item link
|page=Two-Stone Ring (ruby and topaz)
}}

Yields:

Two-Stone RingTwo-Stone RingRequires Level 20+(12-16)% to Fire and Lightning Resistances

{{Item link
|item_name=Pierce Support
}}

Yields:

Pierce SupportPierce SupportSupport, Projectile
Icon: p
Level: (1-20)
Cost & Reservation Multiplier: 120%Requires Level 4Supports projectile skills.Projectiles from Supported Skills Pierce (2-4) additional Targets
Supported Skills deal (0-19)% more Projectile Damage

Additional Effects From 1-20% Quality:
Supported Skills deal (0.5-10)% increased Projectile DamageThis is a Support Gem. It does not grant a bonus to your character, but to skills in sockets connected to it. Place into an item socket connected to a socket containing the Skill Gem you wish to augment. Right click to remove from a socket.

Large icons

{{Item link
|item_name=Pierce Support
|large=yes
}}

Yields:

Pierce SupportPierce SupportSupport, Projectile
Icon: p
Level: (1-20)
Cost & Reservation Multiplier: 120%Requires Level 4Supports projectile skills.Projectiles from Supported Skills Pierce (2-4) additional Targets
Supported Skills deal (0-19)% more Projectile Damage

Additional Effects From 1-20% Quality:
Supported Skills deal (0.5-10)% increased Projectile DamageThis is a Support Gem. It does not grant a bonus to your character, but to skills in sockets connected to it. Place into an item socket connected to a socket containing the Skill Gem you wish to augment. Right click to remove from a socket.