Template:Wares

Purpose

Lists items sold by Merchants and Shops.

Usage

Simplified SyntaxExtended SyntaxMultiple Prices (Simplified Syntax)Multiple Prices (Extended Syntax)

{{Wares
|game= 
|-
| <item>
| <price>
| <description>
|-
| <item>
| <price>
| <description>
|- 
| <item>
| <price>
| <description>
}}

{{Wares
|game= 
|showQuantityColumn=
|collapse= 
|-
|{{Wares/Item
 |item= 
 |price= 
 |display= 
 |quantity= 
 |stock= 
 |restocks= 
 |description= 
 }}
|-
|{{Wares/Item
 |item= 
 |price= 
 |display= 
 |quantity= 
 |stock= 
 |restocks= 
 |description= 
 }}
}}

{{Wares|game= |prices= <priceName1>, <priceName2>
|-
| <item>
| <price1>
| <price2>
| <description>
|-
| <item>
| <price1>
| <price2>
| <description>
|- 
| <item>
| <price1>
| <price2>
| <description>
}}

{{Wares|game= |prices= <priceName1>, <priceName2>
|-
|{{Wares/Item
 |item= 
 |price1= 
 |price2= 
 |display= 
 |quantity= 
 |restocks= 
 |stock= 
 |description= 
 }}
|-
|{{Wares/Item
 |item= 
 |price1= 
 |price2= 
 |display= 
 |quantity= 
 |stock= 
 |restocks= 
 |description= 
 }}
|-
|{{Wares/Item
 |item= 
 |price1= 
 |price2= 
 |display= 
 |quantity= 
 |stock= 
 |restocks= 
 |description= 
 }}
}}

Parameter	Required?	Description
game	Required	A game code.
showQuantityColumn	Optional	Set to true to display a Quantity column in the price table. Usually not required as quantity values are normally shown in the item's displayed name (see #Display Format below).
prices	Optional	A comma-separated list of price names to display as columns in the price table.
collapse	Optional	If set to true, the table is collapsed such that only a small preview of the data is shown, with a "show more" button that reveals the full table when clicked. This functionality depends on MediaWiki:Gadget-Collapse.js.
fileType	Optional	The type of files to show. Defaults to Sprite for 2D games, Model for most 3D games, and Icon for Breath of the Wild, Tears of the Kingdom, Age of Calamity, and Age of Imprisonment.
1 to N (items)	Required	A tuple of 1-arity to N+2-arity where N is the number of prices listed. For 1-arity, each item is defined using the extended syntax of {{Wares/Item}}, which allows more information about the items to be specified. For a single price with simple syntax, the tuple is 2- or 3-arity: The item for sale written in the format quantity item-name, where quantity is a number and item-name is singular and refers to a page on the wiki. Omit quantity for items sold as singles. The item's price written in the format amount item-name. amount can be omitted for unique items used in bartering, such as Star-Shaped Ore. The description shown when the store item is selected, if applicable. For multiple prices with simple syntax, the tuple is 3- to N+2-arity 1. The item for sale written in the format quantity item-name. Omit quantity for items sold as singles. 2 to N+1. The prices for the item corresponding to the 1st to Nth prices named in the prices parameter above. N+2. The description shown when the store item is selected, if applicable.

No description.

Template parameters

This template prefers inline formatting of parameters.

Parameter		Description	Type	Status
game	game	A [[:Category:Game codes|game code]].	Content	optional
showQuantityColumn	showQuantityColumn	Set to <code>true</code> to display a <kbd>Quantity</kbd> column in the price table. Usually not required as quantity values are normally shown in the item's displayed name (see [[#Display Format]] below).	Content	optional
prices	prices	A [[ZW:COMMALIST|comma-separated list]] of price names to display as columns in the price table.	Content	optional
collapse	collapse	If set to <code>true</code>, the table is collapsed such that only a small preview of the data is shown, with a "show more" button that reveals the full table when clicked. This functionality depends on [[MediaWiki:Gadget-Collapse.js]].	Content	optional
fileType	fileType	The type of files to show. Defaults to <code>Sprite</code> for 2D games, <code>Model</code> for most 3D games, and <code>Icon</code> for ''[[The Legend of Zelda: Breath of the Wild|Breath of the Wild]]'', ''[[The Legend of Zelda: Tears of the Kingdom|Tears of the Kingdom]]'', ''[[Hyrule Warriors: Age of Calamity|Age of Calamity]]'', and ''[[Hyrule Warriors: Age of Imprisonment|Age of Imprisonment]]''.	Content	optional

