View source for Template:Infobox cocktail/doc

{{documentation subpage}}
{{Wikipedia:WikiProject Food and drink/Beverages Task Force/navigation}}

<!-- EDIT TEMPLATE DOCUMENTATION BELOW THIS LINE -->
{{tl|Infobox cocktail}} displays a highly configurable, user-friendly table of information concerning mixed drinks, cocktails, garnishes, and drinkware in the upper right of each related article. It should be present on articles concerning notable alcoholic and non-alcoholic mixed drinks, including cocktails, as well as cocktail garnishes and drinkware. By providing readers a consistent table of similar information within all the page concerning these topics, they will be able to locate the pertinent information quickly and easily, without having to read through the entire article.
{{tl|Infobox cocktail}} is ''extremely'' complex and very powerful. When used correctly (and it's much easier to use than the previous sentence made it sound), the infobox does much more than provide snippets of information. It also:

* Clearly identifies [[List of IBA official cocktails|IBA official cocktails]].
* Reduces clutter and disorganization within the articles by moving information that is generally poorly formatted into a logical infobox template.
* Reduces nearly all contentious "recipe" information (which is generally considered [[WP:NOT#IINFO|not acceptable]] within Wikipedia) to a small list of key ingredients (which essentially defines the drink much like the chemical formula does a molecule), and very brief preparation steps. All of this is moved outside the article and into the infobox, keeping the article clearly more encyclopedic in tone.
* Advanced scripting within the infobox properly links to pertinent articles, displays appropriate images, and handles other tasks based on a simple "attribute" and "attribute value" system (in other words, you copy and paste the template into the page, fill in a few key words, and the template does all the Wiki-magic to display lots of cool information).
{{TOC limit|2}}

=== Usage ===
To get started with a mixed drink article, copy the Basic template below and paste it into the article. If you are editing a type of drinkware or a cocktail garnish, use the other appropriate template instead. The template with all the options is primarily for reference. At a minimum, you will need to replace the ''NAME'' in the template with the actual name of the article's subject, and also the ''ALCOHOLTYPE'' with a valid type of alcohol (like ''gin'' or ''vodka''). Preview the page, and you should see something similar to the [[#Examples|examples below]].

'''Do not [[WP:SUBST|subst:]] this template''', or the page will become filled with information that will make it very hard for anyone to edit the article.

Place the following text near the top of the page, usually right after the first paragraph and before the first heading is a good choice.
{| style="background-color: transparent; vertical-align: top; width: 100%"
! Basic template options
! ''All'' template options
|- style="vertical-align:top"
| width=50% | Use the following template options replacing ''ALCOHOLTYPE'' with one of the primary alcohol options.

<pre>{{ infobox cocktail
| iba         = 
| source      = 
| sourcelink  = 
| name        = 
| image       = 
| caption     = 
| type        = 
| flaming     = 
| ALCOHOLTYPE = yes
| served      = 
| garnish     = 
| drinkware   = 
| ingredients = 
| prep        = 
| timing      =
| notes       = 
| footnotes   = 
}}</pre>
| rowspan=3 |
<pre>{{ infobox cocktail
| iba         = 
| source      = 
| sourcelink  = 
| name        = 
| image       = 
| caption     = 
| type        = 
| flaming     = 
| absinthe    = 
| amaretto    = 
| beer        = 
| bourbon     = 
| brandy      = 
| cacao       = 
| cachaça     = 
| campari     = 
| canadian    = 
| champagne   = 
| cider       = 
| coffee      = 
| cognac      = 
| curaçao     = 
| everclear   = 
| fortified   = 
| gin         = 
| irishc      = 
| irishw      = 
| jäger       = 
| menthe      = 
| moonshine   = 
| pastis      = 
| pisco       = 
| port        = 
| pucker      = 
| rum         = 
| sake        = 
| sambuca     = 
| schnapps    = 
| scotch      = 
| sparkling   = 
| tennessee   = 
| tequila     = 
| vermouth    = 
| vodka       = 
| whiskey     = 
| whisky      = 
| wine        = 
| other       = 
| served      = 
| garnish     = 
| drinkware   = 
| ingredients = 
| prep        = 
| timing      =
| notes       = 
| footnotes   = 
}}</pre>
|-
! Drinkware/garnish options
|-
| 
[[Drinkware]] and [[cocktail garnish]]es use only the following options.

<pre>{{ infobox cocktail
| name        = NAME
| image       = 
| caption     = 
| type        = 
| notes       = 
| footnotes   = 
}}</pre>
|}

=== Attributes ===
* Only the ''name'' of the topic is '''required'''.
* Except for the primary alcohol types, all the basic template options ''or'' drinkware/garnish template options should be included in the article. Doing so makes it easy for other editors to fill-in missing information. Blank attribute are not displayed.
* Standard attribute names ("iba", "name", "image", etc.) and values ("yes", "whiskey", "rocks2", etc.) are CaSe-SeNsItIvE, so be sure to enter them ''exactly'' as indicated. If something unexpected is displayed, this is one of the first things to check.
* Line breaks are permitted in most free-form values

==== iba ====
:''This attribute applies only to '''certain cocktails'''.''
Several cocktails are specially designated by the International Bartender Association (IBA) and are used in the annual World Cocktail Competition (WCC). These mixed drinks are some of the most well-known and popular drinks throughout the world. Such a drink is referred to as an [[IBA Official Cocktail]].

''Always identify any [[IBA Official Cocktail]]s:'' <syntaxhighlight lang=moin> | iba = yes</syntaxhighlight>
==== Source ====
:''This attribute applies only to mixed drinks.''
Mixed drinks vary quite a bit in how they are prepared. This can result in quite a bit of disagreement between editors as to the "correct" ingredients and their proportions.

Whenever possible one of the following sources should be used for creating the ingredient list (see below).

''[[IBA Official Cocktails]] should always use the IBA standard recipes. This option is redundant if <code>iba=yes</code> is set above:'' <syntaxhighlight lang=moin> | source = iba</syntaxhighlight>

''If using [http://www.cocktaildb.com/ CocktailDB]:'' <syntaxhighlight lang=moin> | source = cocktaildb</syntaxhighlight>

''If using [http://www.drinkboy.com/Cocktails/ DrinkBoy]:'' <syntaxhighlight lang=moin> | source = drinkboy</syntaxhighlight>

''If using a different site:'' <syntaxhighlight lang=moin> | source = url</syntaxhighlight>

''If using an unknown source (not a good idea), leave it blank:'' <syntaxhighlight lang=moin> | source = </syntaxhighlight>

==== sourcelink ====
:''This attribute applies only to mixed drinks with a valid source attribute (see above).''
If you entered a source above, you should also enter the link

''For IBA Official Cocktails, see the instructions for {{tl|IBA recipe}} to obtain the link name:'' <syntaxhighlight lang=moin> | sourcelink = DRINKNAME</syntaxhighlight>

''For CocktailDB, see the instructions for {{tl|Cocktaildb recipe}} to obtain the link name:'' <syntaxhighlight lang=moin> | sourcelink = ####</syntaxhighlight>

''For Drinkboy, see the instructions for {{tl|Drinkboy recipe}} to obtain the link name:'' <syntaxhighlight lang=moin> | sourcelink = ###</syntaxhighlight>

''If using a different site, enter the full [[URL]]:'' <syntaxhighlight lang=moin> | sourcelink = http://www.example.net</syntaxhighlight>

''If using an unknown source (not a good idea), leave it blank:'' <syntaxhighlight lang=moin> | sourcelink = </syntaxhighlight>

==== name ====
:''Applies to all types.''
This is the name of the mixed drink, cocktail garnish, or drinkware to which you are adding the infobox.
* If you are tagging an [[IBA Official Cocktail]], you should always name the infobox with the exact IBA Official Cocktail name.
* Except for [[WP:DAB|disambiguation]] information following the drink name, the name of the article should also match the IBA Official Cocktail name. If it does not, please discuss this on the article's [[WP:TALK|talk page]]. If you feel very comfortable moving articles to new names and fixing all double redirect links and updating ''what links here'' pages, feel free to do so. Otherwise, please add it to the [[Wikipedia:WikiProject Food and drink/Beverages Task Force/to do|To-Do List]] for the [[WP:MIX|Mixed Drinks Task Force]]; we will be happy to help move the article and fix anything that needs fixing.

''Always provide the name of the subject (enter on a single line without links):''
<syntaxhighlight lang=moin> | name = NAME</syntaxhighlight>

==== image ====
:''Applies to all types.''
If there is a decent photo available, please include its name here. You '''should not''' include the word "file:" or the size of the image. If you have a choice of photos, please try to pick the one that is most representative of the subject. For drinks, that would be a photo showing the drink properly prepared, with the standard garnishes, in the standard drinkware for the type of beverage. For drinkware, it should be a fairly plain and standard version of the vessel, without much decoration or ornamentation, and preferably no brand names or logos visible. For garnishes, pictures that show how the item is used as a mixed drink are best, but a good close-up is also perfectly acceptable.

''If there is a good image available, please include its filename:''
<syntaxhighlight lang=moin> | image = example.jpg</syntaxhighlight>

==== caption ====
:''Applies to all types.''
Captions only appear if an image is specified. The caption should ideally point out some of the reasons why the image is truly representative of the subject. If there is something non-standard about the photo (like a drink served in the wrong type of glass), it may be good to point that out, too.

''If displaying a picture, provide a detailed description (may be multiple lines):''
<syntaxhighlight lang=moin> | caption = Green Fizz cocktails are easily identified by their fluorescent green tint.</syntaxhighlight>

==== type ====
:''Applies to all types.''
Certain drinks, like eggnog, which are commonly served both with and without alcohol, and do not fit nicely in more specific categories ''should'' be identified as ''mixed'', but they are the exceptions.

''If the '''primary alcohol is a type of beer''' that is mixed with lesser amounts of other alcohols or mixers:''<br>''<small>(see {{cl|Cocktails with beer}})</small>''
<syntaxhighlight lang=moin> | type = [[Beer cocktail|beer]]</syntaxhighlight>

''If the '''primary alcohol is a type of distilled spirit''' (gin, rum, tequila, vodka, whiskey, etc.) that is mixed with lesser amounts of other alcohols or mixers:''<br>''<small>(see {{cl|Cocktails}})</small>''
<syntaxhighlight lang=moin> | type = [[List of cocktails|cocktail]]</syntaxhighlight>

''If the '''primary alcohol is a type of distilled spirit''' (gin, rum, tequila, vodka, whiskey, etc.) that is mixed with a larger amount of non-alcoholic mixer:''
<syntaxhighlight lang=moin> | type = [[highball]]</syntaxhighlight>

''If the cocktail is '''primarily served as a shooter''' (in other words, it would be very odd to see it served in anything other than a shot glass):''<br>''<small>(see {{cl|Mixed drink shooters and drink shots}})</small>''
<syntaxhighlight lang=moin> | type = [[Mixed drink shooters and drink shots|shooter]]</syntaxhighlight>

''If the cocktail is a '''layered shooter''' (a shooter in which the various alcohols are layered one on top of the other):''
<syntaxhighlight lang=moin> | type = layered</syntaxhighlight>

''If the '''primary alcohol is a type of wine''' (including Champagne and fortified wines) that is mixed with lesser amounts of other alcohols or mixers:''<br>''<small>(see {{cl|Wine cocktails and punches}})</small>''
<syntaxhighlight lang=moin> | type = [[Wine cocktail|wine]]</syntaxhighlight>

''Mixed drinks that normally '''do not contain any alcohol''':''<br>''<small>(see {{cl|Non-alcoholic mixed drinks}})</small>''
<syntaxhighlight lang=moin> | type = [[Non-alcoholic mixed drink|nonalc]]</syntaxhighlight>
''or, if you prefer:''
<syntaxhighlight lang=moin> | type = [[Non-alcoholic mixed drink|non-alcoholic]]</syntaxhighlight>

''Any other type of '''mixed drink''' that does not fit into one of the preceding types, should be labeled:''<br>''<small>(see {{cl|Mixed drinks}})</small>''
<syntaxhighlight lang=moin> | type = [[Mixed drink|mixed]]</syntaxhighlight>

'''''Drinkware''', such as drinking glasses, stemware, steins, drinking horns, etc., should be identified:''<br>''<small>(see {{cl|Drinkware}})</small>''
<syntaxhighlight lang=moin> | type = [[drinkware]]</syntaxhighlight>

''Finally, '''cocktail garnishes''' (usually the non-food types) should be identified:''<br>''<small>(see {{cl|Cocktail garnishes}})</small>''
<syntaxhighlight lang=moin> | type = [[Cocktail garnish|garnish]]</syntaxhighlight>

==== flaming ====
:''This attribute applies only to mixed drinks.''
Some mixed drinks are made with high-proof alcohol that is ignited prior to serving. These "[[flaming beverage]]s" are generally a type of cocktail or shooter. If the article discusses serving the drink on fire, either normally or as a variation, note this by setting this attribute.

''Served on fire regularly or as a variation:''
<syntaxhighlight lang=moin> | flaming = yes</syntaxhighlight>

==== ALCOHOLTYPE ====
:''This attribute applies only to mixed drinks.''
While you may include the list of all possible alcohol type attributes, it is usually best to remove the attributes that do not apply to save storage space and improve processing speed.
* Identify the primary [[alcohol by volume]] used in the drink. If two or more types of alcohol are primary and in equal volumes, you should list each of the primary alcohols by including each alcohol's ALCOHOLTYPE on separate lines.
* Generally do not include the primary alcohols used in variations listed within the article (for example, only list "gin" for a martini, even though vodka martinis are a very common variation that is mentioned in the same article).

''Substitute the word '''ALCOHOLTYPE''' in this example:''
<syntaxhighlight lang=moin> | ALCOHOLTYPE = yes</syntaxhighlight>
''with one of the following types of alcohol:''
{| style="background:#f9f9f9; border:1px dashed #2f6fab; color:black; padding:1em;"
|-
! colspan=3 | 

====== Grain-based Spirits and Fermented Beverages ======
|-
! colspan=3 | Beers
|-
! style="font-size:smaller;"| ''ALCOHOLTYPE''
! style="font-size:smaller;"| ''Links to the following article''
! style="font-size:smaller;"| ''Notes''
|-
| colspan=3 | Use ''beer'' unless the specific type is important.
|-
| <samp>'''beer'''</samp> || [[Beer]] || Preferred generic term
|-
| <samp>ale</samp> || [[Ale]] || &nbsp;
|-
| <samp>fruitbeer</samp> || [[Fruit Beer]] || &nbsp;
|-
| <samp>lager</samp> || [[Lager]] || &nbsp;
|-
| <samp>pilsner</samp> || [[Pilsner]] || &nbsp;
|-
| <samp>porter</samp> || [[Porter (beer)|Porter]] || &nbsp;
|-
| <samp>stout</samp> || [[Stout]] || &nbsp;
|-
| <samp>wheatbeer</samp> || [[Wheat beer]] || &nbsp;
|-
! colspan=3 | Gins
|-
! style="font-size:smaller;"| ''ALCOHOLTYPE''
! style="font-size:smaller;"| ''Links to the following article''
! style="font-size:smaller;"| ''Notes''
|-
| <samp>'''gin'''</samp> || [[Gin]] || Preferred generic term
|-
! colspan=3 | Neutral Grain Spirits
|-
! style="font-size:smaller;"| ''ALCOHOLTYPE''
! style="font-size:smaller;"| ''Links to the following article''
! style="font-size:smaller;"| ''Notes''
|-
| <samp>everclear</samp> || [[Everclear (alcohol)|Everclear]] || &nbsp;
|-
| <samp>moonshine</samp> || [[Moonshine]] || &nbsp;
|-
! colspan=3 | Rice-based
|-
! style="font-size:smaller;"| ''ALCOHOLTYPE''
! style="font-size:smaller;"| ''Links to the following article''
! style="font-size:smaller;"| ''Notes''
|-
| <samp>sake</samp> || [[Sake]] || &nbsp;
|-
! colspan=3 | Whiskies
|-
| colspan=3 | Use ''whiskey'' unless the specific type is important.
|-
! style="font-size:smaller;"| ''ALCOHOLTYPE''
! style="font-size:smaller;"| ''Links to the following article''
! style="font-size:smaller;"| ''Notes''
|-
| <samp>'''whiskey'''</samp> || [[Whisky|Whiskey]] || Preferred generic term
|-
| <samp>bourbon</samp> || [[Bourbon whiskey]] || &nbsp;
|-
| <samp>canadian</samp> || [[Canadian whisky]] || &nbsp;
|-
|-
| <samp>irishw</samp> || [[Irish whiskey]] || &nbsp;
|-
| <samp>rye</samp> || [[Rye whiskey]] || &nbsp;
|-
| <samp>scotch</samp> || [[Scotch whisky]] || &nbsp;
|-
| <samp>tennessee</samp> || [[Tennessee whiskey]] || &nbsp;
|-
| <samp>whisky</samp> || [[Whisky]] || &nbsp;
|-
! colspan=3 | 
====== Fruit-based Spirits and Fermented Beverages ======
|-
! colspan=3 | Brandies
|-
| colspan=3 | Use ''brandy'' or ''cognac'' unless the specific type is important.
|-
| <samp>'''brandy'''</samp> || [[Brandy]] || Preferred generic term
|-
| <samp>'''cognac'''</samp> || [[Cognac (drink)|Cognac]] || Preferred generic term
|-
| <samp>gmarnier</samp> || [[Grand Marnier]] || Also an ''orange liqueur''
|-
| <samp>hpnotiq</samp> || [[Hpnotiq]] || Also a ''fruit liqueur''
|-
| <samp>pisco</samp> || [[Pisco]] || &nbsp;
|-
! colspan=3 | Wines
|-
| colspan=3 | Use ''wine'' or ''sparkling'' unless the specific type is important.
|-
! style="font-size:smaller;"| ''ALCOHOLTYPE''
! style="font-size:smaller;"| ''Links to the following article''
! style="font-size:smaller;"| ''Notes''
|-
| <samp>'''wine'''</samp> || [[Wine]] || Preferred generic term
|-
| <samp>'''sparkling'''</samp> || [[Sparkling wine]] || Preferred generic term
|-
| <samp>champagne</samp> || [[Champagne (wine)|Champagne]] || &nbsp;
|-
| <samp>fortified</samp> || [[Fortified wine]] || &nbsp;
|-
| <samp>port</samp> || [[Port wine|Port]] || &nbsp;
|-
| <samp>prosecco</samp> || [[Prosecco]] || &nbsp;
|-
| <samp>vermouth</samp> || [[Vermouth]] || &nbsp;
|-
! colspan=3 | Other Fruits
|-
! style="font-size:smaller;"| ''ALCOHOLTYPE''
! style="font-size:smaller;"| ''Links to the following article''
! style="font-size:smaller;"| ''Notes''
|-
| <samp>cider</samp> || [[Cider]] || &nbsp;
|-
! colspan=3 | 
====== Other Spirits and Fermented Beverages ======
|-
! colspan=3 | Agave-based
|-
| colspan=3 | Use ''mezteq'' unless the specific type is important.
|-
! style="font-size:smaller;"| ''ALCOHOLTYPE''
! style="font-size:smaller;"| ''Links to the following article''
! style="font-size:smaller;"| ''Notes''
|-
| <samp>'''mezteq'''</samp> || [[Mezcal]]/[[Tequila]] || Preferred generic term
|-
| <samp>mezcal</samp> || [[Mezcal]] || &nbsp;
|-
| <samp>tequila</samp> || [[Tequila]] || &nbsp;
|-
! colspan=3 | Potato-based
|-
! style="font-size:smaller;"| ''ALCOHOLTYPE''
! style="font-size:smaller;"| ''Links to the following article''
! style="font-size:smaller;"| ''Notes''
|-
| <samp>'''vodka'''</samp> || [[Vodka]] || Preferred generic term
|-
! colspan=3 | Sugar Cane or Molassas-based
|-
| colspan=3 | Use ''rum'' unless the specific type is important.
|-
! style="font-size:smaller;"| ''ALCOHOLTYPE''
! style="font-size:smaller;"| ''Links to the following article''
! style="font-size:smaller;"| ''Notes''
|-
| <samp>'''rum'''</samp> || [[Rum]] || Preferred generic term
|-
| <samp>151</samp> || [[Bacardi 151]] || &nbsp;
|-
| <samp>cachaça</samp> || [[Cachaça]] || &nbsp;
|-
! colspan=3 | Miscellaneous
|-
! style="font-size:smaller;"| ''ALCOHOLTYPE''
! style="font-size:smaller;"| ''Links to the following article''
! style="font-size:smaller;"| ''Notes''
|-
| <samp>schnapps</samp> || [[Schnapps]] || &nbsp;
|-
| <samp>highproof</samp> || [[Proof (alcohol)|High-proof]] alcohol || &nbsp;
|-
! colspan=3 | 
====== Liqueurs ======
|-
! colspan=3 | Anise
|-
| colspan=3 | Use ''anise'' unless the specific type is important.
|-
! style="font-size:smaller;"| ''ALCOHOLTYPE''
! style="font-size:smaller;"| ''Links to the following article''
! style="font-size:smaller;"| ''Notes''
|-
| <samp>'''anise'''</samp> || [[List_of_liqueurs#Anise-flavored_liqueurs|Anise-flavored liqueur]] || Preferred generic term
|-
| <samp>absinthe</samp> || [[Absinthe]] || &nbsp;
|-
| <samp>ouzo</samp> || [[Ouzo]] || &nbsp;
|-
| <samp>pastis</samp> || [[Pastis]] || &nbsp;
|-
| <samp>sambuca</samp> || [[Sambuca]] || &nbsp;
|-
! colspan=3 | Chocolate
|-
| colspan=3 | Use ''chocolate'' unless the specific type is important.
|-
! style="font-size:smaller;"| ''ALCOHOLTYPE''
! style="font-size:smaller;"| ''Links to the following article''
! style="font-size:smaller;"| ''Notes''
|-
| <samp>'''chocolate'''</samp> || [[List of liqueurs#Chocolate liqueurs|Chocolate liqueur]] || &nbsp;
|-
| <samp>cacao</samp> || [[Creme de cacao|Crème de Cacao]] || Also a ''crème liqueur''
|-
! colspan=3 | Coffee
|-
! style="font-size:smaller;"| ''ALCOHOLTYPE''
! style="font-size:smaller;"| ''Links to the following article''
! style="font-size:smaller;"| ''Notes''
|-
| <samp>'''coffee'''</samp> || [[List of liqueurs#Coffee liqueurs|Coffee liqueur]] || <small>[[Kahlúa]], [[Tia Maria]], etc.</small>
|-
! colspan=3 | Cream
|-
! style="font-size:smaller;"| ''ALCOHOLTYPE''
! style="font-size:smaller;"| ''Links to the following article''
! style="font-size:smaller;"| ''Notes''
|-
| <samp>'''cream'''</samp> || [[List of liqueurs#Cream liqueurs|Cream liqueur]] || Generic term
|-
| <samp>irishc</samp> || [[Irish Cream]] || [[Baileys Irish Cream|Baileys]], etc.
|-
! colspan=3 | Crème
|-
! style="font-size:smaller;"| ''ALCOHOLTYPE''
! style="font-size:smaller;"| ''Links to the following article''
! style="font-size:smaller;"| ''Notes''
|-
| <samp>'''crème'''</samp> || [[List of liqueurs#Crème liqueurs|Crème liqueur]] || Generic term
|-
| <samp>cacao</samp> || [[Creme de cacao|Crème de Cacao]] || Also a ''chocolate liqueur''
|-
| <samp>menthe</samp> || [[Crème de menthe]] || &nbsp;
|-
! colspan=3 | Fruit or Berry
|-
| colspan=3 | Use one of the generic terms unless the specific brand is important.
|-
! style="font-size:smaller;"| ''ALCOHOLTYPE''
! style="font-size:smaller;"| ''Links to the following article''
! style="font-size:smaller;"| ''Notes''
|-
| <samp>'''berry'''</samp> || [[List of liqueurs#Berry liqueurs|Berry liqueur]] || Generic term
|-
| <samp>curaçao</samp> || [[Curaçao]] || &nbsp;
|-
| <samp>'''fruit'''</samp> || [[List of liqueurs#Fruit liqueurs|Fruit liqueur]] || Generic term
|-
| <samp>gmarnier</samp> || [[Grand Marnier]] || Also an ''brandy''
|-
| <samp>hpnotiq</samp> || [[Hpnotiq]] || Also a ''cognac''
|-
| <samp>midori</samp> || [[Midori liqueur|Midori]] || &nbsp;
|-
| <samp>'''orange'''</samp> || [[List of liqueurs#Fruit liqueurs|Orange-flavored liqueur]] || Generic term
|-
| <samp>pucker</samp> || [[Pucker]] || &nbsp;
|-
! colspan=3 | Herbal
|-
| colspan=3 | See also ''Anise'' above.
|-
! style="font-size:smaller;"| ''ALCOHOLTYPE''
! style="font-size:smaller;"| ''Links to the following article''
! style="font-size:smaller;"| ''Notes''
|-
| <samp>campari</samp> || [[Campari]] || &nbsp;
|-
| <samp>'''herbal'''</samp> || [[List of liqueurs#Other herbal liqueurs|Herbal liqueur]] || Generic term
|-
| <samp>jäger</samp> || [[Jägermeister]] || &nbsp;
|-
! colspan=3 | Nuts
|-
! style="font-size:smaller;"| ''ALCOHOLTYPE''
! style="font-size:smaller;"| ''Links to the following article''
! style="font-size:smaller;"| ''Notes''
|-
| <samp>amaretto</samp> || [[Amaretto]] || &nbsp;
|}

''You may also specify any other type of alcohol ("build your own"):''
<syntaxhighlight lang=moin> | other = [[Amaro (drink)|Amaro]]</syntaxhighlight>

''You may refer to the article itself (or any other text):''
<syntaxhighlight lang=moin> | other = See the article for details</syntaxhighlight>

==== served ====
:''This attribute applies only to mixed drinks.''
This attribute explains how the drink is typically served. If the drink is served in a variety of ways, you may leave this attribute blank or write your own brief description.

''Blended with ice ("frozen" style):''
<syntaxhighlight lang=moin> | served = blended</syntaxhighlight>

''"On the rocks"; poured over ice:''
<syntaxhighlight lang=moin> | served = rocks</syntaxhighlight>

''"[[Straight up (bartending)|Straight up]]"; without ice:''
<syntaxhighlight lang=moin> | served = straight</syntaxhighlight>

''"Neat"; undiluted and without ice:''
<div style="font-size: 90%; line-height: 100%; padding-left:12pt;">''Note: "Neat" is generally not proper for mixed drinks, because it essentially means that the alcohol is served without mixing it with anything else (the opposite of a mixed drink), and should only be used for certain "built" drinks like layered shooters.''</div>
<syntaxhighlight lang=moin> | served = neat</syntaxhighlight>

''Write your own description (may be multiple lines):''
<syntaxhighlight lang=moin> | served = Commonly served two ways:
* "On the rocks"; poured over ice
* Blended with ice ("frozen" style)
</syntaxhighlight>

==== garnish ====
:''This attribute applies only to mixed drinks.''
[[Cocktail garnish]]es are considered optional by some, and some bartenders and patrons have unconventional ways of garnishing their drinks. However, if there is a standard way of garnishing the drink (as is the case with [[IBA Official Cocktail]]s), then briefly list standard garnishes, linking where it makes sense.

''Write your own description (may be multiple lines):'' <syntaxhighlight lang=moin>| garnish = {{frac|1|2}} [[orange (fruit)|orange]] slice and [[maraschino cherry]]</syntaxhighlight>

==== drinkware ====
:''This attribute applies only to mixed drinks.''
As with garnishes, the standard type of [[drinkware]] (drinking glass, beer stein, etc.) varies from place to place, but there is usually one type of glass that is standard for any particular drink.

'''This section may be updated in the near future for increased flexibility, such as the possibility of adding multiple types of drinkware (for example, [[margarita]]s are commonly served in tumblers, welled margarita glasses, and margarita saucers). Other plans include providing standard measurements for the drinkware. So, for now, please pick only one type of drinkware from the list below, whichever seems most common or proper for the drink.'''

''Substitute the word '''TYPE''' in this example:'' <syntaxhighlight lang=moin> | drinkware = TYPE</syntaxhighlight>
''with one of the following types of drinkware:''

<gallery>
file:Absinthe glass, spoon and sugar.jpg|<samp>absinthe</samp><br/>[[Absinthe glass]]
file:Stein Glass (Beer).svg|<samp>beermug</samp><br/>[[Beer mug]]
file:16059820 F tn.jpg|<samp>beerstein</samp><br/>[[Beer stein]]
file:Beverage Glass (Tumbler).svg|<samp>beverage</samp><br/>[[Glass (drinkware)|Beverage glass (Tumbler)]]
file:Cocktail Glass (Martini).svg|<samp>cocktail</samp><br/>[[Cocktail glass]]
file:Irish Coffee Glass (Footed).svg|<samp>coffee</samp><br/>[[Irish coffee]] [[mug]]
file:Cooler Glass (Faceted).svg|<samp>cooler</samp><br/>[[Cooler glass]]
file:Cocktail Glass (Cosmopolitan).svg|<samp>cosmo</samp><br/>Cosmopolitan or [[cocktail glass]]
file:Cooler Glass (Tumbler).svg|<samp>collins</samp><br/>[[Collins glass]]
file:Cordial Glass (Footed).svg|<samp>cordial</samp><br/>[[Cordial glass]]
file:Glass02.jpg|<samp>coupe</samp><br/>[[Champagne coupe]]
file:Cup-o-coffee-simple.svg|<samp>cup</samp><br/>[[Coffee cup]]
file:Flute Glass.svg|<samp>flute</samp><br/>[[Champagne flute]]
file:Goblet Glass (Banquet).svg|<samp>goblet</samp><br/>[[Goblet]]
file:Highball Glass (Tumbler).svg|<samp>highball</samp><br/>[[Highball glass]]
file:Hurricane Glass.svg|<samp>hurricane</samp><br/>[[Hurricane glass]]
file:Iced Tea Glass (Tumbler).svg|<samp>icedtea</samp><br/>[[Iced tea glass]]
file:Margarita Glass (Welled).svg|<samp>margarita</samp><br/>[[Margarita glass]]
file:Margarita Glass (Saucer).svg|<samp>margaritas</samp><br/>[[Margarita glass]]
file:Irish Coffee Glass (Mug).svg|<samp>mug</samp><br/>[[Mug]]
file:Old Fashioned Glass.svg|<samp>old</samp><br/>[[Old fashioned glass]]
file:Pilsner Glass (Standard).svg|<samp>pilsner</samp><br/>[[Pilsner glass]]
file:Pint Glass (Mixing).svg|<samp>pint</samp><br/>[[Pint glass]]
file:Poco Grande.svg|<samp>poco</samp><br/>[[Poco Grande glass]]
file:Pint Glass (Pub).svg|<samp>pub</samp><br/>[[Pint glass|Pub glass]]
file:Rocks Glass (Standard).svg|<samp>rocks</samp><br/>[[Rocks glass]]
file:Rocks Glass (Double).svg|<samp>rocks2</samp><br/>[[Rocks glass|Rocks glass (double)]]
file:Goblet Glass (Schooner).svg|<samp>schooner</samp><br/>[[Schooner]]
file:Sherry Glass.svg|<samp>sherry</samp><br/>[[Sherry glass]]
file:Shooters Glass (Single).svg|<samp>shooter</samp><br/>[[Shooters glass]]
file:Shooters Glass (Double).svg|<samp>shooter2</samp><br/>[[Shooters glass|Shooters glass (double)]]
file:Shot Glass (Standard).svg|<samp>shot</samp><br/>[[Shot glass]]
file:Shot Glass (Marked).svg|<samp>shot2</samp><br/>[[Shot glass|Shot glass (double)]]
file:Snifter Glass (Brandy).svg|<samp>snifter</samp><br/>[[Snifter]]
file:Pilsner Glass (Hourglass).svg|<samp>wheat</samp><br/>[[Pilsner glass|Wheat beer glass]]
file:Wine Glass (Grande).svg|<samp>wineg</samp><br/>[[Wine glass#Grande|Wine glass (grande)]]
file:Wine Glass (Red).svg|<samp>winer</samp><br/>[[Wine glass#Red wines|Wine glass (red)]]
file:Wine Glass (White).svg|<samp>winew</samp><br/>[[Wine glass#White wines|Wine glass (white)]]
file:Zombie Glass.svg|<samp>zombie</samp><br/>[[Zombie (cocktail)|Zombie]] [[Glass (drinkware)|glass]]
</gallery>

;Special cases:
''Beer cocktails often call for both a pint (or pub) glass and a shot glass:''
<syntaxhighlight lang=moin> | drinkware = pintshot</syntaxhighlight>
<syntaxhighlight lang=moin> | drinkware = pubshot</syntaxhighlight>

''You could also write your own description, but due to planned changes in how this attribute works, it is not recommended:''
<syntaxhighlight lang=moin> | drinkware = See the article for details</syntaxhighlight>

==== ingredients ====
:''This attribute applies only to mixed drinks.''
* If the drink is an [[IBA Official Cocktail]], only the official ingredients should be listed.
* The IBA generally uses centilitres for measurements; leave them in cl's, but also include the relative "parts" in parentheses following the centilitre measurement and before the ingredient name.
* If using CocktailDB or DrinkBoy, use their standard recipe (be sure to include the ''source'' and ''sourcelink'' for proper attribution) and include the relative "parts" in parentheses.
* If using a different source, please use your best judgment in how to format the recipe (be sure to include the ''source'' and ''sourcelink'' for proper attribution).
* Link to each ingredient's Wikipedia article wherever it makes sense to do so. Do not worry about duplicating links elsewhere in the body of the article. Such duplicate links should generally be avoided because they can cause confusion, but in this case links inside the infobox are helpful rather than confusing.
* ''Do not'' list variations in this section. If there is a ''very'' common variation (like vodka in martinis), it is acceptable to mention that in the ''footnotes'' (or less desirably in the ''notes'' if the ''footnotes'' are used for something else); however no more than one or two such variations should be mentioned there. Use the main article to list less common variations.

''Write your own description (bulleted lists are preferred):''
<syntaxhighlight lang=moin> | ingredients = Please keep instructions very brief. Use IBA official ingredients if available.</syntaxhighlight>

==== prep ====
:''This attribute generally applies to mixed drinks and possibly garnishes.''
* If the drink is an [[IBA Official Cocktail]], only the official instructions should be given. Minor edits are acceptable (sometimes even desirable), but only if they do not alter or confuse any of the process of making the drink the IBA way.
* In all other cases, avoid multiple complete sentences, using very brief action phrases (e.g., "Pour whiskey then juice over ice; drizzle grenadine until streaks appear; garnish and serve.")
* Avoid linking within the preparation method, unless the term is not linked elsewhere in the infobox and would likely be helpful to the reader (tools and methods of preparation may need linking).

''Write your own description (may be multiple lines):''
<syntaxhighlight lang=moin> | prep = Please keep instructions very brief. Use IBA official instructions if available.</syntaxhighlight>

==== timing ====
:''This attribute applies only to mixed drinks.''
Indicate the conventional time at which the drink is generally consumed. Typical values are ''Before dinner'', ''After dinner'', and ''All day''
<syntaxhighlight lang=moin> |timing = Convention dictates the time at which certain drinks should be consumed.</syntaxhighlight>

==== notes ====
:''This attribute is primarily for drinkware and garnishes.''
Drinks should rarely, if ever use this attribute (just put the notes directly in the article).

Since most of the rest of the infobox is concerned with drinks, this attribute is a free-form place to note anything important concerning drinkware or garnishes.

''Write your own description (may be multiple lines):''
<syntaxhighlight lang=moin> | notes = Notes are primarily for drinkware and garnishes</syntaxhighlight>

==== footnotes ====
:''Applies to all types.''
Footnotes are printed in very small text, and are most useful for minor notes or clarifications of other information mentioned in the infobox.

''Write your own description (may be multiple lines):''
<syntaxhighlight lang=moin> | footnotes = Footnotes should generally be avoided</syntaxhighlight>

=== Examples ===
{| style="background:#F8FCFF; border:1px solid #2f6fab; color:black; padding:1em;"
|-
! style="text-align:left;"| This text
! style="text-align:right;"| Produces this result
|-
! colspan="2" style="background:paleturquoise;"| No attributes specified
|-
| style="vertical-align:top;"| 
<syntaxhighlight lang=moin>{{infobox cocktail}}</syntaxhighlight>
| style="vertical-align:top;"| 
{{infobox cocktail}}
|-
! colspan="2" style="background:paleturquoise;"| Unconfigured basic template
|-
| style="vertical-align:top;"| 
<syntaxhighlight lang=moin>{{infobox cocktail
| iba = 
| name = NAME
| image = 
| caption = 
| type = 
| flaming = 
| ALCOHOLTYPE = yes
| served = 
| garnish = 
| drinkware = 
| ingredients = 
| prep = 
| timing =
| notes = 
| footnotes = 
}}</syntaxhighlight>
| style="vertical-align:top;"|
{{infobox cocktail
| iba = 
| name = NAME
| image = 
| caption = 
| type = 
| flaming = 
| ALCOHOLTYPE = yes
| served = 
| garnish = 
| drinkware = 
| ingredients = 
| prep = 
| timing = 
| notes = 
| footnotes = 
}}
|-
! colspan="2" style="background:paleturquoise;"| [[Whiskey sour]], an [[IBA Official Cocktail]]
|-
| style="vertical-align:top;"| 
<syntaxhighlight lang=moin>{{Infobox cocktail
| iba = yes
| sourcelink = ws
| name = Whiskey Sour
| image = A whiskey sour in the hand.jpg
| caption = A typical whiskey sour in a non-standard glass.
| type = cocktail
| bourbon = yes
| served = rocks
| garnish = ½ [[orange (fruit)|orange]] slice and [[maraschino cherry]]
| drinkware = rocks
| ingredients = 
* 4.5 cl (3 parts) [[Bourbon whiskey]]
* 3.0 cl (2 parts) Fresh [[lemon]] juice
* 1.5 cl (1 part) [[Gomme syrup]]
* Dash [[egg white]] (optional)
| prep = Pour all ingredients into [[cocktail shaker]] filled with ice. Shake well. Strain in [[Old fashioned glass|old fashioned]] or [[cobbler glass]]. If served "on the rocks", strain ingredients into old fashioned glass filled with ice. Garnish with half orange slice and maraschino cherry.
| timing = Before dinner
}}</syntaxhighlight>
| style="vertical-align:top;"|
{{infobox cocktail
| iba = yes
| sourcelink = ws
| name = Whiskey Sour
| image = A whiskey sour in the hand.jpg
| caption = A typical whiskey sour in a non-standard glass.
| type = cocktail
| bourbon = yes
| served = rocks
| garnish = ½ [[orange (fruit)|orange]] slice and [[maraschino cherry]]
| drinkware = rocks
| ingredients = 
* 4.5 cl (3 parts) [[Bourbon whiskey]]
* 3.0 cl (2 parts) Fresh [[lemon]] juice
* 1.5 cl (1 part) [[Gomme syrup]]
* Dash [[egg white]] (optional)
| prep = Pour all ingredients into [[cocktail shaker]] filled with ice. Shake well. Strain in [[Old fashioned glass|old fashioned]] or [[cobbler glass]]. If served "on the rocks", strain ingredients into old fashioned glass filled with ice. Garnish with half orange slice and maraschino cherry.
| timing = Before dinner
}}
|-
! colspan="2" style="background:paleturquoise;"| [[Snakebite (beer cocktail)|Snakebite]], a [[beer cocktail]]
|-
|style="vertical-align:top;"|
<syntaxhighlight lang=moin>{{Infobox cocktail
| iba = 
| name = Snakebite
| image = 
| caption = 
| type = beer
| flaming = 
| beer = yes
| cider = yes
| served = straight
| garnish = 
| drinkware = pint
| ingredients = 
* 1 part [[lager]], [[ale]], or [[stout]]
* 1 part [[cider]]
| prep = Mix the beer and cider together, or float the beer atop the cider.
| notes = 
| footnotes = 
}}</syntaxhighlight>
|style="vertical-align:top;"|
{{infobox cocktail
| iba =
| name = Snakebite
| image =
| caption =
| type = beer
| flaming =
| beer = yes
| cider = yes
| served = straight
| garnish =
| drinkware = pint
| ingredients = 
* 1 part [[lager]], [[ale]], or [[stout]]
* 1 part [[cider]]
| prep = Mix the beer and cider together, or float the beer atop the cider.
| notes =
| footnotes =
}}
|-
! colspan="2" style="background:paleturquoise;"| [[Jellybean (cocktail)|Jellybean]], a [[cocktail]]
|-
|style="vertical-align:top;"|
<syntaxhighlight lang=moin>{{Infobox cocktail
| iba = 
| source = cocktaildb
| sourcelink = 3251
| name = Jellybean
| image = 
| caption = 
| type = cocktail
| flaming = 
| anise = yes
| canadian = yes
| served = rocks
| garnish = 
| drinkware = rocks
| ingredients = 
* 1 part (3/4 oz, 2 cl) [[Seagram]]'s VO
* 1 part (3/4 oz, 2 cl) [[Anisette ]]
| prep = Pour the drinks over ice.
| notes = 
| footnotes = 
}}</syntaxhighlight>
|style="vertical-align:top;"|
{{infobox cocktail
| iba = 
| source = cocktaildb
| sourcelink = 3251
| name = Jellybean
| image = 
| caption = 
| type = cocktail
| flaming = 
| anise = yes
| canadian = yes
| served = rocks
| garnish = 
| drinkware = rocks
| ingredients = 
* 1 part (3/4 oz, 2 cl) [[Seagram]]'s VO
* 1 part (3/4 oz, 2 cl) [[Anisette]]
| prep = Pour the drinks over ice.
| notes =
| footnotes =
}}
|-
|}
=== Microformats ===
{{UF-hrecipe}}
{{purge page}}
<includeonly>{{Sandbox other||
<!-- ADD CATEGORIES BELOW THIS LINE -->
[[Category:Drink infobox templates|Cocktail]]
[[Category:Beverages Task Force templates]]
}}</includeonly>