((High-use))

Citation Style 1 templates
((Cite arXiv))arXiv preprints
((Cite AV media))audio and visual media
((Cite AV media notes))AV media liner notes
((Cite bioRxiv))bioRxiv preprints
((Cite book))books and chapters
((Cite CiteSeerX))CiteSeerX papers
((Cite conference))conference papers
((cite document))short, stand-alone, offline documents
((Cite encyclopedia))edited collections
((Cite episode))radio or TV episodes
((Cite interview))interviews
((Cite journal))academic journals
((Cite magazine))magazines, periodicals
((Cite mailing list))public mailing lists
((Cite map))maps
((Cite medRxiv))medRxiv preprints
((Cite news))news articles
((Cite newsgroup))online newsgroups
((Cite podcast))podcasts
((Cite press release))press releases
((Cite report))reports
((Cite serial))audio or video serials
((Cite sign))signs, plaques
((Cite speech))speeches
((Cite SSRN))SSRN papers
((Cite tech report))technical reports
((Cite thesis))theses
((Cite web))web sources not covered by the above
See alsoSpecific-source templates
Citation Style 1 wrapper templates

This Citation Style 1 template is used to create citations for articles or chapters in edited collections such as encyclopedias and dictionaries, but more generally any book or book series containing individual sections or chapters written by various authors, and put together by one or more editors. However, it is not intended for journals or magazines, which are issued periodically and have volume and (usually) issue numbers, and should be cited with ((Cite journal)); nor is it intended for conference proceedings, which should be cited with ((Cite conference)).

Some citations to tertiary sources such as encyclopedias are problematic; see Wikipedia:Identifying and using tertiary sources.

Usage

Copy a blank version to use. Almost all parameter names are supported only in lower case (some initialisms, such as |isbn= have upper-case aliases like |ISBN=, which are acceptable for use). Use the "|" (pipe) character between each parameter. Unused parameters may be deleted to avoid clutter in the edit window. Some samples on this documentation page may include the current date. If the date is not current, then purge the page.


Most commonly used parameters in horizontal format
((cite encyclopedia |title= |encyclopedia= |date= |year= |last= |first= |publisher= |location= |id= |url= |access-date= ))


Full parameter set in horizontal format
((cite encyclopedia |last= |first= |author-link= |editor-last= |editor-first= |editor-link= |encyclopedia= |title= |trans-title= |url= |access-date= |language= |edition= |date= |year= |publisher= |series= |volume= |location= |id= |isbn= |issn= |oclc= |doi= |page= |pages= |archive-url= |archive-date= |url-status= |quote= |ref= ))


Most commonly used parameters in vertical format
((cite encyclopedia
 |title= 
 |encyclopedia= 
 |date= 
 |year= 
 |last= 
 |first= 
 |publisher= 
 |location= 
 |id= 
 |url= 
 |access-date=
))


Full parameter set in vertical format
Vertical list Prerequisites Brief instructions / notes
((cite encyclopedia
  | last = 
  | first = 
  | author-link = 
  | editor-last = 
  | editor-first = 
  | editor-link = 
  | encyclopedia = 
  | title = 
  | trans-title = 
  | url = 
  | access-date = 
  | language = 
  | edition = 
  | date = 
  | year = 
  | publisher = 
  | series = 
  | volume = 
  | location = 
  | id = 
  | isbn = 
  | oclc = 
  | doi = 
  | pages = 
  | archive-url = 
  | archive-date = 
  | url-status =
  | quote = 
  | ref = 
))
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Examples










This text uses uncommon-term_1[1] and uncommon-term-2[2] that require references in a dictionary and we don't want to cite the dictionary twice.

References

  1. ^ Wordsmith 2021, uncommon-term-1.
  2. ^ Wordsmith 2021, uncommon-term-2.

Parameters

Syntax

Nested parameters rely on their parent parameters:

Where aliases are listed, only one of the parameters may be defined; if multiple aliased parameters are defined, then only one will show.

By default, sets of fields are terminated with a period (.).

COinS

This template embeds COinS metadata in the HTML output, allowing reference management software to retrieve bibliographic metadata. See Wikipedia:COinS. As a general rule, only one data item per parameter. Do not include explanatory or alternate text:

Use of templates within the citation template is discouraged because many of these templates will add extraneous HTML or CSS that will be included raw in the metadata. Also, HTML entities, for example  , –, or  , should not be used in parameters that contribute to the metadata.