Display Format

Name

By default, an item's displayed name is automatically generated based on the game, item, and quantity parameters (item is either the parameter of the same name in the extended syntax of {{Wares/Item}} or the first value of a tuple in the simplified syntax; quantity is from the extended syntax). This is done to accurately reflect the in-game presentation of the item. For example, Breath of the Wild store menus present 10 Arrows as Arrow x10, whereas Ocarina of Time 3D displays Arrows (10). Template:Term or Template:Plural is applied to the item parameter to generate the display name. The game-specific formats are configured at Module:Wares/Data.

If a particular shop in the game shows something different than what this template outputs by default, use the display parameter in the extended syntax. Include a link to the item's article as well as the item quantity if this is displayed as part of the item's name in the shop.

Because an item's quantity is normally shown in its displayed name, it is not necessary for the price table to have a Quantity column in most cases. There are exceptions—Malo Mart Castle Branch only mentions quantities in the descriptions, and A Link to the Past shop items aren't named at all as Link instantly buys them upon picking them up. In these cases, a Quantity column can be added using the showQuantityColumn parameter.

If the item parameter contains a link (e.g. [[Deku Stick]] upgrade), then the wikitext in that parameter is displayed as-is. No image is shown for that item unless the image parameter in the extended syntax is used.

Image

The image displayed for the item is also automatically generated based on the game, item, and quantity parameters. For example, A Link to the Past has for packs of 10 Bombs and for 30 Bombs, whereas The Wind Waker simply displays for all quantities. Most 3D games use models to display shop items but some newer games such as Breath of the Wild use icons. The game-specific image formats are configured at Module:Wares/Data as well.

While an image parameter does exist in the extended syntax, which can override the default file format with a custom image, using this parameter is generally discouraged for the sake of consistency.

A fileType parameter also exists and can be set to Icon to show icons instead of models. Using this parameter is, again, generally discouraged for the sake of consistency. See Curiosity Shop for a usage example.

Examples

