Help:Footnotes

This page explains how to create the Footnotes section for Wikipedia articles. In this context, the word "Footnotes" refers to the Wikipedia-specific manner of documenting an article's sources and providing tangential information, and should not be confused with the general concept of footnotes. This how-to does not cover the formatting of citations within the Footnotes section, which is reviewed in Citing sources.

Footnotes are used most commonly to provide:

references (bibliographic citations) to reliable sources,
explanatory information or
source information for tables and other elements.

The use of Footnotes is only one of several options for providing source information in the article. Other systems of inline citation, including {{sfnote}} and {{paren}}, may be used at the editor's discretion in accordance with the guideline on Variation in citation methods.

Only certain types of material on the English Wikipedia are required to have an inline citation. There is no requirement to provide a citation for every sentence, because multiple sentences may be supported by the same footnote. For advice on which material should be cited, see the guidelines on When you must use inline citations, the Good article criteria and When to cite. For advice on how to organize and format bibliographic citations, see the guideline on Citing sources and examples of Citation templates.

Footnotes are created using the {{cite.php}} software extension. This extension adds the HTML-like elements <ref>...</ref>, <references /> and <references>...</references>. The elements are also used in a number of templates; for example, it is becoming more common to use {{reflist}} rather than <references /> as it can style the reference list.