COinS metadata is created for these parameters

Note: This table of metadata is displayed in the documentation of all Citation Style 1 templates. Not all of these parameters are supported by every CS1 template. Some of these parameters are mutually exclusive, some are aliases of another parameter, and some require other parameters to be present. A full list of this template's supported parameters, their aliases, and their dependencies is shown in the Usage section near the top of this documentation page.

What's new

What's new or changed recently
Parameter Description Date
N/A

Deprecated

Deprecated CS1/CS2 parameters
Deprecated parameter Replace with Date
|authors= |lastn= / |firstn=, |authorn=, |vauthors= November 2023
Recently removed CS1/CS2 parameters
Removed parameter Replace with Date Note
|lay-date= (delete) August 2023
|lay-source= (delete)
|lay-url= (delete)
|transcripturl= |transcript-url= August 2023

Description

Authors

Title

(See also Help:Citation Style 1 § Titles and chapters.)

Titles containing certain characters will not display and link correctly unless those characters are encoded.
newline [ ] |
space [ ] ((!)) (preferred)
((bracket|text)) | or ((pipe))see also Help:Table § Rendering the pipe
  • title-link: Title of existing Wikipedia article about the source named in title – do not use a web address; do not wikilink.

(See also Help:Citation Style 1 § Titles and chapters.)

Titles containing certain characters will not display and link correctly unless those characters are encoded.
newline [ ] |
space [ ] ((!)) (preferred)
((bracket|text)) | or ((pipe))see also Help:Table § Rendering the pipe
  • title-link: Title of existing Wikipedia article about the source named in title – do not use a web address; do not wikilink.
Aliases: title, article

Date

"Wikipedia:Undated" redirects here. For undated signatures, see Template:Undated.

Shortened footnotes target full citations using the year specified in this parameter. A lowercase letter may be suffixed to the year to disambiguate ((sfn)) links to multiple works by the same author in the same year,[more] unless the date is formatted as YYYY-MM-DD. In the latter case, year or ref is required to disambiguate the link targets.
For approximate year, precede with "c. ", like this: |date=c. 1900.

For no date, or "undated", use |date=n.d.
The date of a Web page, PDF, etc. with no visible date can sometimes be established by searching the page source or document code for a created or updated date; a comment for editors such as date=2021-12-25<!--date from page source-->|orig-date=Original date 2011-01-01 can be added.
Automatic date formatting: Citation Style 1 and 2 templates, including this template, automatically render dates in all date parameters (such as |date=, |publication-date=, |access-date=, |archive-date=, etc.) except for |orig-date= in the style specified by the article's ((use dmy dates)) or ((use mdy dates)) template. See those templates' documentation for details.
  1. ^ Publication dates in references within an article should all have the same format. This may be a different format from that used for archive and access dates. See MOS:DATEUNIFY.

Publisher

Edition, series, volume

In-source locations

URL

URLs must begin with a supported URI scheme. http:// and https:// will be supported by all browsers; however, ftp://, gopher://, irc://, ircs://, mailto: and news: may require a plug-in or an external application and should normally be avoided. IPv6 host-names are currently not supported.

If URLs in citation template parameters contain certain characters, then they will not display and link correctly. Those characters need to be percent-encoded. For example, a space must be replaced by %20. To encode the URL, replace the following characters with:

Character space " ' < > [ ] { | }
Encoding %20 %22 %27 %3C %3E %5B %5D %7B %7C %7D

Single apostrophes do not need to be encoded; however, unencoded multiples will be parsed as italic or bold markup. Single curly closing braces also do not need to be encoded; however, an unencoded pair will be parsed as the double closing braces for the template transclusion.

  1. ^ a b Access-date and archive-date in references should all have the same format – either the format used for publication dates, or YYYY-MM-DD. See MOS:DATEUNIFY.

Anchor

Identifiers

The following identifiers create links and are designed to accept a single value. Using multiple values or other text will break the link and/or invalidate the identifier. In general, the parameters should include only the variable part of the identifier, e.g. |rfc=822 or |pmc=345678.

In very rare cases, valid identifiers (f.e., as actually printed on publications) do not follow their defined standard format or use non-conforming checksums, which would typically cause an error message to be shown. Do not alter them to match a different checksum. In order to suppress the error message, some identifiers (|doi=, |eissn=, |isbn=, |issn=, and |sbn=) support a special accept-this-as-written markup which can be applied to disable the error-checking (as |<param>=((<value>))). If the problem is down to a mere typographical error in a third-party source, correct the identifier value instead of overriding the error message.

