Help:Cite errors/Cite error references missing key
This help page is a how-to guide. It explains concepts or processes used by the Wikipedia community. It is not one of Wikipedia's policies or guidelines, and may reflect varying levels of consensus. |
This page will help you to fix the cite error message:
A list-defined reference named "$1" is not used in the content (see the help page).
- If you have read this help page and find something missing or confusing, please discuss it at the main talk page.
- Please reference this page and the page where you have the problem so we can understand your issues.
- For basic information on the footnotes system, see Referencing for beginners; for advanced help, see Footnotes.
Overview
A footnote used multiple times may be defined with a name:
<ref name="foo">content</ref>
To invoke a named footnote:
<ref name="foo" />
References may also be defined within the reference list:
{{reflist|refs= <ref name=refname1>refcontent1</ref> <ref name=refname2>refcontent2</ref> <ref name=refname3>refcontent3</ref> <ref name=refname4>refcontent4</ref> }}
List-defined references may be invoked by the standard markup or by use of {{r}}.
Issues and resolution
All references defined in the reference list must be invoked in prior content. Unused references must be removed or commented out, or stripped of their <ref>...</ref>
tags and moved to another section, such as "Further reading".
Including more than one nested reference in List-defined references will cause a Cite error.
Misusing a template that was never intended as a citation template and placing it in <ref>
tags may cause this issue.
A template that creates <ref>
tags; known instances:
- {{Certification Cite Ref}}
- {{sfn}} and variants
- {{Single chart}}
A template that includes table markup; known instances:
Examples
The content of this message is dependent on the language setting in Special:Preferences. You can test how the error messages look in the most popular languages with these links: |
Ex. 1) There are three references defined in the list, but none are invoked in the content:
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. ==References== {{reflist|refs= <ref name=ipsum>Reference1</ref> <ref name=minim>Reference2</ref> <ref name=dolor>Reference3</ref> }}
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur.
Cite error: A list-defined reference named "ipsum" is not used in the content (see the help page).
Cite error: A list-defined reference named "minim" is not used in the content (see the help page).
The content of this message is dependent on the language setting in Special:Preferences. You can test how the error messages look in the most popular languages with these links: |
Ex. 2) A <ref name="..." />
tag is invoked after the reference list:
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. ==References== {{reflist|refs= <ref name=ipsum>Reference1</ref> }} <ref name=ipsum />
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur.
Ex. 3) Not so obvious case. If you mistakenly nest an {{sfn}} type template inside <ref>...</ref>
as in the second footnote below, an error message will show:
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.<ref>{{harvp|foo|1999|p=123}}</ref> Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur.<ref>{{sfnp|Foo|1999|p=123}}</ref> ==References== {{reflist}} *{{citation|last=foo|title=foobar|year=1999}}
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.[2] Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur.[3]
- ^ Cite error: The named reference
ipsum
was invoked but never defined (see the help page). - ^ Foo (1999), p. 123
- ^
- Foo (1999), Foobar
Technical
Pages with this error message are placed into Pages with incorrect ref formatting. The system message page is at Cite error references missing key.
Bugs
- T24635 Multiple problems with refs inside
<references>...</references>
blocks. - T26600 The first defined reference that is not invoked will show an incorrect error message.
- T22707 Nested refs fail inside references block
- T269531 Define a named ref in
<references>
without using this named ref results into a wrong error message