Overview

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: {{dummy ref}} {{dummy ref|a}} {{dummy ref|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. Hovering over a footnote marker will, depending on the user's settings, 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 {{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.

For a single use footnote, the label is followed by a caret (^) that is a backlink to the matching footnote marker. 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 backspace ← returns to the footnote marker.

Footnotes in action

This is a footnote marker.^[1]

↑ This is a footnote that contains a citation or note.

Footnotes: the basics

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:

Markup	Renders as
This is page content.<ref>LibreOffice For Starters, First Edition, Flexible Minds, Manchester, 2002, p. 18</ref> {{reflist}}	This is page content.^[1] ↑ LibreOffice For Starters, First Edition, Flexible Minds, Manchester, 2002, p. 18

The {{reflist}} template will be explained in the next section.

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.

Ref tags should follow any punctuation (usually a period), not precede it; see WP:REFPUNC. There should be no space between the punctuation and the tag:

Markup	Renders as
...text.<ref>Content of the reference</ref> {{reflist}}	...text.^[1] Right ↑ Content of the reference
...text<ref>Content of the reference</ref>. {{reflist}}	...text^[1]. Wrong (tag before punctuation) ↑ Content of the reference
...text. <ref>Content of the reference</ref> {{reflist}}	...text. ^[1] Wrong (space before tag) ↑ Content of the reference

The content of the ref tags can be formatted using most wikimarkup or HTML markup, although techniques such as the pipe trick and template substitution will not work in footnotes. For example:

Markup	Renders as
This is page content.<ref>''LibreOffice For Starters'', First Edition, Flexible Minds, Manchester, 2002, p. 18</ref> {{reflist}}	This is page content.^[1] ↑ LibreOffice For Starters, First Edition, Flexible Minds, Manchester, 2002, p. 18

The ref tag content may also contain an internal or external link:

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

Reference lists: the basics

Once any number of footnotes have been inserted into the content, the reference list must be generated. For the basic reference list, add {{reflist}} wherever the list is desired. Once the page is saved and viewed, the footnotes will be automatically generated and numbered and the reference list will be generated. On All The Tropes, DO NOT place the main reference list in a separate section, titled "References", "Notes" or anything else. ATT is not Wikipedia.

Markup	Renders as
This is page content.<ref>''LibreOffice For Starters'', First Edition, Flexible Minds, Manchester, 2002, p. 18</ref> {{reflist}}	This is page content.^[1] ↑ LibreOffice For Starters, First Edition, Flexible Minds, Manchester, 2002, p. 18

Notes

Shortcut: HELP:MULTIREF

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.
When editing, <references /> may be seen instead of {{reflist}}. This is valid, but <references /> does not offer the advanced features of {{reflist}}.

Footnotes: using a source more than once

MOD: This should almost never be required on All The Tropes, given that our Style Guide says to put the source inline in the trope or work example text if a source is required at all.

You can cite the same source more than once on a page by using named footnotes. The syntax to define a named footnote is:

<ref name="name">content</ref>

To invoke the named footnote:

<ref name="name" />

Markup	Renders as
This is page content.<ref name=manchester2002>''LibreOffice for Starters'', First Edition, Flexible Minds, Manchester, 2002, p. 18</ref> This is more content.<ref name=manchester2002 /> {{reflist}}	This is page content.^[1] This is more content.^[1] ↑ ^1.0 ^1.1 LibreOffice for Starters, First Edition, Flexible Minds, Manchester, 2002, p. 18

The actual name used can be almost anything, but it is recommended that it have a connection to 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:

Markup

Renders as

This is starter content.<ref name=manchester2002>''LibreOffice for Starters'', First Edition, Flexible Minds, Manchester, 2002, p. 18</ref> This is expert content.<ref name=lexington2004>''OpenOffice for Experts'', Lexington, 2004, p. 18</ref> And more starter content.<ref name=manchester2002 /> And more expert content.<ref name=lexington2004 />
{{reflist}}

This is starter content.^[1] This is expert content.^[2] And more starter content.^[1] And more expert content.^[2]

↑ ^1.0 ^1.1 LibreOffice for Starters, First Edition, Flexible Minds, Manchester, 2002, p. 18
↑ ^2.0 ^2.1 OpenOffice for Experts, Lexington, 2004, p. 18

When using both names and groups, the syntax is:

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

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

Reference lists: columns

Shortcut: H:REFCOLS

When using {{reflist}}, the list can be split into columns.

{{reflist|xxem}} where xx is the column width in em.

By setting the width in em, the number of columns will automatically be adjusted to the width of the display.

The set columns feature is now deprecated in favor of the options described above, which is better suited to flexible formatting for a variety of display screen sizes, ranging from mobile phones and tablets to wide-screen "cinema" displays. Forcing a fixed number of columns has been disabled in mobile view.

The number of columns to use is up to the editor, but some major practices include:

{{Reflist}} - 1 column (default): Where there are only a few {{fnote}}; see Silver State Arena (23:05, 28 December 2012)
{{Reflist|30em}}: Where there are many footnotes plus a page-width Bibliography subsection: see Ebola virus disease (06:28, 23 June 2013)
{{Reflist|20em}}: Where {{sfnote}} are used; see NBR 224 and 420 Classes (13:32, 1 August 2011).

For example: Using {{Reflist|30em}} will create columns with a minimum width of 30 em,

**30em wide columns**
Markup	Renders as
Lorem ipsum.<ref>Source name, access date, etc.</ref> Lorem ipsum dolor sit amet.<ref>Source name, access date, etc.</ref> ==References== {{Reflist\|30em}}	Lorem ipsum.^[1] Lorem ipsum dolor sit amet.^[2] References ↑ Source name, access date, etc. ↑ Source name, access date, etc.

List-defined references

MOD: This should almost never be required on All The Tropes, given that our Style Guide says to put the source inline in the trope or work example text if a source is required at all.

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 and avoids cluttering the text (and any infobox). This is purely a source code change {{snd}} 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:

{{reflist|refs=
<ref name=name1>Content</ref>
<ref name=name2>Content</ref>
<ref name=name...n>Content</ref>
}}

or, alternatively,

<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:

Markup Renders as

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==
{{reflist|
refs=
<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>
}}

The quick brown fox jumps over the lazy dog.^[1] Amazingly few discotheques provide jukeboxes.^[2] How razorback-jumping frogs can level six piqued gymnasts.^[3]

References

↑ Cite error: Invalid <ref> tag; no text was provided for refs named LazyDog
↑ Cite error: Invalid <ref> tag; no text was provided for refs named Jukeboxes
↑ Cite error: Invalid <ref> tag; no text was provided for refs named JumpingFrogs

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 reference list must be referenced in the content, otherwise an error message will be shown.

Footnotes: embedding references

MOD: This should almost never be required on All The Tropes, given that our Style Guide says to put the source inline in the trope or work example text if a source is required at all. Thus, we have not copied over the {{refn}} template.

Explanatory notes may need to be referenced. Because of limitations in the {{cite.php}} 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 template {{refn}} may be used to nest references. The markup is:

{{refn|name=name|group=group|content}} where name and group are optional. The content may include <ref> tags.

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.

Example:

Markup

Renders as

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

==Notes==
<div class="references-small" 
;">
</div>


==References==
<div class="references-small" 
;">
</div>

</nowiki>

The quick brown fox jumps over the lazy dog.Template:Refn

Notes

References

The use of the magic word #tag:ref is valid, but the sequence of parameters is invariant and nonintuitive. {{refn}} and its variants use this markup internally.

{{#tag:ref|refcontent|name=name|group=groupname}}

Footnotes: groups

Shortcuts: WP:REFGROUP WP:CITELABEL

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>

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

The syntax for the reference list with a group is:

{{reflist|group=groupname}}

The reference list group name does not need to be enclosed in quotes.

Example:

Markup

Renders as

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}}

This part of the text requires clarification,^{[note 1]} whereas the entire text is cited.^[1] And this needs even more clarification.^{[note 2]}

Notes

↑ Citation.

References

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 name=name group=groupname>Content</ref>

For the repeated note:

<ref name=name group=groupname />

Footnotes: predefined groups

Shortcuts: H:PREGROUP WP:EXPLNOTE

There are several predefined groups that can have a styled reference list such that the footnote labels match between the footnote marker and the footnote in the reference list. These predefined groups and reference lists have templates that make the markup simpler and also allow a standard reference to be inserted, so that an explanatory note can have a reference.

Group name	Footnote marker template or markup	Reference list template	Sample labels
none	`<ref>...</ref>`	`{{reflist}}`	1 2 3 4 5 6 7 8 9 10
none	`{{refn}}` for nested references	`{{reflist}}`	1 2 3 4 5 6 7 8 9 10
lower-alpha	`{{efn}}`	`{{notelist}}`	a b c d e f g h i j
upper-alpha	`{{efn-ua}}`	`{{notelist-ua}}`	A B C D E F G H I J
lower-roman	`{{efn-lr}}`	`{{notelist-lr}}`	i ii iii iv v vi vii viii ix x
upper-roman	`{{efn-ur}}`	`{{notelist-ur}}`	I II III IV V VI VII VIII IX X
lower-greek^{[lower-alpha 1]}	`{{efn-lg}}`	`{{notelist-lg}}`	α β γ δ ε ζ η θ ι κ

{{efn}} supports |name= and |group=, which work the same as the parameters in <ref>. Do not enclose values in quotes.
{{notelist}} supports the column parameter, |refs= and |group= which work the same as the parameters in {{reflist}}. Do not enclose values in quotes.

In these examples, the footnote labels match between the footnote marker and the reference list:

**With lower-alpha labels**
Markup	Renders as
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.^{[lower-alpha 2]} Consectetur adipisicing elit.^{[lower-alpha 3]} Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.^{[lower-alpha 4]}

With lower-roman labels

Markup

Renders as

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.^{[lower-roman 1]} Consectetur adipisicing elit.^{[lower-roman 2]} Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.^{[lower-roman 3]}

**With named references**
Markup	Renders as
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.^{[lower-alpha 5]} Consectetur adipisicing elit.^{[lower-alpha 6]} Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.^{[lower-alpha 5]}

With named references, the references are defined in the notelist

Markup

Renders as

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}}
}}