For some identifiers, it is possible to specify the access status using the corresponding |<param>-access= parameter.

For ((cite journal)), some identifiers (specifying free resources) will automatically be linked to the title when |url= and |title-link= are not used to specify a different link target. This behaviour can be overridden by one out of a number of special keywords for |title-link= to manually select a specific source (|title-link=pmc or |title-link=doi) for auto-linking or to disable the feature (|title-link=none).

It is not necessary to specify a URL to a link identical to a link also produced by an identifier. The |url= parameter (or |title-link=) can then be used for providing a direct deep link to the corresponding document or a convenience link to a resource that would not otherwise be obviously accessible.

Quote

Editors

Lay summary

((csdoc|lay))

Display options

Subscription or registration required

Citations of online sources that require registration or a subscription are acceptable in Wikipedia as documented in Verifiability § Access to sources. As a courtesy to readers and other editors, editors should signal restrictions on access to material provided via the external links included in a citation. These levels describe requirements or constraints related to accessing and viewing the cited material; they are not intended to indicate the ability to reuse, or the copyright status, of the material, since that status is not relevant to verifying claims in articles.

Four access levels can be used:

As there are often multiple external links with different access levels in the same citation, each value is attributed to a specific external link.

Access indicators for url-holding parameters

Main page: WP:CONLINK

Online sources linked by |url=, |article-url=, |chapter-url=, |contribution-url=, |entry-url=, |map-url=, and |section-url= are presumed to be free-to-read. When they are not free-to-read, editors should mark those sources with the matching access-indicator parameter so that an appropriate icon is included in the rendered citation. Because the sources linked by these URL-holding parameters are presumed to be free-to-read, they are not marked as free. If the registration/limited/subscription access to the source goes dead and is no longer available, then remove the access-indicator parameter and add |archive-url= and |archive-date= values if possible.

URL-holding and access-indicator parameters
URL Access Allowed keywords
|url= |url-access= registration Free registration required
limited Free access subject to limited trial, subscription normally required
subscription Paid subscription required
|article-url= |article-url-access=
|chapter-url= |chapter-url-access=
|contribution-url= |contribution-url-access=
|entry-url= |entry-url-access=
|map-url= |map-url-access=
|section-url= |section-url-access=

For example, this cites a web page that requires registration but not subscription:

