Help:Cite errors/Cite error references duplicate key
Help:Cite errors/Cite error references duplicate key
Jump to navigation
Jump to search
This help page is a how-to guide. It details processes or procedures of some aspect(s) of Wikipedia's norms and practices. It is not one of Wikipedia's policies or guidelines, as it has not been thoroughly vetted by the community. | .mw-parser-output .module-shortcutboxplain{float:right;border:1px solid #aaa;background:#fff;margin:0 0 0 1em;padding:.3em .6em .2em .6em;text-align:center;font-size:85%;font-weight:bold}.mw-parser-output .module-shortcutlist{display:inline-block;border-bottom:1px solid #aaa;margin-bottom:.2em;font-weight:normal}.mw-parser-output .module-shortcutanchordiv{position:relative;top:-3em} |
This page will help you to fix the cite error message:
Invalid <ref>
tag; name "$1" defined multiple times with different content (see the help page).
- If you need help with a particular problem, please discuss it on the article talk page or at the Help desk.
- 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.
Contents
1 Overview
2 Issues and resolution
2.1 Names
3 Sfn
4 Nested footnotes
5 Technical
5.1 Templates
Overview[edit]
If you are going to reference the same source multiple times, Wikipedia allows you to name those sources so you can just refer to a source named "foo" rather than having to recreate all of the details about the citation (the author, the title, etc.) over and over. The name is created like this:
<ref name="foo">content</ref>
Then, to invoke that footnote you have named foo, just type this:
<ref name="foo" />
The content (the details of the citation) of the reference that has been named "foo" is thus defined only once but can be reused over and over.
Issues and resolution[edit]
The error happens when a named reference is defined multiple times with different content. For example, first <ref name="foo">content1</ref>
and later <ref name="foo">content2</ref>
, where "foo"
is repeated but content1 and content2 are different. The purpose of named references is to be able to invoke them elsewhere with <ref name="foo" />
, but there must be a unique definition of the ref name "foo".
If the references with content1 and content2 are meant to be different then change one of the ref names, for example name="bar"
instead of name="foo"
. If the reference is not meant to be invoked elsewhere then it can also be made unnamed by removing name="foo"
, but this is not necessary.
If the references are meant to be the same then replace one of the definitions by <ref name="foo" />
to invoke the other definition. It may technically work to make two identical definitions but this should not be done. It causes confusion and will recreate the error if somebody later changes one of the definitions without making the same change to the other.
The error can also happen with empty ref names like <ref name="">content</ref>
or <ref name>content</ref>
. Ref names should not be empty. Either add a name or remove name=""
.
Ref names may be generated by a template and produce names not in the wikitext. For example, {{sfn|Stokes|1979|p=2}}
and {{sfn|Stokes|1979|pp=2}}
may both produce references of form <ref name="FOOTNOTEStokes19792">...</ref>
, causing the error message to use the ref name "FOOTNOTEStokes19792". p=
is intended for a single page and pp=
for a range. ps=
must have the same value in each use of {{sfn}}
where the other parameters are identical. An assigned value in ps=
cannot be combined with an omitted ps=
elsewhere on the page. If there is a blank ps=
then remove it.
See also Technical Templates below.
Whole references may be transcluded from other pages. When the "Edit" or "Edit source" tab at top of a page is clicked, the bottom of the window will say "Pages transcluded onto the current version of this page". Click the text if no list is shown. Articles are more likely than other pages to contain named references.
The ref name in the error message may have replaced spaces by underscores and converted some special characters.
Names[edit]
Names for footnotes and groups must follow these rules:
- Names are case-sensitive.
- Names must not be purely numeric; they should have semantic value so that they can be more easily distinguished from each other by human editors.
- Names must be unique—you may not use the same name to define different groups or footnotes.
- Please consider keeping reference names simple and restricted to the standard English alphabet and numerals. Failing that, including if spaces are used, the following technical restrictions become relevant:
- Quotation marks are optional if the only characters used are letters
A–Z
,a–z
, digits0–9
, and the symbols!$%&()*,-.:;<@^_`{|}~
. That is, all printable ASCII characters except#"'/=>?
. - Inclusion of any other characters, including spaces, requires that the reference name be enclosed in quotes; for example,
name="John Smith"
. - The quote marks must be the standard straight keyboard marks (
"
); curly or other quotes will be parsed as part of the reference name. - Quote-enclosed reference names may not include a less-than sign (
<
) or a double straight quote symbol ("
). These may be escaped with<
and"
, respectively.
- Quotation marks are optional if the only characters used are letters
- You may optionally provide reference names even when the reference name is not required. This makes later re-use of the sourced reference easier.
Sfn[edit]
If two or more calls to {{sfn}} use the same citation parameters, that is, if the author(s), year, and page number(s) are all identical, but there is some other difference, such as a use of pp= vs p=, or a use of ps= in one but not the other, this issue will arise.
The solution is to make the calls identical. If the ps= parameter was being used to include a quote or other extended content, use {{harvnb}} inside a <ref>...</ref>
construct with the quote after the template but inside the ref tag structure.
Nested footnotes[edit]
If there are nested footnotes, i.e. a reference within another reference, then the error can occur even if two definitions have identical text. Example where {{sfn}} will create a ref name with another reference inside it:
<ref name="Buna">Advance to Buna</ref>
{{sfn|Blakeley|1956|ps=. Cited in Advance to Buna.<ref name=Buna />}}
{{sfn|Blakeley|1956|ps=. Cited in Advance to Buna.<ref name=Buna />}}
Removing the inner reference will fix the error.
Technical[edit]
Pages with this error message are placed into Pages with duplicate reference names. The system message page is at Cite error references duplicate key.
Templates[edit]
Bug 37256
In order to include variable data within a reference tag such as <ref ref_content name=ref_name>
, the #tag
parser function must be used. Currently #tag
only supports balanced tags, not a singular tag, thus <tag_type element />
cannot normally be used in a template unless the element is hard coded.
However, Cite has been modified since 2008[1] to treat <ref name="ref-foo"></ref>
identically to <ref name="ref-foo" />
. Note that there cannot be even a space between the <ref . . .>
and the </ref>
, otherwise this will result in definition of the reference named "ref-foo" to be " ", which if meant to be second reference by name to an existing reference will cause a duplicate definition error. Correct code to produce a singular tag will look like {{#tag:ref ||name={{{parameter}}}}}
, that is, no space between the two "|"s.
^ Wikipedia:Village_pump_(technical)#.23tag_only_for_paired_tags_bug_workaround.3F
Categories:
- Wikipedia how-to
(window.RLQ=window.RLQ||).push(function(){mw.config.set({"wgPageParseReport":{"limitreport":{"cputime":"0.156","walltime":"0.212","ppvisitednodes":{"value":1389,"limit":1000000},"ppgeneratednodes":{"value":0,"limit":1500000},"postexpandincludesize":{"value":31130,"limit":2097152},"templateargumentsize":{"value":1161,"limit":2097152},"expansiondepth":{"value":10,"limit":40},"expensivefunctioncount":{"value":1,"limit":500},"unstrip-depth":{"value":0,"limit":20},"unstrip-size":{"value":1020,"limit":5000000},"entityaccesscount":{"value":0,"limit":400},"timingprofile":["100.00% 164.688 1 -total"," 45.20% 74.436 1 Template:Wikipedia_how-to"," 34.78% 57.274 1 Template:Ombox"," 16.17% 26.627 1 Template:Shortcut"," 13.20% 21.742 1 Help:Cite_errors/header"," 10.14% 16.705 1 Template:Wikipedia_referencing"," 8.70% 14.332 1 Template:Broken_ref"," 8.51% 14.014 1 Template:Navbox"," 8.47% 13.945 1 Template:See"," 8.21% 13.514 1 Template:Namespace_detect"]},"scribunto":{"limitreport-timeusage":{"value":"0.045","limit":"10.000"},"limitreport-memusage":{"value":1592592,"limit":52428800}},"cachereport":{"origin":"mw1322","timestamp":"20181030180523","ttl":1900800,"transientcontent":false}}});mw.config.set({"wgBackendResponseTime":96,"wgHostname":"mw1267"});});