Lorem ipsum dolor sit amet.^{[lower-alpha 5]} Consectetur adipisicing elit.^{[lower-alpha 7]} Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.^{[lower-alpha 5]}

Issues

Multiple backlink labels are always styled as lower-alpha. This can be confusing when {{efn}} is used.
The entries in the reference list will show the default decimal styling if:
- The value for |group= in {{reflist}} or <references /> does not exactly match one of the predefined values; use {{efn}} or variant as |group= will not be needed.
- The value for |group= in {{reflist}} or <references /> is enclosed by quotes; use {{efn}} or variant as |group= will not be needed.
- {{reflist}} is indented with the : markup.
- <references /> is used instead of {{reflist}}
The entries in the reference list will have no styling if:
- A reference is included in {{navbox}} or one of the variants and the style is set to bodyclass=hlist; to resolve this, replace the style with listclass=hlist.
Including external link markup will result in an error. Use the {{URL}} template instead: {{URL|1=url name|2=optional display text}}.

Reference lists: automatically generated

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. Add it at the position where the reference list would normally appear.


{{reflist}}

Note the lack of a "==References==" header or a line before the reflist, as described in All The Tropes:Style Guide.

On talk pages, the {{reflist-talk}} template can be used to add a reference list to a specific discussion.

Footnotes: page numbers

ATT MOD: This should almost never be required on All The Tropes, given that our Style Guide says to put the source inline in the trope or work example text if a source is required at all. We don't even have (or want) the "cite book" template.

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, which requires the use of a References section following the footnotes section. Another approach is to attach a {{rp|8}} right after the footnote marker and replace the "8" with the appropriate page number.

For example:

Markup

Renders as

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 = http://books.google.com/books?id=aawMAQAAMAAJ
 | isbn =0-684-82729-8 }}</ref><nowiki>{{rp|8}} But elections in early American politics did not generate much interest^[1]{{rp|12}} while "open discussion of differences" was generally avoided.^[1]{{rp|18}} Citizenship later shifted to a polity of essentially "self-absorbed citizens", according to his analysis.^[1]{{rp|241}}

