Path of Exile Wiki

Please consider helping keep the wiki up to date. Check the to-do list of updates needed for version 3.14.0.

Game data exports will becoming later as the technical changes in addition to regular changes take some more time.

READ MORE

Path of Exile Wiki
Register
Advertisement
Template info icon Template documentation[view] [edit] [history] [purge]

Shortcut

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

Page selection

Page search

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

Parameter Value Description
metadata_id str Metadata Id of the item to link against
page str Name of the wiki page to link against
item_name str Name of the item to search for. This will search for alias of the same item (i.e. legacy names) and is case insenitive

This can pose a problem if there are multiple items with the same name (such as Two Stone Rings) - in that case use page instead.

item_name_exact str Exact name of the item to search for. Unlike item_name this is case sensitive and will only search for the current name of the item.

This can pose a problem if there are multiple items with the same name (such as Two Stone Rings) - in that case use page instead.

Filters

Parameter Value Description
link_type nil or skill nil - no restriction

skill - restricts the search to skill gems (i.e. for Template:Sl)

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 pages to link to, by default the item page.

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}} Module Error: Item link: No results found for search parameter "Pierce".

Fixed: {{Item link|item_name_exact=Pierce Support}} Pierce Support inventory iconPierce SupportPierce SupportSupport, Projectile
Icon: p
Level: (1-20)
Cost & Reservation Multiplier: 120%
Supports projectile skills.Per 1% Quality:1Superior2Anomalous3DivergentSupported Skills deal 0.5% increased Projectile DamageProjectiles from Supported Skills Pierce 0.1 additional TargetsProjectiles from Supported Skills that have Pierced deal 2% increased DamageProjectiles from Supported Skills Pierce (2-4) additional Targets
Supported Skills deal (0-19)% more Projectile Damage
This 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 Active Skill Gem you wish to augment. Right click to remove from a socket.
Pierce Support inventory icon

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}} Module Error: Item link: Too many results for search parameter "Two-Stone Ring". Consider using page parameter instead.

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

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 }} Module Error: Item link: No results found for search parameter "Projectiles Weakness".

Fixed: {{Item link|Sniper's Mark|Projectiles Weakness}} Sniper's Mark inventory iconProjectiles WeaknessSniper's MarkSpell, Duration, Curse, Mark
Level: (1-20)
Cost: (16-33) Mana
Cast Time: 0.50 sec
Requires Level 24Curses 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 gain charges for your life and mana flasks by hitting the cursed enemy. You can only have one Mark at a time.Per 1% Quality:1Superior2Anomalous3DivergentCursed enemies take 0.25% increased Damage from Projectile HitsCurse Skills have 1% increased Cast SpeedHits on Cursed Enemies have an additional 2% chance to KnockbackBase duration is (6-9.8) seconds
Projectiles which Hit Cursed Enemies Split towards (3-4) additional targets
Cursed enemies take (16-35)% increased Damage from Projectile Hits
You gain a Mana Flask Charge when you Hit Cursed Enemy, no more
than once every 0.5 seconds
You gain a Life Flask Charge when you Hit Cursed Enemy, no more
than once every 0.5 seconds
Place into an item socket of the right colour to gain this skill. Right click to remove from a socket.
Sniper's Mark skill icon
Sniper's Mark inventory icon

Examples

Basic Usage

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

Yields:

Two-Stone Ring (ruby and topaz) inventory iconTwo-Stone RingTwo-Stone RingRequires Level 20+(12-16)% to Fire and Lightning ResistancesTwo-Stone Ring (ruby and topaz) inventory icon

{{Item link
|item_name=Pierce Support
}}

Yields:

Pierce Support inventory iconPierce SupportPierce SupportSupport, Projectile
Icon: p
Level: (1-20)
Cost & Reservation Multiplier: 120%
Supports projectile skills.Per 1% Quality:1Superior2Anomalous3DivergentSupported Skills deal 0.5% increased Projectile DamageProjectiles from Supported Skills Pierce 0.1 additional TargetsProjectiles from Supported Skills that have Pierced deal 2% increased DamageProjectiles from Supported Skills Pierce (2-4) additional Targets
Supported Skills deal (0-19)% more Projectile Damage
This 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 Active Skill Gem you wish to augment. Right click to remove from a socket.
Pierce Support inventory icon

Large icons

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

Yields:

Pierce SupportPierce Support inventory iconPierce SupportSupport, Projectile
Icon: p
Level: (1-20)
Cost & Reservation Multiplier: 120%
Supports projectile skills.Per 1% Quality:1Superior2Anomalous3DivergentSupported Skills deal 0.5% increased Projectile DamageProjectiles from Supported Skills Pierce 0.1 additional TargetsProjectiles from Supported Skills that have Pierced deal 2% increased DamageProjectiles from Supported Skills Pierce (2-4) additional Targets
Supported Skills deal (0-19)% more Projectile Damage
This 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 Active Skill Gem you wish to augment. Right click to remove from a socket.
Pierce Support inventory icon

Advertisement