Help:Footnotes

The Footnotes system shows two elements on the page:

• A Footnote marker is displayed in the article's content as a bracketed, superscripted number, letter, or word. Examples shown respectively are: ^{[1][a][Note 1]}. This footnote label is linked to the full footnote. Clicking on the footnote marker jumps the page down to the footnote and highlights the citation. If you are using the desktop site and have Javascript enabled, then hovering your cursor over a footnote marker (or touching it on touch devices) will show a pop-up box containing the footnote.
• A Footnote displays the full citation for the source. Together the footnotes are displayed in an ordered list wherever the reference list markup <references /> or {{reflist}} is placed. Each entry begins with the footnote label in plain text. The entire reference list is formatted in a slightly smaller font.

Each successive footnote label is automatically incremented. Thus the first footnote marker would be ^[1], the second would be ^[2] and so on. Custom labels are also incremented: ^[a][b][c], ^{[Note 1] [Note 2] [Note 3]}.

For a single-use footnote, the label is followed by a caret (^) that is a backlink to the matching footnote marker. For example:

If a named footnote is used in the text multiple times, then the footnote has multiple backlinks shown as letters:

Clicking on the backlink or pressing Alt+← returns to the footnote marker.

To create the footnote marker, determine the point in the page content where the marker is desired and enter the markup with the citation or note inside the <ref>...</ref> tags. For example:

This is page content.<ref>''LibreOffice For Starters'', First Edition, Flexible Minds, Manchester, 2002, p. 18</ref>
{{reflist}}

The {{reflist}} template will be explained in the next section; <references /> can also be used.

The content inside the <ref>...</ref> will show in the reference list. The ref tags can be added anywhere a citation or note is needed. There must be content inside the tags, else an error will show.

...text.<ref>Content of the reference</ref>
{{reflist}}

...text<ref>Content of the reference</ref>.
{{reflist}}

...text. <ref>Content of the reference</ref>
{{reflist}}

This is page content.<ref>''LibreOffice For Starters'', First Edition, Flexible Minds, Manchester, 2002, p. 18</ref>
{{reflist}}