((cite web |url=https://example.com/nifty_data.php |url-access=registration |date=2021-04-15 |title=Nifty example data))

which renders as:

"Nifty example data". 2021-04-15.
Access indicator for named identifiers

Links inserted by named identifiers are presumed to lie behind a paywall or registration barrier – exceptions listed below. When they are free-to-read, editors should mark those sources with the matching access-indicator parameter so that an appropriate icon is included in the rendered citation. When the sources linked by these named-identifier parameters are not presumed to carry a free-to-read full text (for instance because they're just abstracting services), they may not be marked as limited, registration, or subscription.

Named-identifier and access-indicator parameters
Identifier Access Allowed keywords
|bibcode= |bibcode-access= free Freely accessible
|doi= |doi-access=
|hdl= |hdl-access=
|jstor= |jstor-access=
|ol= |ol-access=
|osti= |osti-access=
|ssrn= |ssrn-access=
|s2cid= |s2cid-access=

Some named-identifiers are always free-to-read. For those named identifiers there are no access-indicator parameters; the access level is automatically indicated by the template. These named identifiers are:

For embargoed pmc that will become available in the future, see pmc-embargo-date.

TemplateData

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. See a monthly parameter usage report for Template:PK2 in articles based on its TemplateData.

TemplateData for PK2

Error: cs1|2 template name required

This template formats a citation to an article or chapter in an edited collection such as an encyclopedia or dictionary, but more generally to any book or book series containing individual sections or chapters written by various authors, and put together by one or more editors.

Template parameters

ParameterDescriptionTypeStatus
Year of publicationyear

Year of the source being referenced; use 'date' instead, if month and day are also known

Stringoptional
Source titletitle

The title of the article or entry in the encyclopedia; displays in quotes

Stringrequired
Encyclopediaencyclopedia encyclopaedia dictionary

Title of the source; may be wikilinked; displays in italics; alias of 'work'

Stringsuggested
Publisherpublisher institution

Name of the publisher; displays after title

Stringoptional
Location of publicationlocation place

Geographical place of publication; usually not wikilinked; omit when the publication name includes place; alias of 'place'

Stringoptional
idid ID

A unique identifier used where none of the specialized ones are applicable

Stringoptional
URLurl URL

The URL of the online location where the text of the publication can be found

Stringoptional
URL access dateaccess-date

The full date when the original URL was accessed; do not wikilink

Stringoptional
Last namelast

The surname of the author; don't wikilink, use 'author-link'; can suffix with a numeral to add additional authors

Stringsuggested
First namefirst

Given or first name, middle names, or initials of the author; don't wikilink, use 'author-link'; can suffix with a numeral to add additional authors

Stringsuggested
Source datedate

Full date of the source; do not wikilink

Stringoptional
Author linkauthor-link author-link1 author1-link

Title of existing Wikipedia article about the author; can suffix with a numeral to add additional authors

Page nameoptional
Othersothers

Used to record other contributions to the work, such as 'Illustrated by John Smith' or 'Translated by John Smith'

Stringoptional
Original dateorig-date orig-year

Original year of publication; provide specifics

Stringoptional
Editor last nameeditor-last editor editor-surname editor-last1 editor-surname1 editor1 editor1-last editor1-surname

The surname of the editor; don't wikilink, use 'editor-link'; can suffix with a numeral to add additional editors

Unknownoptional
Editor first nameeditor-first editor-given editor-first1 editor-given1 editor1-first editor1-given

Given or first name, middle names, or initials of the editor; don't wikilink, use 'editor-link'; can suffix with a numeral to add additional editors

Unknownoptional
Editor linkeditor-link

Title of existing Wikipedia article about the editor; can suffix with a numeral to add additional editors; alias of 'editor1-link'

Page nameoptional
Place of publicationpublication-place

Publication place shows after title; if 'place' or 'location' are also given, they are displayed before the title prefixed with 'written at'

Stringoptional
Publication datepublication-date

Date of publication when different from the date the work was written; do not wikilink

Stringoptional
Editionedition

When the publication has more than one edition; for example: '2nd', 'Revised' etc.; suffixed with ' ed.'

Stringoptional
Seriesseries version

When the source is part of a series, such as a book series where the issue numbering has restarted; alias of 'version'

Stringoptional
Volumevolume

For one publication published in several volumes

Stringoptional
Pagepage p

Page in the source that supports the content; displays after 'p.'

Stringoptional
Pagespages pp

Pages in the source that support the content (not an indication of the number of pages in the source; displays after 'pp.'

Stringoptional
No ppno-pp

Set to 'y' to suppress the 'p.' or 'pp.' display with 'page' or 'pages' when inappropriate (such as 'Front cover')

Stringoptional
Atat

May be used instead of 'page' or 'pages' where a page number is inappropriate or insufficient

Stringoptional
Languagelanguage lang

The language in which the source is written, if not English; use the full language name; do not use icons or templates

Stringoptional
Translated titletrans-title

An English language title, if the source cited is in a foreign language; 'language' is recommended

Stringoptional
Typetype

Additional information about the media type of the source; format in sentence case

Stringoptional
Formatformat

Format of the work referred to by 'url'; examples: PDF, DOC, XLS; do not specify HTML

Stringoptional
arXiv identifierarxiv

An identifier for arXive electronic preprints of scientific papers

Stringoptional
ASINasin

Amazon Standard Identification Number; 10 characters

Stringoptional
ASIN TLDasin-tld

ASIN top-level domain for Amazon sites other than the US

Stringoptional
Bibcodebibcode

Bibliographic Reference Code (REFCODE); 19 characters

Stringoptional
DOIdoi DOI

Digital Object Identifier; begins with '10.'

Stringoptional
DOI broken datedoi-broken-date

The date that the DOI was determined to be broken

Stringoptional
ISBNisbn ISBN isbn13 ISBN13

International Standard Book Number; use the 13-digit ISBN where possible

Stringoptional
ISSNissn ISSN

International Standard Serial Number; 8 characters; may be split into two groups of four using a hyphen

Stringoptional
jfm codejfm JFM

Jahrbuch über die Fortschritte der Mathematik classification code

Stringoptional
JSTORjstor JSTOR

JSTOR identifier

Stringoptional
LCCNlccn LCCN

Library of Congress Control Number

Stringoptional
MRmr MR

Mathematical Reviews identifier

Stringoptional
OCLCoclc OCLC

Online Computer Library Center number

Stringoptional
OLol OL

Open Library identifier

Stringoptional
OSTIosti OSTI

Office of Scientific and Technical Information identifier

Stringoptional
PMCpmc PMC

PubMed Center article number

Stringoptional
PMIDpmid PMID

PubMed Unique Identifier

Stringoptional
RFCrfc RFC

Request for Comments number

Stringoptional
SSRNssrn SSRN

Social Science Research Network

Stringoptional
ZBLzbl ZBL

Zentralblatt MATH journal identifier

Stringoptional
Archive URLarchive-url

The URL of an archived copy of a web page, if or in case the URL becomes unavailable; requires 'archive-date'

Stringoptional
Archive datearchive-date

Date when the original URL was archived; do not wikilink

Stringoptional
Quotequote quotation

Relevant text quoted from the source; displays last, enclosed in quotes; needs to include terminating punctuation

Stringoptional
Refref

An anchor identifier; can be made the target of wikilinks to full references; special value 'harv' generates an anchor suitable for the harv template

Stringoptional
Postscriptpostscript

The closing punctuation for the citation; ignored if 'quote' is defined

Default
.
Stringoptional
Lay URLlay-url

URL link to a non-technical summary or review of the source; alias of 'lay-summary'

Stringoptional
Lay sourcelay-source

Name of the source of the laysummary; displays in italics, preceded by an en dash

Stringoptional
Lay datelay-date

Date of the summary; displays in parentheses

Stringoptional
Author maskauthor-mask

Replaces the name of the first author with em dashes or text; set to a numeric value 'n' to set the dash 'n' em spaces wide; set to a text value to display the text without a trailing author separator; for example, 'with' instead

Stringoptional
Display authorsdisplay-authors display-subjects

number of authors to display before 'et al.' is used; default is to do so after 8 of 9 are listed; alias of 'displayauthors'

Default
8
Numberoptional
Last name 2last2 author2 surname2 author-last2 author2-last subject2

The surname of the second author; don't wikilink, use 'author-link2'; can suffix with a numeral to add additional authors

Stringoptional
First name 2first2 given2 author-first2 author2-first

Given or first name, middle names, or initials of the second author; don't wikilink, use 'author-link'; can suffix with a numeral to add additional authors

Stringoptional
Last name 3last3 author3 surname3 author-last3 author3-last subject3

The surname of the third author; don't wikilink, use 'author-link3'.

Stringoptional
First name 3first3 given3 author-first3 author3-first

Given or first name, middle names, or initials of the third author; don't wikilink.

Stringoptional
Last name 4last4 author4 surname4 author-last4 author4-last subject4

The surname of the fourth author; don't wikilink, use 'author-link4'.

Stringoptional
First name 4first4 given4 author-first4 author4-first

Given or first name, middle names, or initials of the fourth author; don't wikilink.

Stringoptional
Last name 5last5 author5 surname5 author-last5 author5-last subject5

The surname of the fifth author; don't wikilink, use 'author-link5'.

Stringoptional
First name 5first5 given5 author-first5 author5-first

Given or first name, middle names, or initials of the fifth author; don't wikilink.

Stringoptional
Last name 6last6 author6 surname6 author-last6 author6-last subject6

The surname of the sixth author; don't wikilink, use 'author-link6'.

Stringoptional
First name 6first6 given6 author-first6 author6-first

Given or first name, middle names, or initials of the sixth author; don't wikilink.

Stringoptional
Last name 7last7 author7 surname7 author-last7 author7-last subject7

The surname of the seventh author; don't wikilink, use 'author-link7'.

Stringoptional
First name 7first7 given7 author-first7 author7-first

Given or first name, middle names, or initials of the seventh author; don't wikilink.

Stringoptional
Last name 8last8 author8 surname8 author-last8 author8-last subject8

The surname of the eighth author; don't wikilink, use 'author-link8'.

Stringoptional
First name 8first8 given8 author-first8 author8-first

Given or first name, middle names, or initials of the eighth author; don't wikilink.

Stringoptional
Last name 9last9 author9 surname9 author-last9 author9-last subject9

The surname of the ninth author; don't wikilink, use 'author-link9'. If nine authors are defined, then only eight will show and 'et al.' will show in place of the last author.

Stringoptional
First name 9first9 given9 author-first9 author9-first

Given or first name, middle names, or initials of the ninth author; don't wikilink.

Stringoptional
name-list-stylename-list-style

no description

Unknownoptional

See also

((UF-COinS))