Input	Output	Categories added
Empty wares table, for stubs
{{Wares|game= ALBW}}	Item Price	Category:Pages with data tables
Kokiri Shop wares, using the simplified syntax
{{Wares|game= OoT3D |- | 10 Arrow | 20 Rupee |- | 30 Arrow | 60 Rupee |- | 30 Deku Seed | 30 Rupee |- | 5 Deku Nut | 15 Rupee |- | 10 Deku Nut | 30 Rupee |- | Deku Shield | 40 Rupee |- | Deku Stick | 10 Rupee |- | Recovery Heart | 10 Rupee }}	Item Arrows (10) Price 20 Rupees Item Arrows (30) Price 60 Rupees Item Deku Seeds (30) Price 30 Rupees Item Deku Nuts (5) Price 15 Rupees Item Deku Nuts (10) Price 30 Rupees Item Deku Shield Price 40 Rupees Item Deku Stick Price 10 Rupees Item Recovery Heart Price 10 Rupees Item Price Arrows (10) 20 Rupees Arrows (30) 60 Rupees Deku Seeds (30) 30 Rupees Deku Nuts (5) 15 Rupees Deku Nuts (10) 30 Rupees Deku Shield 40 Rupees Deku Stick 10 Rupees Recovery Heart 10 Rupees	Category:Pages with data tables
The image used depends on the game, item, and quantity parameters
{{Wares|game= ALttP |- | 10 Bomb | 50 Rupee |- | 30 Bomb | 100 Rupee }}	Item 10 Bombs Price 50 Rupees Item 30 Bombs Price 100 Rupees Item Price 10 Bombs 50 Rupees 30 Bombs 100 Rupees	Category:Pages with data tables
Subrosia Market, using the extended syntax with the display parameter and non-Rupee prices
{{Wares|game= OoS |- |{{Wares/Item |item= Ribbon |display= A cute [[Ribbon]] |stock= 1 |price= Star-Shaped Ore }} |- |{{Wares/Item |item= Rare Peach Stone |stock= 1 |price= 20 Ore Chunk, 10 Ember Seed }} |- |{{Wares/Item |item= Member's Card |display= [[Member's Card|A cutting board?]] |stock= 1 |price= 5 Ore Chunk }} }}	Item A cute Ribbon Price Star-Shaped Ore Stock 1 Item Rare Peach Stone Price 20Ore Chunks 10Ember Seeds Stock 1 Item A cutting board? Price 5Ore Chunks Stock 1 Item Price Stock A cute Ribbon Star-Shaped Ore 1 Rare Peach Stone 20Ore Chunks 10Ember Seeds 1 A cutting board? 5Ore Chunks 1	Category:Pages with data tables
Business Scrub in Ocarina of Time, mixing the simplified and extended syntax so that the image parameter can be used for the entries that need it
{{Wares |game= OoT3D |collapse= true |- | Deku Stick | 15 Rupee |- | Deku Shield | 50 Rupee |- | Piece of Heart | 10 Rupee |- |{{Wares/Item |item= [[Deku Stick]] upgrade |image= File:OoT3D Deku Stick Model.png |price= 40 }} |- |{{Wares/Item |item= [[Deku Nut]] upgrade |image= File:OoT3D Deku Nut Model.png |price= 40 }} }} {{List Notes}}	Item Deku Stick Price 15 Rupees Item Deku Shield Price 50 Rupees Item Piece of Heart Price 10 Rupees Item Deku Stick upgrade Price 40 Rupees Item Deku Nut upgrade Price 40 Rupees Item Price Deku Stick 15 Rupees Deku Shield 50 Rupees Piece of Heart 10 Rupees Deku Stick upgrade 40 Rupees Deku Nut upgrade 40 Rupees	Category:Pages with data tables
Malo Mart Castle Branch wares, using the display, showQuantityColumn, and collapse parameters
{{Wares |game= TPHD |showQuantityColumn= true |collapse= true |- |{{Wares/Item |item= Bomb |display= {{Color TPHD|Gold|[[Bomb]]s}} {{Color TPHD|Red|!Blast Deal!}} |quantity= 30 |price= 45 |description= Made by Barnes Co. (set of 30)<br/>Only Malo Mart can deliver these savings! }} |- |{{Wares/Item |item= Water Bomb |display= {{Color TPHD|Gold|[[Water Bomb]]s}} {{Color TPHD|Red|!Big Deal!}} |quantity= 15 |price= 45 |description= For aquatic defense. (set of 15)<br/>No one can beat this price! }} |- |{{Wares/Item |item= Bombling |display= {{Color TPHD|Gold|[[Bombling]]}} {{Color TPHD|Red|!Boom Deal!}} |quantity= 10 |price= 30 |description= These endangered creatures have been successfully propagated!<br/>This is a special 10-Bombling set! }} |- |{{Wares/Item |item= Malo Mart Stamp |display= {{Color TPHD|Gold|[[Malo Mart Stamp|"Malo Mart" Stamp]]}} {{Color TPHD|Red|!Unique !}} |price= 50 |description= With the Malo Mart logo! This one-of-a-kind commemorative piece is sure to leave an impression. }} |- |{{Wares/Item |item= Blue Potion |display= {{Color TPHD|Blue|[[Blue Potion]]}} {{Color TPHD|Red|!Act Now!}} |price= 50 |description= A restorative elixir recommended for those who do not feel 100%.<br/>(Requires an empty bottle.) }} |- |{{Wares/Item |item= Red Potion |display= {{Color TPHD|Red|[[Red Potion]]}} {{Color TPHD|Gold|!Feature!}} |price= 15 |description= Just one bottle is the perfect pick-me-up!<br/>(Requires an empty bottle.) }} |- |{{Wares/Item |item= Magic Armor |display= {{Color TPHD|Gold|[[Magic Armor]]}} {{Color TPHD|Red|!Special!}} |price= 598 |description= This is quite a bargain when you think of how valuable your life is. What's a few Rupees to stay alive? }} }}	Item Bombs !Blast Deal! Quantity 30 Price 45 Rupees Description Made by Barnes Co. (set of 30) Only Malo Mart can deliver these savings! Item Water Bombs !Big Deal! Quantity 15 Price 45 Rupees Description For aquatic defense. (set of 15) No one can beat this price! Item Bombling !Boom Deal! Quantity 10 Price 30 Rupees Description These endangered creatures have been successfully propagated! This is a special 10-Bombling set! Item "Malo Mart" Stamp !Unique ! Quantity 1 Price 50 Rupees Description With the Malo Mart logo! This one-of-a-kind commemorative piece is sure to leave an impression. Item Blue Potion !Act Now! Quantity 1 Price 50 Rupees Description A restorative elixir recommended for those who do not feel 100%. (Requires an empty bottle.) Item Red Potion !Feature! Quantity 1 Price 15 Rupees Description Just one bottle is the perfect pick-me-up! (Requires an empty bottle.) Item Magic Armor !Special! Quantity 1 Price 598 Rupees Description This is quite a bargain when you think of how valuable your life is. What's a few Rupees to stay alive? Item Quantity Price Description Bombs !Blast Deal! 30 45 Rupees Made by Barnes Co. (set of 30) Only Malo Mart can deliver these savings! Water Bombs !Big Deal! 15 45 Rupees For aquatic defense. (set of 15) No one can beat this price! Bombling !Boom Deal! 10 30 Rupees These endangered creatures have been successfully propagated! This is a special 10-Bombling set! "Malo Mart" Stamp !Unique ! 1 50 Rupees With the Malo Mart logo! This one-of-a-kind commemorative piece is sure to leave an impression. Blue Potion !Act Now! 1 50 Rupees A restorative elixir recommended for those who do not feel 100%. (Requires an empty bottle.) Red Potion !Feature! 1 15 Rupees Just one bottle is the perfect pick-me-up! (Requires an empty bottle.) Magic Armor !Special! 1 598 Rupees This is quite a bargain when you think of how valuable your life is. What's a few Rupees to stay alive?	Category:Pages with data tables
Chumin's wares, using restocking information from Module:Wares/Data
{{Wares|game= BotW |- |{{Wares/Item |item= Palm Fruit |price= 16 |stock= 5 }} |- |{{Wares/Item |item= Bright-Eyed Crab |price= 40 |stock= 3 }} |- |{{Wares/Item |item= Hearty Blueshell Snail |price= 60 |stock= 3 }} }}	Item Palm Fruit Price 16 Rupees Stock 5 Item Bright-Eyed Crab Price 40 Rupees Stock 3 Item Hearty Blueshell Snail Price 60 Rupees Stock 3 Item Price Stock Palm Fruit 16 Rupees 5 Bright-Eyed Crab 40 Rupees 3 Hearty Blueshell Snail 60 Rupees 3	Category:Pages with data tables
Beedle's Shop Ship, using the restocks parameter and the special Varies price value
{{Wares|game= PH |- |{{Wares/Item |item= Bomb Bag |price= 1,000 |stock= 1 }} |- |{{Wares/Item |item= Wisdom Gem |price= 500 |stock= 1 }} |- |{{Wares/Item |item= Ship Part |price= Varies |stock= 1 |restocks= {{#vardefineecho:restock|Restocks daily.<ref>{{Cite|Ohh, I'm currently out of stock, but choice items are in transit! ...Would I lie?|Beedle|PH}}</ref>}} }} |- |{{Wares/Item |item= Treasure |price= Varies |stock= 1 |restocks= {{#var:restock}} }} }}	Item Bomb Bag Price 1,000 Rupees Stock 1 Item Wisdom Gem Price 500 Rupees Stock 1 Item Ship Part Price Varies Stock 1 Item Treasure Price Varies Stock 1 Item Price Stock Bomb Bag 1,000 Rupees 1 Wisdom Gem 500 Rupees 1 Ship Part Varies 1 Treasure Varies 1	Category:Pages with data tables
Witch's Hut in A Link Between Worlds with multiple prices (simplified syntax)
{{Wares|game= ALBW|prices= Rupees, Materials |- | Red Potion | 50 Rupee | N/A | Restores eight hearts! This will definitely come in handy. |- | Blue Potion | 200 Rupee | 10 Monster Tail | Restores all of your hearts. You can't go wrong with one! |- | Yellow Potion | 100 Rupee | 10 Monster Horn | Drink it to make yourself invulnerable for a short time! |- | Purple Potion | 60 Rupee | 10 Monster Guts | Drink this to damage all surrounding enemies. }}	Item Red Potion Prices Rupees 50 Rupees Materials —Not Applicable Description Restores eight hearts! This will definitely come in handy. Item Blue Potion Prices Rupees 200 Rupees Materials 10Monster Tails Description Restores all of your hearts. You can't go wrong with one! Item Yellow Potion Prices Rupees 100 Rupees Materials 10Monster Horns Description Drink it to make yourself invulnerable for a short time! Item Purple Potion Prices Rupees 60 Rupees Materials 10Monster Guts Description Drink this to damage all surrounding enemies. Item Prices Description Rupees Materials Red Potion 50 Rupees —Not Applicable Restores eight hearts! This will definitely come in handy. Blue Potion 200 Rupees 10Monster Tails Restores all of your hearts. You can't go wrong with one! Yellow Potion 100 Rupees 10Monster Horns Drink it to make yourself invulnerable for a short time! Purple Potion 60 Rupees 10Monster Guts Drink this to damage all surrounding enemies.	Category:Pages with data tables
Beedle's Airshop wares table with multiple prices (extended syntax)
{{Wares|game= ST|prices= Full Price, Silver Membership, Gold Membership, Platinum Membership, Diamond Membership |- |{{Wares/Item |item= Treasure |price1= 300 |price2= 270 |price3= 240 |price4= 210 |price5= 150 |stock= 1 |restocks= Restocks daily.<ref>{{Cite|Ohhh, so sorry. We're sold out of those. You'll have to wait until tomorrow.|Beedle|ST}}</ref> }} }}	Item Treasure Prices Full Price 300 Rupees Silver Membership 270 Rupees Gold Membership 240 Rupees Platinum Membership 210 Rupees Diamond Membership 150 Rupees Stock 1 Item Prices Stock Full Price Silver Membership Gold Membership Platinum Membership Diamond Membership Treasure 300 Rupees 270 Rupees 240 Rupees 210 Rupees 150 Rupees 1	Category:Pages with data tables
Error: Item missing prices when multiple prices are specified
{{Wares|game= TWW|prices= A, B |- | Bomb | 10 Rupee }}	The following table is incomplete. You can help Zelda Wiki by editing the page and filling in the empty cells. Item Bomb Prices A 10 Rupees B Item Prices A B Bomb 10 Rupees	Category:Incomplete The Wind Waker sections Category:Pages with validation errors Category:Articles with incomplete tables Category:Incomplete sections Category:Pages with data tables
Error: Item with multiple prices when prices parameter is not set
{{Wares|game= TWW |- |{{Wares/Item |item= Bomb |price1= 10,000 |price2= 20 }} }}	Item Price	Category:Pages with data tables Category:Pages with validation errors

Guidelines

The item image and text shown in the Wares tables should reflect what is displayed in-game. Module:Wares/Data must be kept up to date so that the template shows the correct image and text for each item. If a shop has its own specific name for an item, use the display parameter in the extended syntax of {{Wares/Item}} to specify this name.

This template is only to be used for listing items that a shop sells. For items that a shop buys (i.e. Link sells), use Template:Data Table. For an example, see Buyer.

The above documentation is transcluded from Template:Wares/Documentation. (edit | history)