Schudson said the Constitution shaped citizenship in fundamental ways.^[1]{{rp|8}} But elections in early American politics did not generate much interest^[1]{{rp|12}} while "open discussion of differences" was generally avoided.^[1]{{rp|18}} Citizenship later shifted to a polity of essentially "self-absorbed citizens", according to his analysis.^[1]{{rp|241}}

References

↑ ^1.0 ^1.1 ^1.2 ^1.3 ^1.4 ^1.5 ^1.6 <nowiki>Template:Cite book

</nowiki>

When using list-defined references, {{r}} can be used for the same style of in-text page references.

Previewing edits

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 which were defined in other sections.

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

RefToolbar

MOD: This Wikipedia functionality is not available on All The Tropes.

Main article: Wikipedia:RefToolbar/2.0

Using the citation toolbar to insert additional references to the first source.

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.

Issues and limitations

{{cite.php|bug}}
subst: does not work within <ref> tags. {{phab|T4700}}
The pipe trick does not work within <ref> tags. {{phab|T4700}}

v t e Wikipedia help pages
A whole bunch of Wikipedia-specific links that might or might not apply to All The Tropes
About Wikipedia	Principles (Wikipedia in brief) Policies and guidelines What Wikipedia is not Disclaimer (parental advice) Making requests where to ask questions contact Wikipedia directly Who writes Wikipedia Why create an account?
Contributing to Wikipedia	A plain and simple overview A primer for newcomers (getting started) Asking for help Advice for young editors Avoiding common mistakes Etiquette (community expectations) Learning the ropes Instructional material Simplified Manual of Style Simplified rule-set "Ignore all rules" "The rules are principles" Tip of the day Your first article (article wizard) Vandalism VisualEditor
Introductions	Editing Exploring Images Manual of Style Media Navigating Policies Referencing Tables Talk pages
Tutorials	Newcomers' welcome The Wikipedia Adventure Editing Formatting Graphics Images IRC (live chat) Links Policies Registration Sources Talk pages VisualEditor
Frequently asked questions (FAQ)	Overview Administration Article subjects Categories Contributing Copyright Editing Forking IRC (live chat) Miscellaneous Organizations Problems Researching Readers Schools Technical
Help: Contents	Help menu Navigating Joining Editing Links and references Images and media Tracking changes Policies and guidelines Asking questions Wikipedia community Resources and lists Account settings Technical info Site map
The Missing Manual	Introduction First edit Sourcing Account setup and personal space Creating articles Page history and reverting Monitoring changes Vandalism and spam Communicating with others WikiProjects Content disputes Incivility Helping others Sections Lists and tables Images Naming, redirects and disambiguation Categorizing Better articles Deletions Personal preferences JavaScript Wikipedia Pages Reader’s guide Learning more
How-to pages Information pages	Appealing blocks Article deletion Books Categories Citations / references Referencing for beginners Citation Style 1 Cite errors References and page numbers Copyright Diff Editing toolbar edit conflict Email confirmation Find sources Files Footnotes Glossary Image deletion Infoboxes Linking (link color) Logging in Media Merging Mobile access Namespaces Navigation Other languages Page name Redirect Renaming pages Passwords Reverting Searching Talk pages (archiving) Students URL User contributions
Coding wiki markup	Wiki markup (cheatsheet) Barcharts Calculations Characters Citation templates Columns HTML Lists Magic words (introduction) Music symbols Sections Sounds Tables (introduction) Templates documentation messages Transclusion Visual files Wiki tools
Reference desks	Computing Entertainment Humanities Language Mathematics Miscellaneous Science
Noticeboards	Administrators edit warring incidents vandalism Conflict of interest Disputes Editor help External links Neutrality Original research Sources Page moves Village pump idea lab proposals technical Wikipedia policies miscellaneous
Directories	Abbreviations Content Departments Editor's index Essays FAQs Glossary Guidelines Help:contents Manual of Style contents Policies Portals Shortcuts Tips
Click here to waste time asking for help on your talk page from a non-existent volunteer

Overview

Footnotes in action

Footnotes: the basics

Reference lists: the basics

Footnotes: using a source more than once

Reference lists: columns

List-defined references

Footnotes: embedding references

Footnotes: groups

Footnotes: predefined groups

Reference lists: automatically generated

Footnotes: page numbers

Previewing edits

RefToolbar

Issues and limitations

See also