Template:Cs1

Template:Short description Template:Wikipedia how to Template:Nutshell Template:Notice Citation Style 1 (CS1) is a collection of reference citation templates that can be modified to create different styles for different referenced materials. Its purpose is to provide a set of default formats for references on Wikipedia. It includes a series of templates that in turn use Module:Citation/CS1.

The use of CS1 or of templates is not compulsory; per WP:CITESTYLE:

Wikipedia does not have a single house style. Editors may choose any option they want; one article need not match what is done in other articles or what is done in professional publications or recommended by academic style guides. However, citations within a given article should follow a consistent style.

WP:CITEVAR additionally states:

CS1 uses (in addition to Wikipedia's own Manual of Style) elements of The Chicago Manual of Style and the Publication Manual of the American Psychological Association, with significant adaptations.

Style

There are a number of templates that use a name starting with cite; many were developed independently of CS1 and are not compliant with the CS1 style. There are also a number of templates that use one of the general use templates as a meta-template to cite a specific source.

To be compliant with CS1, a template must:

• Use Module:Citation/CS1 or one of the templates listed below.
• Use a period as a punctuation mark to separate fields and end the citation.
• Use a semicolon as a punctuation mark to separate authors and editors.
• Format the title of longer works in italics.
• Format the title of short works such as chapters in quotes.

Templates

General use

The following is a list of templates that implement Citation Style 1 for one or more types of citations but are not restricted to any specific source.

Template:Yes	Indicates that the corresponding tool or gadget can generate the template anytime user wishes. However, this does not mean that the tool or gadget fully supports all parameters or provides an interface for them. In fact, none of the mentioned items do so.
Template:Partial	Indicates that the corresponding tool or gadget may or may not generate the corresponding template. For more information, see associated footnote.

General use CS1 templates

Template	Use	Citoid	Citation expander	RefToolbar 2.0	ProveIt	SnipManager
Template:Tl	arXiv preprints
Template:Tl	audio and visual sources				Template:Yes	Template:Yes
Template:Tl	liner notes from albums, DVDs, CDs and similar audio-visual media
Template:Tl	books	Template:Yes	Template:Yes	Template:Yes	Template:Yes	Template:Yes
Template:Tl	conference papers				Template:Yes
Template:Tl	edited collections				Template:Yes
Template:Tl	television or radio programs and episodes				Template:Yes
Template:Tl	interviews
Template:Tl	academic and scientific papers and journals	Template:Yes	Template:Yes	Template:Yes	Template:Yes	Template:Yes
Template:Tl	magazines and newsletters				Template:Yes
Template:Tl	archived public mailing lists
Template:Tl	maps
Template:Tl	news articles in print, video, audio or web	Template:Yes	Template:Partial Template:Elucidate	Template:Yes	Template:Yes	Template:Yes
Template:Tl	online newsgroups
Template:Tl	audio or video podcast
Template:Tl	press releases				Template:Yes
Template:Tl	unpublished reports by government departments, instrumentalities, operated companies, etc.				Template:Yes
Template:Tl	audio or video serials
Template:Tl	signs, plaques and other visual sources				Template:Yes
Template:Tl	speeches
Template:Tl	technical reports
Template:Tl	theses				Template:Yes
Template:Tl	web sources not characterized by another template	Template:Yes	Template:Yes	Template:Yes	Template:Yes	Template:Yes

Specific source

There are a number of templates that are CS1 compliant, because they use a CS1 template as a base, but are tied to a specific source; these are listed in Category:Citation Style 1 specific-source templates.

How the templates work

CS1 uses a series of templates that provide a consistent output. The main difference is in parameters optimized for the subject. For example, Template:Tl has fields for title and chapter, whereas Template:Tl has fields for journal and title.

This help page uses the names most commonly used across the templates series; see each template's documentation for details.

CS1 templates present a citation generally as:

• With author:

Template:Cite journal

• Without author:

Template:Cite journal

(where "n.d." could also be any other valid date formatted per the MOS)

Authors

An author may be cited using separate parameters for the author's surname and given name by using Template:Para and Template:Para respectively. If a cited source has multiple authors, subsequent authors can be listed in the citation using Template:Para and Template:Para, Template:Para and Template:Para, etc. For symmetry with the other numbered parameters, Template:Para and Template:Para are available as well, as shown in the following example:

{{cite book |last1=Hawking |first1=Stephen |last2=Hawking |first2=Lucy |title=George's Secret Key to the Universe}}

Template:Cite book

For symmetry with similar parameters for editors and other contributors (discussed further below), longer parameter forms are also available for authors: Template:Para and Template:Para, as well as numbered variants like Template:Para and Template:Para or Template:Para and Template:Para (with n referring to this author's number in the list). Because the shorthand parameters might erroneously have been used also for editors and other types of contributors by some Wikipedians in the past, please make sure that the parameters actually refer to authors when expanding Template:Para and Template:Para parameters to their longer equivalents (equivalent parameters for editors etc. exist as well, see below).

If a cited source has a large number of authors, one can limit the number of authors displayed when the citation is published by using the Template:Para parameter as described in detail in the Display options section of this help page.

If a cited author is notable and the author has a Wikipedia article, the author's name can be linked with Template:Para. If a citation includes multiple notable authors, one may use Template:Para or Template:Para etc. This method is used because the Template:Para- and Template:Para-type parameters do not allow wikilinking. However, Template:Para cannot be used to link to an external website; the external link will not render correctly. Below is an example of a wikilinked author credit:

{{cite book |author-last1=Hawking |author-first1=Stephen |author-link1=Stephen Hawking |author-last2=Hawking |author-first2=Lucy |title=George's Secret Key to the Universe}}

Template:Cite book

When an author is cited, the date of the cited work is displayed after the author's name, as shown in the example below:

{{cite book |author-last1=Hawking |author-first1=Stephen |author-link1=Stephen Hawking |author-last2=Hawking |author-first2=Lucy |title=George's Secret Key to the Universe |date=2007}}

Template:Cite book

If no author is cited, the date appears after the title, as shown in the example below:

{{cite book |title=George's Secret Key to the Universe |date=2007}}

Template:Cite book

If the cited source does not credit an author, as is common with newswire reports, press releases or company websites use:

Template:Para

This HTML comment alerts fact-checking and citation-fixing editors, and potentially bots, that the cited source did not name an author—the author was not overlooked. Without this entry editors and bots would waste time researching cited sources for a non-existent author credit.

When using Template:Para avoid citations like {{cite news |work=Weekday Times |author=''Weekday Times'' editors |title=...}}, unless the article is on a field in which the majority of professional journals covering that field use such a citation style.

Editors should use an Template:Para organizational citation when the cited source, such as a committee report, specifically names an official body or a sub-unit of the publisher as the collective author of the work, e.g. Template:Para or Template:Para. Do not use Template:Para to assert what you think was probably the collective author when the source itself does not specifically specify a collective author; doing so is original research and falsification of source verifiability and reliability.

Template:Para should never hold the name of more than one author. Separate individual authors into enumerated individual Template:Para parameters.

Editors

An editor may be cited using separate parameters for the editor's last and first name. A single or first editor would use Template:Para and Template:Para; subsequent editors would use Template:Para and Template:Para, Template:Para and Template:Para, etc.

If an editor has a Wikipedia article, you may wikilink to that Wikipedia article using Template:Para. If a cited work has multiple editors, you may use Template:Para, Template:Para, etc. to wikilink to each editor's Wikipedia article. This method is used because Template:Para and Template:Para do not allow wikilinking. Template:Para cannot be used to link to an external website.

If a cited source has a large number of editors, one can limit the number of editors displayed when the citation is published using the Template:Para parameter as described in detail in the Display options section of this help page.

Translators

A translator may be cited using separate parameters for the translator's last and first name. A single or first translator would use Template:Para and Template:Para; subsequent translators would use Template:Para and Template:Para, Template:Para and Template:Para, etc.

If a translator has a Wikipedia article, you may wikilink to that Wikipedia article using Template:Para. If a cited work has multiple translators, you may use Template:Para, Template:Para, etc. to wikilink to each translator's Wikipedia article. This method is used because Template:Para and Template:Para do not allow wikilinking. Template:Para cannot be used to link to an external website.

Others

• others: This parameter is used to credit contributors other than an author or an editor, such as an illustrator. You should include both the type of contribution and the name of the contributor, for example Template:Para.

Dates

Dates are indicated by these parameters:

• date: Full date of publication edition being referenced, in the same format as other dates in citations in the same article. Must not be wikilinked.
  • or: year: Year of publication edition being referenced. Discouraged in favor of date, except in the rare case that Template:Em of the following conditions are met:
    1. the publication-date format in the template is YYYY-MM-DD
    2. the citation requires a CITEREF disambiguator
    3. the template uses Template:Para or Template:Para or the template is Template:Tlx
• orig-year: Original publication year, for display (in square brackets) after the date (or year). For clarity, please supply specifics, for instance |orig-year=first published 1859 or |orig-year=composed 1904. This parameter displays only if there is a value for date (or year).

When a source does not have a publication date, use Template:Para or Template:Para

Acceptable date formats are shown in the "Acceptable date formats" table of the Template:Section link. Further points:

• Prescriptions about date formats only apply when the date is expressed in terms of Julian or Gregorian dates, or which use one of the seasons (spring, summer, autumn or fall, winter). Sources are at liberty to use other ways of expressing dates, such as "spring/summer" or a date in a religious calendar; editors should report the date as expressed by the source. Although the seasons are not normally capitalized, they are capitalized when used as dates in CS1 templates, and the capitalization of the season stated by the source may be altered to follow this convention. In cases where the date as expressed in the source is not compatible with the template software, the citation should be created without using a template.
• Do not wikilink.
• Access and archive dates in references should be in either the format used for publication dates, or YYYY-MM-DD.

Date compliance with Wikipedia's Manual of Style

CS1 uses Template:Section link (MOS:DATEFORMAT) as the reference for all date format checking performed by Module:Citation/CS1. For various reasons, CS1 is not fully compliant with MOS:DATEFORMAT. This table indicates CS1 compliance with the listed sections of MOS:DATEFORMAT.

CS1 compliance with Wikipedia:Manual of Style/Dates and numbers

section	compliant	comment
Acceptable date formats table	yes	Exceptions: linked dates not supported; sortable dates not supported (Template:Tlx etc.); proper name dates not supported with the exception of 'Christmas YYYY'; shortened month names longer than three characters or with terminating periods not supported
Unacceptable date formats table	yes
Consistency	yesTemplate:Dagger	Article-level restrictions are beyond the scope of CS1 Template:DaggerCS1/CS2 templates follow the format specified by the article's Template:Tlx or Template:Tlx templates; see Auto-formatting citation template dates
Strong national ties to a topic	no
Retaining existing format	no
Era style	no	Dates earlier than 100 not supported. Wikipedia does not treat ancient manuscripts as sources that can be cited directly; a specific, modern, published edition is what goes in the source citation. Thus, the date of the source actually consulted should be provided in Template:Para, and the date of the ancient source may be provided in Template:Para; the format of the orig-year value is not checked for errors.
Julian and Gregorian calendars	limited	Julian prior to 1582; Gregorian from 1582; assumes Gregorian in the overlap period of 1582 – c. 1923
Ranges	yes	Exceptions: does not support the use of – or   does not support dates prior to 100; does not support solidus separator (/) does not support " to " as a date separator does not support YYYY–YY where the two-digit year is less than 13 (change to YYYY–YYYY to eliminate the error message)
Uncertain, incomplete, or approximate dates	yes	Exceptions: does not support Template:Tlx or Template:Tlx; does not support dates prior to 100; Supports c. only with a single year value (no ranges or day/month combinations).
Days of the week	no
Seasons	limited	CS1 capitalizes seasons used as dates in citations, in line with external style guides
Decades	no
Centuries and millennia	no
Abbreviations for long periods of time	no

Date range, multiple sources in same year

If dates are used with the |ref=harv parameter, the year range is 100 to present without era indication (AD, BC, CE, BCE). In the case where the same author has written more than one work in the same year, a lower-case letter may be appended to the year in the date parameter (Template:Xt) or the year parameter (Template:Xt).

Auto-formatting citation template dates

Template:Use dmy dates Citation Style 1 and 2 templates automatically render dates (Template:Para, Template:Para, Template:Para, etc.) in the style specified by the article's Template:Tlx or Template:Tlx template. Because it is allowed by WP:MOSDATES, the CS1/CS2 templates can automatically format dates in a variety of styles. Editors may choose how CS1/CS2 templates render dates by the use of Template:Para in the article's Template:Tld template.<section begin=auto_date_format_table />

acceptable Template:Pipecs1-dates= keywords

keyword	definition
l	long-form publication and access- / archive-dates; this is the default case when Template:Para is omitted or empty
ll
ls	long-form publication dates; abbreviated access- / archive-dates
ly	long-form publication dates; year-initial numeric access- / archive-dates (ymd)
s	abbreviated publication and access- / archive-dates
ss
sy	abbreviated publication dates; year-initial numeric access- / archive-dates (ymd)
y	year-initial numeric publication, access- and archive-dates (ymd); cs1|2 cannot reformat Month YYYY, Season YYYY, date-ranges of any form, or Julian calendar dates into ymd format
yy

<section end=auto_date_format_table />

Example: to have the CS1/CS2 templates in an article render their publication dates in the long form (fully spelled-out month names) with access-/archive-dates rendered in short form (abbreviated month names), write:

Template:Tlx

This documentation page has {{use dmy dates|date=November 2024|cs1-dates=y}} at the top of this section so this cs1 template will render with ymd dates:

{{cite web |title=Example Webpage |url=//example.com |website=Example |date=31 October 2017 |access-date=Dec 5, 2017}}

{{#invoke:citation/CS1|citation

|CitationClass=web }}

This global setting may be overridden in individual CS1/CS2 templates by use of Template:Para; abbreviated date forms are not supported by Template:Para.

Template:Lang: CS1/CS2 auto-date formatting does not apply when previewing an article section that does not contain a Template:Tld template.

Titles and chapters

• title The title of the cited source. Titles are displayed in italics, except for short works such as a Template:Txl and cited articles in Template:Tlx, Template:Tlx, Template:Tlx, Template:Tlx, Template:Tlx, and Template:Tlx, where the title is shown in quotation marks. Use title case unless the cited source covers a scientific, legal or other technical topic and sentence case is the predominant style in journals on that topic. Use either title case or sentence case consistently throughout the article. Do not omit a leading "The" from the title. Subtitles are typically separated from titles with ": " though " – " is also used. As with trademarks, Wikipedia Template:Em attempt to emulate any stylistic flourishes used by the cited source's publisher, such as ALL-CAPS, all-lower-case, Template:Sm, etc.; use either standard title case or sentence case consistently. If the cited source is itself notable and has a Wikipedia article, the title can be wikilinked. Wikilinking the title will make it impossible to use the "url" parameter to link to an external copy of the cited source, so only do this when citing works that do not need to be externally linked. A link to the actual source is preferred to a link to a Wikipedia article about the source.
• script-title: Languages that do not use a Latin-based alphabet, Arabic, Chinese, Cyrillic, Greek, Hebrew, Japanese, Korean, etc., should not be italicized and may also read right-to-left (rtl). To include titles in these languages, use script-title. Titles in script-title are wrapped in special HTML markup to isolate rtl script from adjacent left-to-right text. Part of that special markup is a language attribute that browsers can use to assist in the proper display of the script. Editors may add a prefix to the script that will identify the language. The prefix is an ISO 639-1 two-character language code followed by a colon: Template:Para. Unrecognized codes are ignored and will display in the rendered citation.
• trans-title: If the cited source is in a foreign language, an English translation of the title can be given here. This field will be displayed in square brackets after the title and will be linked to Template:Para if used.
• chapter The title of the cited chapter from the source, written in full. Displayed in quotes before the title. For websites arranged in sections the "at" parameter serves a similar function: Template:Para
• script-chapter: Languages that do not use a Latin-based alphabet, Arabic, Chinese, Cyrillic, Greek, Hebrew, Japanese, Korean, etc., may possibly read right-to-left (rtl). To include chapter titles in these languages, use script-chapter. Chapter titles in script-chapter are wrapped in special HTML markup to isolate rtl script from adjacent left-to-right text. Part of that special markup is a language attribute that browsers can use to assist in the proper display of the script. Editors may add a prefix to the script that will identify the language. The prefix is an ISO 639-1 two-character language code followed by a colon: Template:Para. Unrecognized codes are ignored and will display in the rendered citation. This field will be displayed following the transliterated title.
• trans-chapter: If the cited source is in a foreign language, an English translation of the cited chapter title can be given here. This field will be displayed in square brackets within the quotation marks which enclose the chapter field.

Titles containing certain characters will both display and link incorrectly unless those characters are replaced or encoded like this:

Character	Must be replaced with
newline	space
[	[
]	]
|	|

Type

• type: Specifies the type of work cited. Appears in parentheses immediately after the title. Some templates use a default that can be overridden; example: Template:Tl will show (Press release) by default. Other useful values are Review, Systemic review, Report, Abstract, Meta-analysis or Original article.

Work and publisher

• work: Used by some templates such as Template:Tl (where it is aliased to website), Template:Tl (aliased to newspaper), Template:Tl (aliased to magazine), Template:Tl (aliased to journal), and others where the citation is usually to a specific item (given in the "title" parameter) found in a larger work (this "work" parameter), most commonly an article in a website or print periodical, or an episode in a TV series. Template:Em, which is for the publishing company. If the work is notable and has an article in Wikipedia, it should be wiki-linked at first appearance in citations in the article. If the "title" is already linked-to externally, do not externally link to the "work". If the work title as given by the site/publication would be exactly or substantially the same as the name of the publisher, do not use the "publisher" parameter (see below for more detail).

On websites, in most cases "work" is the name of the website (as usually given in the logo/banner area of the site, and/or appearing in the Template:Tag of the homepage, which may appear as the page title in your browser tab, depending on browser). Do not append ".com" or the like if the site's actual title does not include it (thus Template:Para, not Salon.com). If no clear title can be identified, or the title explicitly is the domain name, then use the site's domain name. Do not falsify the work's name by adding descriptive verbiage like "Website of [Publisher]" or "[Publisher]'s Homepage". Capitalize for reading clarity, and omit "www.", e.g. convert "www.veterinaryresourcesuk.com" to "VeterinaryResourcesUK.com".

Many journals use highly abbreviated titles when citing other journals (e.g. J Am Vet Med for Journal of the American Veterinary Medical Association) because specialists in the field the journal covers usually already know what these abbreviations mean. Our readers usually do not, so these abbreviations should always be expanded.

If the titled item being cited is part of some other larger work, as in a book in a series, a special issue of a periodical, or a sub-site at a domain (e.g., you are citing the law school's section of a university's website system), it is usually better to use the name of that more specific work than just that of the entire larger work. Various citation templates provide separate fields for such information, e.g. Template:ParaTemplate:ParaTemplate:ParaTemplate:Para in Template:Tlx. If the nature of the work and its relation to the site, book, or other context in which it is found is complicated or confusing, simply explain the situation after the citation template and before the Template:Xtag that closes the citation.

• publisher: the name of the organization that actually published the source. The field should not include the corporate designation such as "Ltd" or "Inc.", unless some ambiguity would result or the organization is usually known with that designation even in everyday use (e.g. Apple Inc., which otherwise might be confused with Apple Records and other publishers). "Publisher", "Publishing" and "Publications" can be abbreviated "Pubr.", "Pubg." and "Pubs." respectively, but some templates in this series include a period (full-stop) immediately after this parameter, so the period may have to be omitted; check the output if you abbreviate here. They are usually safe to omit, but are usefully included where the publisher's name might be confusing without it. This is most often the case when the publisher's name is something like "Joshua Martin Publications", which without the designation might be mistaken for a co-author/editor. A leading "The" can generally be omitted, again unless confusion might result (e.g., for The International Cat Association, "The" is part of their official acronym, TICA). If the publisher is notable and has an article independent of the "work", the "publisher" parameter can include a wiki-link to that article, but should never externally link to the publisher's website. Whether the publisher needs to be included depends to an extent on the type of work and sometimes on its recognizability. WP:Citing sources, and most off-Wikipedia citation guides, suggest that it should be used for books (even famous ones), but not necessarily other works. The "publisher" parameter should not be included for widely-known mainstream news sources, for major academic journals, or where it would be the same or mostly the same as the work. For example, the "publisher" parameter should be omitted in these examples:

  Template:ParaTemplate:Para

  Template:ParaTemplate:Para

  Template:ParaTemplate:Para

  Template:ParaTemplate:Para

  Template:ParaTemplate:Para

If the work is self-published, this is a very important fact about potential reliability of the source, and needs to be specified; no consensus exists for the exact value of Template:Para in such a case, but some printed style guides suggest "author", while many Wikipedia editors have used "self-published" for increased clarity. When an exhaustive attempt to discover the name of the publisher (try whois for websites, and WorldCat for books, etc.) fails, use Template:Para to explicitly indicate that this was checked, so other editors do not waste time duplicating your fruitless efforts. Do not guess at the publisher when this information is not clear. See next entry for co-published works and how to specify multiple publishers and their locations.

• location (alias Template:Para): Geographical place of publication (Template:Em where you found your copy, nor location of material in the source). This is usually Template:Var, or Template:Var. The city name by itself can be used for world-recognized cities like New York, London (except in articles about Canadian topics), Paris, Tokyo. Simply having a unique name does not mean it is globally recognizable; e.g., many people do not know where Mumbai is, especially if they are old enough that it was called Bombay for much of their lives. If in doubt, be more not less specific, since "Toronto, Canada" and "San Francisco, California" do not actually hurt anything. Be more specific when a Template:Var would be ambiguous, e.g. Template:Para, versus Template:Para. Do not use sub-national postal abbreviations ("DE", "Wilts", etc.), per MOS:POSTABBR. The location parameter should be omitted when it is implied by the name of the work, e.g. The Sydney Morning Herald. The location parameter should be used when the location is part of a common appellation of but not the actual title of a periodical. For example, the newspaper sometimes called the New York Daily News is actually Daily News and can be entered with Template:Para Template:Para, which yields: Daily News. New York. A similar example is The Times of London (contrast The New York Times). Per WP:SAYWHEREYOUGOTIT, provide the location of the edition you are using (e.g., if a publisher has operations in both New York and London and you have the London-published edition, use Template:Para, even if the publisher's corporate HQ is in New York). If your edition specifically gives multiple locations, this can be indicated with, e.g., Template:Para. This same technique can be used for co-published works, e.g.: Template:ParaTemplate:Para; just get them in corresponding order in both parameters. The templates do Template:Em have separate Template:Para, Template:Para, etc., parameters. For historical publications that are still worth citing and still findable (e.g. via book digitizers – see the "via" parameter below), do not confuse the Template:Em (printing press owner-operator) with the Template:Em (organization or person that sponsored the work); an edition may have a printer's name in larger type than the publisher, but for citation purposes we care about the publisher. If the distinction cannot be determined for certain in a particular case, list both. While some off-site publishers lean toward omitting publishing locations, they can serve more than purely bibliographical purposes on Wikipedia (e.g. an overabundance of material published in one place in an article about another place may reveal an editorial bias).
• publication-date: Date of publication when different from the date the work was written. Displays only if date or year are defined and only if different, else publication-date is used and displayed as date. Use the same format as other dates in the article; do not wikilink. Follows publisher; if work is not defined, then publication-date is preceded by "published" and enclosed in parenthesis.
• via (optional): Name of the content deliverer (when they are Template:Em the publisher). "via" is not a replacement for "publisher", but provides additional detail. It may be used when the content deliverer presents the source in a format other than the original, or when the URL provided does not make clear the identity of the deliverer, or as suggested in WP:The Wikipedia Library, e.g. WP:Credo accounts/Citations. See also Template:Section link. Typical uses of this parameter are identification of a book-scanning and -databasing project such as those provided by the Internet Archive, Project Gutenberg, and Google Books; journal indexing and search services through which we commonly find academic articles, e.g. PubMed Central, Paperity, and JSTOR; and other aggregators or indexers of previously-published content, such as Dictionary.com. Use via only when a standard identifier cannot be used (see Template:Section link). Example: {{Cite dictionary |entry=skeptic |entry-url=https://www.dictionary.com/browse/skeptic?s=t#collins-section |title=[[Collins English Dictionary]] |edition=Complete & Unabridged Digital |date=2012 |location=London |publisher=[[HarperCollins]] |via=[[Dictionary.com]] |access-date=22 November 2024}}

Pages

CS1/CS2 template support for
Template:Pipevolume=, Template:Pipeissue=, Template:Pipepage(s)=

template	Template:Pipevolume=	Template:Pipeissue=	Template:Pipepage(s)=
Template:Tlx	Template:Yes	Template:Yes	Template:Yes
Template:Tlx	Template:No	Template:No	Template:Yes
Template:Tlx	Template:Yes	Template:No	Template:No
Template:Tlx	Template:No	Template:No	Template:Yes
Template:Tlx	Template:No	Template:No	Template:Yes
Template:Tlx	Template:Yes	Template:No	Template:Yes
Template:Tlx	Template:No	Template:No	Template:Yes
Template:Plainlist	Template:No	Template:No	Template:Yes
Template:Plainlist	Template:Yes	Template:Yes	Template:Yes
Template:Tlx	Template:Yes	Template:No	Template:Yes
Template:Tlx	Template:No	Template:Yes	Template:No
Template:Tlx	Template:Yes	Template:Yes	Template:Yes
Template:Tlx	Template:Yes	Template:Yes	Template:Yes
Template:Tlx	Template:Yes	Template:Yes	Template:Yes
Template:Tlx	Template:No	Template:No	Template:No
Template:Plainlist	Template:Yes	Template:No	Template:Yes
Template:Plainlist	Template:Yes	Template:Yes	Template:Yes
Template:Tlx	Template:Yes	Template:Yes	Template:Yes
Template:Tlx	Template:No	Template:No	Template:No
Template:Tlx	Template:No	Template:No	Template:No
Template:Tlx	Template:No	Template:No	Template:Yes
Template:Tlx	Template:Yes	Template:No	Template:Yes
Template:Tlx	Template:No	Template:No	Template:No
Template:Tlx	Template:No	Template:No	Template:No
Template:Tlx	Template:No	Template:No	Template:No
Template:Tlx	Template:No	Template:No	Template:Yes
Template:Tlx	Template:Yes	Template:No	Template:Yes
Template:Tlx	Template:Yes	Template:No	Template:Yes
Template:Tlx	Template:No	Template:No	Template:Yes

An editor may use any one of the following parameters in a given citation to refer to the specific page(s) or place in a cited source that contains the information that supports the article text. If more than one of the following parameters are used in the same citation, the error message Extra |pages= or |at= (help) will display in the published citation. When more than one of the following parameters is used in error, Template:Para overrides both Template:Para and Template:Para; Template:Para overrides Template:Para. To resolve the error, remove extra parameters of this type until only one remains in the affected citation.

• page: page in the cited source containing the information that supports the article text, for example Template:Para .
  • Template:AnchorNote: For a hyphenated page, use Template:Para. This will not only properly display a hyphen, but also reduce the likelihood that an editor/bot will convert this to Template:Para by mistake.
• pages: pages in the cited source containing the information that supports the article text. Separate page ranges with an en dash: – , for example Template:Para . Separate non-sequential pages with a comma, for example Template:Para . The form Template:Para is used when you are citing both non-contiguous and sequential pages.
  • Note: CS1 citations do not record the total number of pages in a cited source; do not use this parameter for that purpose.
• at: place in the cited source containing the information that supports the article text when a page number is not given, is inappropriate or is insufficient. Common examples include column or col., paragraph or para. and section or sec. Depending on the source being cited, other indicators may be appropriate to use with the Template:Para parameter including, but not limited to, track, hours, minutes and seconds, act, scene, canto, book, part, folio, stanza, back cover, liner notes, indicia, colophon, dust jacket, etc. Examples include Template:Para or Template:Para or Template:Para or Template:Para.

If the same source is reused with different pages, separate citations must be created. A way around this problem is to use a short citation Template:Tlx, or Template:Tlx to provide linked page number citations.

Edition identifiers

• edition: Identifies the particular edition of a cited source when the source has more than one edition, such as "2nd", "Revised", etc. Note that this parameter automatically displays " ed." after your entry. For example, Template:Para displays as: Revised third ed. The edition parameter can be omitted if there is no content difference between two editions of the same work; e.g. if a book was identically published in the UK and the US except, for example, ISBN number and cover art, it is not necessary to indicate either "UK" or "US" edition; or if citing minute:seconds of a film available in both a regular edition and a "Special Limited Collector's Edition", if the running time and cut are the same, it is not necessary to cite the particular edition.
• series: When the source is part of a series, such as a book series or a journal where the issue numbering has restarted. For journal series, Template:Para should be limited to Template:Code, Template:Code, or similar.Template:Refn
• volume: For a source published in several volumes. This field is displayed in bold after the title and series parameters. An alternative is to include the volume information in the title parameter after the main title.
• issue: When the source is part of a series that is published periodically. Aliases: number.

External links

• url: Adds a link to the title
• chapter-url: Adds a link to the chapter.
• format: Format of the document at its URL (e.g., PDF, xls, etc.) Do not specify for HTML as it is implied as the default. Do not use this parameter for completely different purposes, with annotations such as "fee required" or "reprint"; its intent is to notify readers what the file format is (e.g. in case some browsers might have trouble with it, or some might prefer to save the link to disk rather than open it in the browser). Access restrictions can be shown using the appropriate Template:Para parameter, see Registration or subscription required. Other notes about reprintings, etc., should be placed after the template, and before Template:Tag.

Using |format=

When MediaWiki encounters an external link url with a '.pdf' or '.PDF' extension, it renders the external link with a PDF icon in place of the usual external-link icon. To make rendered cs1|2 citations that link to PDF documents somewhat more accessible, cs1|2 automatically adds a parenthetical PDF annotation so that those readers using screen-reader technology can know the type of the linked file. This is imperfect because some on-line sources redirect .pdf urls to .html landing pages (this is common for PDF documents behind paywalls or registration barriers). Because the parenthetical PDF annotation happens automatically, editors are not required to set Template:Para, though doing so causes no harm. The Template:Para parameter may be deleted as part of a more substantial edit but editors should consider that many cs1|2 templates are copied from en.Wikipedia to other-language Wikipedias when articles here are translated to that other language. Do not assume that other-language Wikipedias use up-to-date cs1|2 templates; many do not so removing Template:Para here can affect readers/translators at other Wikipedias.

Online sources

Template:Main Links to sources are regarded as conveniences and are not required, except when citing Web-only sources. There are many digital libraries with works that may be used as sources.

• Links should be to full versions of the source.
• Online sources that require payment or subscription may be included per the verifiability policy.

Do not link to: Template:Main

• Sites that do not have permission to republish the work or which otherwise violate copyright.
• Commercial sites such as Amazon, unless no alternative exists.
• Reviews of the work.
• Very short extracts such as Google Books snippet view where there is not enough context to verify the content, unless the entire work is also freely available there. (See WP:BOOKLINKS)

Link formats

Links should be kept as simple as possible. For example, when performing a search for a Google Book, the link for Monty Python and Philosophy would look like:

https://books.google.com/books?id=NPDgD546-doC&pg=PP1#v=onepage&q&f=false

But can be trimmed to:

https://books.google.com/?id=NPDgD546-doC&pg=PP1#v=onepage&q&f=false

or:

https://books.google.com/?id=NPDgD546-doC&printsec=frontcover

or:

https://books.google.com/?id=NPDgD546-doC (if Google Books does not provide the cover page).

Pages

A direct link to a specific page may be used if supported by the host. For example, the link to page 172 of Monty Python and Philosophy on Google Books:

https://books.google.com/?id=NPDgD546-doC&pg=PA172

like so:

|page=[https://books.google.com/?id=wPQelKFNA5MC&pg=PA172 172]

Access date

• access-date: The full date when the content pointed to by url was last verified to support the text in the article; do not wikilink; requires url; use the same format as other access and archive dates in the article's citations. It is not required for linked documents that do not change. For example, access-date is not required for links to copies of published research papers accessed via DOI or a published book, but should be used for links to news articles on commercial websites (these can change from time to time, even if they are also published in a physical medium). Note that access-date is the date that the URL was checked to not just be working, but to support the assertion being cited (which the current version of the page may not do). Can be hidden or styled by registered editors. Alias: accessdate.

Web archives

• archive-url
• archive-date

The original link may become unavailable. When an archived version is located, the original URL is retained and Template:Para is added with a link to an archived copy of a web page, usually from services like WebCite and the Internet Archive. Template:Para must be added to show the date the page was archived, not the date the link was added. When Template:Para is used, Template:Para and Template:Para are required, else an error will show. When an archived link is used, the citation displays with the title linked to the archive and the original link at the end: Template:Cite book

• url-status: To change the order with the title retaining the original link and the archive linked at the end, set Template:Para:

Template:Cite book

When the original URL has been usurped for the purposes of spam, advertising, or is otherwise unsuitable, setting Template:Para or Template:Para suppresses display of the original URL (but Template:Para and Template:Para are still required).

Identifiers

A custom identifier can be specified through Template:Csdoc

Registration or subscription required

Template:Tracked Citations of online sources that require registration or a subscription are acceptable in Wikipedia as documented in Template:Section link. As a courtesy to readers and other editors, editors can signal the access restrictions of the external links included in a citation. Of note, access icons do not display correctly for editors who use Modern skin.

There are four access levels split between the url-holding parameters and the identifier parameters.

Access level of url-holding parameters

There are several url-holding parameters. Each may be marked with an access icon. Links inserted with any of the url-holding parameters are expected to be free-to-read by default, so Template:Para is not valid. For a URL that is not free-to-read, editors may use the matching access-icon parameter with the appropriate keyword.

url-holding parameter access icons

url parameter	access icon parameter	supported keywords
Template:Para	Template:Para	Template:Plainlist
Template:Para	Template:Para
Template:Para	Template:Para
Template:Para	Template:Para
Template:Para	Template:Para
Template:Para	Template:Para
Template:Para	Template:Para

Access level of identifiers

Links inserted by identifiers such as Template:Para are not expected to offer a free full text by default. If they do, editors can use Template:Para (in the case of Template:Para) to indicate the relevant access level.

Some identifiers always link to free full texts. In this case, the access level is automatically indicated by the template. This is the case for Template:Para, Template:Para, Template:Para, Template:Para, Template:Para and Template:Para.

identifier parameter access icons

url parameter	access icon parameter	supported keywords
Template:Para	Template:Para	free – – the source is free to read for anyone (not supported by Template:Para)
Template:Para	Template:Para
Template:Para	Template:Para
Template:Para	Template:Para
Template:Para	Template:Para
Template:Para	Template:Para

Old access parameters

The parameters Template:Para and Template:Para are no longer supported. They were used to indicate the access level of a citation. They were deprecated because they did not indicate the link to which they applied. Editors should use Template:Para or Template:Para instead, when the restriction applies to Template:Para. If the restriction applies to an identifier, these parameters should be omitted.

Quote

• quote: Relevant text quoted from the source; enclosed in quotes. When supplied, the citation terminator (a period by default) is suppressed, so the quote must include any terminating punctuation.

Anchors

• ref: Creates an anchor for use with Shortened footnotes and parenthetical referencing. These styles use in-text cites with a link that will jump to an anchor created by the CS1 template. Anchors are enabled by default. (See Template:Tl for details.)
• Template:Para: Creates an anchor from up to four author last names and the year, of the format CITEREFlastname(s)year, suitable for a Template:Tlx, Template:Tlx etc. Examples:

{{cite book |first=Gary L. |last=Hardcastle |title=Monty Python and Philosophy |year=2006}}

Creates an anchor named CITEREFHardcastle2006 which may be linked from Template:Tlx.

{{cite book |first=Gary L. |last=Hardcastle |first2=George A. |last2=Reisch |title=Monty Python and Philosophy |year=2006}}

Creates an anchor named CITEREFHardcastleReisch2006 which may be linked from Template:Tlx.

• Template:Para: Creates a custom anchor defined by ID. This is useful where the author and/or date is unknown. The Template:Tlx template may be used here to create an anchor suitable for a Template:Tlx, Template:Tlx etc. For example, ref={{harvid|Monty Python and Philosophy|2006}} creates an anchor which may be linked from Template:Tlx.

Display options

These features are not often used, but can customize the display for use with other styles. Template:Csdoc

et al.

et al. is the abbreviation of the Latin Template:Lang ('and others'). It is used to complete a list of authors of a published work, where the complete list is considered overly long. The abbreviation is widely used in English, thus it is not italicized per MOS:FOREIGN.

Accept-this-as-written markup

There are occasions where Module:Citation/CS1 emits error or maintenance messages because of, or makes changes to, the values assigned to a select set of parameters. The markup is ((<Template:Var>)), i.e. wrap the entire parameter value in two sets of parentheses. Parameters that support the markup are:

parameters that support accept-this-as-written markup

parameter	notes
Template:Para	Template:Tlx, Template:Tlx, Template:Tlx, Template:Tlx – cs1Template:Pipe2 normally removes a trailing dot from the value assigned to Template:Para as redundant. There are cases where the trailing dot is not redundant but is part of the title proper so should be retained.
Template:Para	cs1Template:Pipe2 inserts spaces between commas and succeeding characters in comma-separated lists of pages; converts hyphen to ndash in ranges, etc. cs1Template:Pipe2 cannot distinguish between a hyphenated page number and a page range nor can it distinguish a four-or-more-digit number with a thousands-separator from a comma-separated list of two or more pages; does not apply to Template:Para
Template:Para
Template:Para
Template:Para	markup was initially developed for these parameters to suppress error messages and automatic Vancouver reformatting of allowed corporate author-names
Template:Para
Template:Para	the name-list parameters are checked for extra comma and semicolon separator characters which may indicate that the parameter is holding more than one name. Corporate names are sometimes comma separated lists of names so are normally flagged as a multiple-name error
Template:Para
Template:Para
Template:Para

Printing

When viewing the page, CS1 templates render the URL to the title to create a link; when printing, the URL is printed. External link icons are not printed.

Elements not included

Not all factually accurate pieces of information about a source are used in a Citation Style 1 citation. Examples of information not included:

• The total number of pages in a cited source
• The name of the library that provided access to an electronic copy of a cited source
• The name of the library that owns a physical copy of a cited work
• The library record and/or shelf location of a physical copy of a cited work

Tools

Template:Main CS1 templates may be inserted manually or by use of tools:

• Citoid, a tool built into Visual Editor that attempts to build a full citation based on a URL. See user guide.
• RefToolbar is part of the editing tool bar. Version 2.0 does not yet support all templates supported by version 1.0.
• ProveIt provides a graphical interface for editing, adding, and citing references. It may be enabled per the documentation.
• Wikipedia citation tool for Google Books
• DOI Wikipedia reference generator
• New York Times Wikipedia reference generator
• Reflinks Adds references to templates while updating/filling-in title/dates/publisher/accessdates etc.
• reFill open source version of Reflinks
• Zotero can export citations in Wikipedia-ready format.
• Citer – generates shortened footnote or named reference for a given Google Books URL, ISBN, or DOI. Also supports some major news websites.

Error checking:

• User:Svick/HarvErrors.js is a script that may be enabled to display errors when using Shortened footnotes or parenthetical referencing. It does not warn when a long citation has been added but not a short one (using Template:Tl or Template:Tl).
• User:Ucucha/HarvErrors.js is very similar, but also contains additional warnings for potential issues.

TemplateData

This section documents interactions between WP:TemplateData and tools which use that data to edit Wikipedia such as VisualEditor and bots. Before making changes to the TemplateData be aware of these interactions.

User:InternetArchiveBot

• If an argument is set to "required" the argument will be added to all templates edited by IABot. This including adding empty arguments. For example, when Template:Para is "required" IABot makes the following edit: [1].

Common issues

Template:Para does not show.

If Template:Para is not supplied, then Template:Para does not show; by design.

The bare URL shows before the title.

If the Template:Para field includes a newline or an invalid character then the link will be malformed; see Web links.

The title appears in red.

If URL is supplied, then the title cannot be wikilinked.

The URL is not linked and shows in brackets.

The URL must include the URI scheme in order for MediaWiki to recognize it as a link. For example: www.example.org vs. http://www.example.org.

A field is truncated.

A pipe (|) in the value will truncate it. Use Template:Tlx instead.

The template markup shows.

Double open brackets [[ are used in a field without closing double brackets ]].

The author shows in brackets with an external link icon.

The use of an URL in Template:Para will break the link; this field is for the name of the Wikipedia article about the author, not a website.

Multiple author or editor names are defined and one or more does not show

The parameters must be used in sequence, i.e. if Template:Para or Template:Para is not defined, then Template:Para will not show. By design.

Template:Para, Template:Para or Template:Para do not show.

These parameters are mutually exclusive, and only one will show; by design.

See also

• Help:Citation Style 2

References

Template:Wikipedia referencing Template:Citation Style 1 Template:Help navigation