This is page content.<ref>''[http://www.example.org LibreOffice For Starters]'', First Edition, Flexible Minds, Manchester, 2002, p. 18</ref>
{{reflist}}

Once any number of footnotes have been inserted into the content, the reference list must be generated. For the basic reference list, add <references /> or {{reflist}} wherever the list is desired. Once the page is published and viewed, the footnotes will be automatically generated and numbered and the reference list will be generated. The main reference list is placed in a separate section, usually titled "References", "Notes" or the like.

This is page content.<ref>''LibreOffice For Starters'', First Edition, Flexible Minds, Manchester, 2002, p. 18</ref>

==References==
{{reflist}}

Notes

• In some cases, a page has more than one reference list. Until 2014, multiple uses of {{reflist}} on the same page required use of a |close= parameter; that bug has been fixed and the|close= parameter may safely be removed.

You can cite the same source more than once on a page by using named references, also called named footnotes. Using the example name of "manchester2002", the syntax to define a named footnote is:

<ref name="manchester2002">text of full reference</ref> is the full "named" reference and used only once.

To invoke the named reference:

<ref name="manchester2002" /> is the short version that is used other places in the article.

Names for footnotes and groups must follow these rules:

• Names are case-sensitive. Please do not use raNdOM capitalization.
• Names must not be purely numeric; the software will accept something like ":31337" (which is punctuation plus a number), but it will ignore "31337" (purely numeric).
• Names should have semantic value, so that they can be more easily distinguished from each other by human editors who are looking at the wikitext. This means that ref names like "Nguyen 2010" are preferred to names like ":31337".
• Names must be unique. You may not use the same name to define different groups or footnotes. Try to avoid picking a name that someone else is likely to choose for a new citation, such as ":0" or "NYT".
• Please consider keeping reference names short, simple, and restricted to the standard English alphabet and numerals. If spaces are used, the following technical restrictions become relevant:
  • Quotation marks are preferred but optional if the only characters used are letters A–Z, a–z, digits 0–9, and the symbols !$%&()*,-.:;<@[]^_`{|}~. That is, all printable ASCII characters except #"'/=>?\ and space.
  • Inclusion of any other characters, including spaces, requires that the reference name be enclosed in quotes; for example, name="John Smith". But quote-enclosed reference names may not include a less-than sign (<) or a double straight quote symbol ("), which may, however, be included by escaping as < and " respectively.
  • The quote marks must be the standard, straight, double quotation marks ("); curly or other quotes will be parsed as part of the reference name.
• You may optionally provide reference names even when the reference name is not required. This makes later re-use of the sourced reference easier.

Note that the colon-followed-by-numeral names, like ":0", are currently generated by default in VisualEditor. They should be improved by replacement, using unique information from the citation, such as author and date of publication. For example, change ":0" to "manchester2002", or even better, an exact date, such as "manchester_12/14/2002". Scientific publications and the Yadkard tool always use unique ref names based on the last name(s) of the author(s) and the full publication date.

This is page content.<ref name="manchester2002">{{cite book|title=LibreOffice for Starters|edition=First|publisher=Flexible Minds|location=Manchester|year=2002|p=18}}</ref> This is more content.<ref name="manchester2002" />
{{reflist}}

The actual name used can be almost anything, but it is recommended that it have information derived from the citation or note. A common practice is to use the author-year or publisher-year for the reference name. This helps editors remember the name by associating it with the information that is visible to the reader.

Note that the footnote labels are incremented in the order they are used, and that they use the same label when reused, thus the labels can seem out of order:

This is starter content.<ref name="manchester2002">{{cite book|title=LibreOffice for Starters|edition=First|publisher=Flexible Minds|location=Manchester|year=2002|p=18}}</ref> This is expert content.<ref name="lexington2004">{{cite book|title=OpenOffice for Experts|publisher=Lexington|year=2004|p=18}}</ref> And more starter content.<ref name="manchester2002" /> And more expert content.<ref name="lexington2004" />
{{reflist}}

When using both names and groups, the syntax is:

<ref group="groupname" name="name">Content</ref>

Care should be taken when deleting references to avoid creating a cite error. See Avoiding common mistakes.

Footnote lists generated by {{Reflist}} or <references /> automatically split into columns if there are 10 or more items. The number of columns adjusts responsively to the width of the display, which can range from mobile phones and tablets to wide-screen "cinema" displays.

The CSS "column-width" property is by default set at 25–30 em depending on the skin. Browsers interpret this as a minimum width suggestion; if there is leftover space that cannot be used by an additional column, columns may render wider. This property can be adjusted with {{reflist}} or {{refwidth}}. {{refwidth}} only allows three settings, "short", "medium", and "long". For example:

==References==
{{refwidth|short}}
<references />

{{reflist}} allows this property to be set directly. To accommodate different fonts and zoom settings, this should always be done in em and not pixels. For example, to make narrow columns similar to the "short" setting:

==References==
{{reflist|20em}}

The "short" or "20em" setting is commonly used for shortened footnotes, but not for Citation Style 1. For a shortened footnote example, see NBR 224 and 420 Classes (13:32, 1 August 2011).

Setting a specific number of columns in reflist now no longer actually sets the "column-count" CSS property; instances of {{reflist|2}} or {{reflist|3}} can be replaced with the default behavior or variant requesting a specific column width. Given the range of reader screen sizes, fixing the number of columns would result in wasted space for some readers and overly narrow columns for others.

Some or all of the footnotes can also be defined within the reference section/list, and invoked in the page content. This keeps those citations in one central location for easier maintenance and avoids cluttering the text. This is purely a source code change – the actual display of the citation in the text to a reader is unaffected.

For a more detailed evaluation of this method, see WP:LDRHOW. The syntax is:

<references>
<ref name="name1">Content</ref>
<ref name="name2">Content</ref>
<ref name="name...n">Content</ref>
</references>

The footnote markers are included as usual for a named footnote. For example:

The quick brown fox jumps over the lazy dog.<ref name="LazyDog"/>
Amazingly few discotheques provide jukeboxes.<ref name="Jukeboxes"/>
How razorback-jumping frogs can level six piqued gymnasts.<ref name="JumpingFrogs"/>

==References==
<references>
<ref name="Jukeboxes">This is the jukeboxes reference.</ref>
<ref name="LazyDog">This is the lazy dog reference.</ref>
<ref name="JumpingFrogs">This is the jumping frogs reference.</ref>
</references>

The references will be numbered, and appear in the output, in the order that they are first referred to in the content, regardless of their order within the list. All references in the reference list must be referenced in the content, otherwise an error message will be shown.

Although the template {{Reflist}} with |refs= parameter also supports list-defined references, its use is deprecated as it is not supported by the VisualEditor.

Explanatory notes may need to be referenced. Because of limitations in the Cite software, reference tags cannot be nested; that is, a set of <ref>...</ref> tags cannot be placed inside another pair of <ref>...</ref> tags. Attempting to do so will result in a cite error.

The templates {{r}} and {{refn}} can be used to nest references. The markup is:

{{refn|group=group|name=name|content}} or

{{r|group=group|name=name|refn=content}} or

{{r|g=group|n=name|r=content}} (shorter)

name and group being optional parameters. The content may include <ref> tags or another {{r}} template.

The other templates listed below in Predefined groups are variants of {{refn}} that include a styled group and have a matching styled reference list template.

Examples:

The quick brown fox jumps over the lazy dog.{{refn|group=nb|A footnote.<ref>A reference for the footnote.</ref>}}

==Notes==
{{reflist|group=nb}}

==References==
{{reflist}}

The quick brown fox jumps over the lazy dog.{{r|g=nb|r=A footnote.{{r|r=A reference for the footnote.}}}}

==Notes==
{{reflist|group=nb}}

==References==
{{reflist}}

Sometimes it is useful to group the footnotes into separate lists, for example to separate explanatory notes from references, or to list references for tables, image captions, infoboxes and navboxes. The sequence of footnote labels is independent in each group.

The syntax to define a footnote with a group is:

<ref group=groupname>Content</ref>

If the footnote marker group name includes a space, the group name must be enclosed in quotes, else a cite error will occur. Otherwise, quotes are optional.

The syntax for the reference list with a group is:

{{reflist|group=groupname}}

or:

<references group="groupname">

Example:

This part of the text requires clarification,<ref group=note>Listed separately from the citation</ref> whereas the entire text is cited.<ref>Citation.</ref> And this needs even more clarification.<ref group=note>Another note</ref>

==Notes==
{{reflist|group=note}}

==References==
{{reflist}}

Note that the footnote labels in the reference list show only the numbers and not the group name.

When using both names and groups, the syntax is:

<ref group="groupname" name="name">Content</ref>

For the repeated note:

<ref group="groupname" name="name" />

There are several predefined groups that can have a reference list styled so that the label (a superscripted character within square brackets, e.g., ^[1]) of an explanatory note or citation (a.k.a. footnote, reference) matches and links to the note marker label located in the main text and the label in front of the note's text in the appropriate group's list. There can be more than one of these groups' lists in the Notes, References and other similarly purposed sections.

These predefined note and citation groups have templates that make the wikitext markup simpler. These templates also allow a standard reference to be inserted, so that an explanatory note can have a reference, or citations can be nested.

Note: If the note's text has a reference name that is used more than once, the labels will still match, but the clickable alpha characters (superscript lowercase letters like ^{a b c}) will be next to the note's label, with links to the multiple locations of its marker in the main text. See WP:REFNAME and the first point below in § Issues.

Lorem ipsum dolor sit amet.{{efn|Footnote 1}} Consectetur adipisicing elit.{{efn|Footnote 2}} Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.{{efn|Footnote 3}}

{{notelist}}

Lorem ipsum dolor sit amet.{{efn-lr|Footnote 1}} Consectetur adipisicing elit.{{efn-lr|Footnote 2}} Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.{{efn-lr|Footnote 3}}

{{notelist-lr}}

Lorem ipsum dolor sit amet.{{efn|group=lower-roman|Footnote 1}} Consectetur adipisicing elit.{{efn|lower-alpha|Footnote 2}} Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.{{efn|group=lower-roman|Footnote 3}}

Notes: 
{{notelist|group=lower-roman}}
Refs: 
{{notelist|group=lower-alpha}}

Lorem ipsum dolor sit amet.{{efn|name=fn1|Footnote 1}} Consectetur adipisicing elit.{{efn|Footnote 2}} Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.{{efn|name=fn1}}

{{notelist}}

Lorem ipsum dolor sit amet.{{efn|name=fn1}} Consectetur adipisicing elit.{{efn|name=fn2}} Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.{{efn|name=fn1}}

{{notelist|refs=
{{efn|name=fn1|Very long footnote 1}}
{{efn|name=fn2|Very long footnote 2}}
}}

<references group="lower-alpha">
<ref name="name1">Content</ref>
<ref name="name2">Content</ref>
</references>

A page with <ref> tags but no reference list markup used to display an error, except on talk and user pages. In recent versions of Wikipedia, the error no longer appears; instead an automatically generated reference list (AGRL) is displayed at the bottom of the page.

Compared to the reference lists on properly formatted pages, an AGRL can be confusing to both readers and editors. But it is easily corrected by adding reference list markup such as the following:

==References==
{{reflist}}

Add it at the position where the reference list would normally appear:

==See also==
==Notes==
==References==
{{reflist}}
==External links==

Suppose you would like to cite one book, but different facts appear on different pages. You would like to cite the book again and again, but point each fact to the proper page. Suppose one fact is on page 8, a different fact on page 12, a third fact on page 18, a fourth fact on page 241. You could put a line in the "pages" parameter saying "see pages 8, 12, 18, 241" but a fact-checker might have to check all of them before figuring out the right one. Or, you could duplicate the entire citation for the book in each instance, but that would be redundant.

One common approach is to use shortened citations. The long citation to support the shortened citations can either be placed as a bullet point in a separate References section after the Footnotes section; or it can be placed in the first footnote to cite the source (with the initial relevant page number[s]). The remaining footnotes will use shortened citations (these usually contain the author's last name, the date of publication, and the relevant page number[s]).

A less common approach is to attach a {{rp|page}} right after the footnote marker replacing the "page" with the appropriate page number or numbers. For example:

Schudson said the Constitution shaped citizenship in fundamental ways.<ref name="Schudson">{{Cite book |last=Schudson |first=Michael |title=The Good Citizen: A Brief History of American Civic Life |publisher=Simon & Schuster |date=1998 |url=https://books.google.com/books?id=aawMAQAAMAAJ |isbn=0-684-82729-8}}</ref>{{rp|8}} But elections in early American politics did not generate much interest<ref name="Schudson"/>{{rp|12}} while "open discussion of differences" was generally avoided.<ref name="Schudson"/>{{rp|18}} Citizenship later shifted to a polity of essentially "self-absorbed citizens", according to his analysis.<ref name="Schudson"/>{{rp|241-3}}

{{r}} compactly combines the functions of <ref> and {{rp}}: {{r|Schudson}} is equivalent to <ref name="Schudson"/> and {{r|Schudson|p=241-3}} is equivalent to <ref name="Schudson"/>{{rp|241-3}}.

When you edit a single section of a page, the footnotes list will be visible when you preview your edits under the heading "Preview of references", although you will still not be able to see named references whose definition is outside the section you are editing.

Tools that can be used are the user:js/ajaxPreview or User:Anomie/ajaxpreview.js scripts or the wikEd gadget.

You can use the citation toolbar to name references. When you first create a reference, you can enter a value in the "Ref name" box. When you want to reuse this reference, click the "Named references" button on the citation toolbar and choose which reference you would like to insert.

• Cite bug list
• subst: does not work within <ref> tags. T4700
• The pipe trick does not work within <ref> tags. T4700

• The template {{Refimprove}} should be added to articles where there are some, but insufficient, inline citations to support the material currently in the article. For biographies of living persons, use {{BLP sources}} instead.
• The template {{Unreferenced}} should be added to articles with no references at all. For biographies of living persons, use {{BLP unsourced}} instead.
• The template {{Unreferenced section}} is for individual sections that have no citations in articles that have at least one citation somewhere else. For biographies of living persons, use {{BLP unsourced section}} instead.
• The template {{Medref}} is specifically for articles needing additional medical references.

• Template:Harvard citation#Using CITEREF directly and {{sfnref}}
• Wikipedia:Citing sources/Further considerations—a how-to article with some additional considerations for citing sources
• Wikipedia:Help desk—to ask questions about using footnotes in articles if you were not able to find the information you need on this help page.
• Template:Editor tools—{{Editor tools}}
• mw:Help:Cite—Mediawiki documentation of the <ref>...</ref> and <references /> tags.
• For details on what CSS is available to style reference list output, the source code and CSS styles for {{reflist}} and {{refwidth}} may be helpful.