View source for Help:Citation Style 1

{{Wikipedia how to|WP:CS1|Help:CS1|H:CITE1}}
{{notice|image=Gnome-applications-science.svg|This help page has {{subpages|testcases|Help:Citation Style 1}} demonstrating various uses.}}
{{hatnote|A link to this page can be created by using {{tl|cs1}} to create {{cs1}}.}}
Citation Style 1 (CS1) is a well-used method of referencing Wikipedia articles using a series of templates that in turn use the meta-template {{tl|Citation/core}}. The use of a central template makes individual citation templates simpler to code and amend, and produces a consistent look throughout the encyclopedia.

The use of CS1 or of templates is not compulsory; per [[WP:CITEVAR]]:

Citations within each Wikipedia article should follow a consistent style. Editors may choose any style they want. The English Wikipedia does not have a house style, so one article need not match what is done in other articles.

==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:
* Be based on {{tl|citation/core}} 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 longer works in italics.
* Format short works such as chapters in quotes.

==Templates==

===General use===

{| class="wikitable"
|+ General use CS1 templates
! Template !! Use !! [[WP:RefToolbar 1.0|RefToolbar 1.0]] !! [[WP:RefToolbar 2.0|RefToolbar 2.0]] !! [[User:ProveIt GT|ProveIt]] || [[User:Odie5533/SnipManager|SnipManager]] || [[WP:Cite4Wiki|Cite4Wiki]]
|-
| {{tl|Cite album-notes}} || album liner notes || || || || ||
|-
| {{tl|Cite book}} || books || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} ||
|-
| {{tl|Cite conference}} || conference papers || || || {{Yes}} || ||
|-
| {{tl|Cite DVD-notes}} || DVD liner notes || || || || ||
|-
| {{tl|Cite encyclopedia}} || edited collections || || || {{Yes}} || ||
|-
| {{tl|Cite episode}} || television or radio programs and episodes || || || {{Yes}} || ||
|-
| {{tl|Cite interview}} || interviews || || || || ||
|-
| {{tl|Cite journal}} || magazines, journals, academic papers || {{Yes}} || || {{Yes}} || {{Yes}} || {{depends|Sometimes}}{{efn|[[WP:Cite4Wiki|Cite4Wiki]] uses {{tl|Cite web}} by default, but has been customized to use {{tl|Cite news}}, etc., for certain specific sources, and can be further customized in this manner.}}
|-
| {{tl|Cite mailing list}} || archived public mailing lists || || || || ||
|-
| {{tl|Cite manual}} || manuals || || || || ||
|-
| {{tl|Cite map}} || maps || || || || ||
|-
| {{tl|Cite music release notes}} || audio and video liner notes || || || || ||
|-
| {{tl|Cite news}} || news articles in print, video, audio or web || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{depends|Sometimes}}
|-
| {{tl|Cite newsgroup}} || online newsgroups || || || || ||
|-
| {{tl|Cite podcast}} || audio or video [[podcast]] || || || || ||
|-
| {{tl|Cite press release}} || press releases || {{Yes}} || || ||
|-
| {{tl|Cite serial}} || audio or video serials || || || ||
|-
| {{tl|Cite sign}} || signs, plaques and other visual sources || || || || ||
|-
| {{tl|cite speech}} || speeches || || || || ||
|-
| {{tl|cite techreport}} || technical reports || || || || ||
|-
| {{tl|Cite thesis}} || theses || || || || ||
|-
| {{tl|Cite video}} || audio and video sources || || || {{Yes}} || {{Yes}} ||
|-
| {{tl|Cite web}} || web sources not characterized by another template || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}} || {{Yes}}
|}
{{notelist}}

===Bot-filled===
The following templates use {{tl|cite journal}} as a meta-template. By simply entering an identifier, a bot will retrieve the citation information from a database and fill in the template.
{| class="wikitable"
|+ Bot-filled citation templates
! Template !! Identifier
|-
| {{tl|Cite arXiv}} || [[arXiv]] preprints
|-
| {{tl|Cite doi}} || [[Digital object identifier]]
|-
| {{tl|Cite jstor}} || [[JSTOR]]
|-
| {{tl|Cite pmid}} || [[PubMed]]
|-
| {{tl|Cite pmc}} || [[PubMed Central]]
|}

===Specific source===
There are a number of templates that are CS1 compliant 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, {{tl|cite book}} has fields for title and chapter, whereas {{tl|cite journal}} 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:
:author (date). ''title''. publisher. identifiers
* Without author:
:''title''. publisher. date. identifiers

===Authors and editors===
Authors may be included by separate parameters for the given name and surname. A single or first author would use {{para|last}} and {{para|first}} and subsequent authors would use {{para|last2}} and {{para|first2}} through {{para|last9}} and {{para|first9}}. This method shows the name in {{var|last, first}} style:

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

You may also use {{para|author}} through {{para|author9}} to include the full author name. This method is used when {{var|first last}} order style is used, the national or ethnic name style is not {{var|first last}} or an organizational author is used. This may not create the expected anchor for [[WP:CITESHORT|Shortened footnotes]] and [[WP:PAREN|parenthetical referencing]].

If the author has a Wikipedia article, the author name can be linked with {{para|authorlink}} through {{para|authorlink9}}. This method is used because {{para|last}} and {{para|first}} does not allow a wikilink. This link is not for an external website and will render incorrectly if one is used. If the author is notable enough to have an article, then the website should be linked in that article's "External links" section.

Editors are added in the same manner using {{para|editor-last}} and {{para|editor-first}} through {{para|editor-last4}} and {{para|editor-first4}} and {{para|editorlink}} through {{para|editorlink4}}.

The use of authors modifies the display and order of the citation:

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

:{{cite book |title=Monty Python and Philosophy |year=2006}}

By default, if nine authors are defined, then only eight will show and ''et al.'' will show in place of the last author. To change the number of authors, see [[#Display options|Display options]]. If four editors are defined, then ''et al.'' will show in place of the last editor; there is no display option for editors.

If the source provides no author, as is common with newswire reporting and the internal pages of company websites, and the organizational author would be the same as the work/site/periodical, or the publisher, use:
:{{para|author|<nowiki><!--Staff writer(s); no by-line.--></nowiki>}}
This HTML comment saves a lot of long-term Wikipedia editorial time by alerting fact-checking and citation-fixing editors (and bots) that the publisher source specifically did not name the author and that this information wasn't accidentally omitted from the citation here.

In particular, avoid citations like {{tlx|cite news |work{{=}}Weekday Times |author{{=}}''Weekday Times'' editors |title{{=}}...}}, unless the article is on a field in which the majority of professionally published citations in journals on that field use such a redundant citation style.

The main function of {{para|author}} being used for organizational citation is 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. {{para|author|Commission on Headphone Safety}} or {{para|author|Rules Sub-committee}}. Using this parameter to assert what you think was probably the collective author, when the source itself does not specify that body as the collective author, is [[WP:NOR|original research]] and falsification of [[WP:V|source verifiability]] and [[W:RS|reliability]].

===Others===
* '''others''': Contributors other than author or editor; a description such as "Illustrated by Smith" or "Trans. Smith" may be included.

===Dates===
Dates are generally included by three 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.
** '''month''': Name of the month of publication. If you also have the day, use ''date'' instead. Must not be wikilinked.
** '''origyear''': Original publication year, for display alongside the date or year. For clarity, please supply specifics, for instance <code>origyear=First published 1859</code> or <code>origyear=Composed 1904</code>. This parameter only displays if there is a value for ''year'' or ''date''.

It is important that {{para|date}} be used only for the full date; using a year only will create a malformed anchor when that feature is enabled.

Dates formats per [[WP:DATESNO]]:{{refn|group=Note|See also [[WP:Citing sources#Citation style|"Citation style" section in the "Citing sources" guideline]]. While the rules stated have usually been applied to citations using the templates described in this help page, they do not necessarily apply when using a printed style guide like [[APA style]].}}
* Do not wikilink.
* Use month before day or day before month styles and use them consistently throughout the article.
* Access and archive dates in references should be in either the format used for publication dates, or YYYY-MM-DD.

===Titles and chapters===
Titles containing certain characters will display and link incorrectly unless those characters are replaced or encoded.
{| class="wikitable"
! newline !! [ !! ] !! &#124;
|-
| space || &amp;#91; || &amp;#93; || &amp;#124;
|}
* '''title''' The title of the source. Generally displayed in italics, except for a short work such as {{tl|cite press release}} and cited articles in {{tl|cite news}}, {{tl|cite journal}} and {{tl|cite web}}, where it is shown in quotation marks. Should consistently use title case or sentence case throughout the article, and should use title case unless the article is on a scientific, legal or other technical topic in which sentence case is the predominant style in journals on that topic. Subtitles are typically separated from titles with ": " though " – " is also used. Do not omit a leading "The" from the title. [[MOS:TM|As with trademarks]], Wikipedia {{em|does not}} attempt to emulate any stylistic "flourish" used in the title in its original publication, such as ALL-CAPS, all-lower-case, {{sm|Small Caps}}, etc.; just use plain text. If the cited book (or whatever) is itself notable and has an article, it can be wiki-linked. This will make it impossible to use the "url" parameter to link to an external copy, so only do this when citing works that do not need to be externally linked. A link to the actual source is better than a link to a Wikipedia article about the source.
* '''chapter''' The chapter of the book, written in full. Displayed in quotes before the title. For websites arranged in sections the "at" parameter serves a similar function: {{para|at|"Featured News" section}}
* '''type''': Specifies the type of work cited. Appears in parentheses immediately after the title. Some templates use a default that can be overridden; example: {{tl|cite press release}} will show (Press release) by default.
* '''trans_title''': If the book cited is in a foreign language, an English translation of the title can be given here. This field will be shown square brackets after the title and will be linked to {{para|url}} if used.
* '''trans_chapter''': Will be displayed in square brackets within the quotation marks which enclose the chapter field.

===Language===
* '''language''': The language the work is written in, if it is not English. Displayed before the title, enclosed in parentheses and prefixed with ''in''. Do not use icons in this field.

===Work and publisher===
{{see|WP:CITEHOW}}
* '''work''': Used by some templates such as {{tl|cite web}}, {{tl|cite news}} (where it is also aliased to '''newspaper''' and '''magazine'''), {{tl|cite journal}} (aliased to '''journal'''), and others where the citation is usually to a specific item in a larger work, most commonly an article in a website or print periodical, or an episode in a TV series. ''Do not confuse this with the "publisher" parameter'', which is for the publishing company. If the work is notable and has an article, 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".
:On websites, in most cases "work" is the name of the website (as usually given in the logo/banner area of the site), otherwise the site's domain name. A leading "The" can usually be left off a website, unless confusion might result. If the "work" as given by the site/publication would be exactly the same as the name of the publisher, use the 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". For periodicals, it is conventional in citations (not running prose) to omit a leading "The" for publications with multi-part names ({{para|newspaper|[[New York Times]]}} and {{para|journals|[[Astrophysical Journal]]}} but {{para|newspaper|[[The Nation]]}}) unless ambiguity would result. While many journals themselves 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 abbreviation mean. Our readers do not, and these abbreviations should always be expanded. If the titled item being cited is part of some other larger work, such as a book, periodical or sub-organization, forming a sub-site at a domain name (e.g., 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 that of the entire site/system. 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 {{tag|ref|c}} that closes the citation.
* '''publisher''': the name of the company 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 company is usually known with that designation even in everyday use. "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. These words are usually safe to omit, but are usefully included where the publisher's name might be confusing. 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. 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. The "publisher" parameter should be included even where it would be the same or mostly the same as the work/site/journal/etc., for example:
::{{para|work|Amazon.com}} &nbsp;&nbsp; and &nbsp; {{para|publisher|Amazon}}
::{{para|magazine|''[[New York Times]]''}} &nbsp;&nbsp; and &nbsp; {{para|publisher|[[New York Times Company]]}}
:(Here, the ''New York Times'' links go to different articles (and linked company names can be abbreviated: {{para|publisher|[[New York Times Company|NYTC]]}}.) Most professional and academic citation standards (and thus everyone familiar with any of them) do expect the publisher to be explicitly included, even where this may seem redundant. Adding it doesn't hurt anything, and eliminates the possibility that later editors will assume it was left out by mistake and waste time looking up the missing information. If the work is self-published, [[WP:SELFPUB|this is a very important fact]] about [[WP:RS|potential reliability of the source]], and needs to be specified, with {{para|publisher|self-published}}. When an exhaustive attempt to discover the name of the publisher (try [[whois]] for websites) fails, use {{para|publisher|<nowiki><!--Unspecified by source.--></nowiki>}} 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 isn't clear; doing so is a falsification of the [[WP:V|verifiability]] of the source.
* '''location''': Geographical place of publication, usually City, Country, or City, U.S. State; simply 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 doesn't mean it's 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.

===Pages===
* '''page''': page in the source that supports the content
* '''pages''': pages in the source that supports the content; separate page ranges with an en dash (–); separate non-sequential pages with a comma. ''Do not use this parameter to indicate the total number of pages in the source!'' That is not relevant information in a citation.
* '''at''': For sources where a page number is inappropriate or insufficient; overridden by {{para|page}} or {{para|pages}}.
** Examples: page (p.) or pages (pp.); section (sec.), column (col.), paragraph (para.); track; hours, minutes and seconds; many others: act, scene, canto, book, part, folio, stanza, back cover, liner notes, indicia, colophon, dust jacket

===Edition identifiers===
* '''edition''': When the source has more than one edition. E.g. "2nd", "Revised" etc. The templates automatically displays " ed." after this parameter, so {{para|edition|2nd}} produces "2nd ed." Can be omitted if there is no content difference; e.g. if a book was identically published but for ISBN number and maybe different cover art, once in the UK and again in the US, don't indicate "US" or "UK" edition; or if citing minute:seconds of a film and the film itself is the same cut with the same running time in the regular edition and a "Special Limited Collector's Edition", don't cite the unusual version.
* '''series''': When the source is part of a series, such as a book series or a journal where the issue numbering has restarted.{{refn|name=c16_14.132|group=Note|"Some numbered series have gone on so long that, as with certain long-lived journals, numbering has started over again, preceded by n.s. (new series), 2nd ser. (second series), or some similar notation, usually enclosed in commas. (A change of publisher may also be the occasion for a change in series designation.) Books in the old series may be identified by o.s., 1st ser., or whatever complements the notation for the new series."<ref>{{cite book |author=University of Chicago |title=The Chicago Manual of Style |edition=16th |year= 2010 |publisher=Univ. of Chicago Press |location= Chicago |language= |isbn=978-0226104201}}</ref>{{rp|14.132}}}}
* '''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 one of a series that is published periodically.

===External links===
* '''url''': Adds a link to the title
* '''chapterurl''': Adds a link to the chapter.
* '''format''': Format of the document at its URL (e.g., PDF, xls, etc.) Don't specify for HTML (implied as default). <!--Maybe controversial? Has PDF icon w/o the parameter, but not the text "PDF": Don't specify for PDF if the URL ends with ".pdf" or ".PDF", as that will be auto-detected.--> 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). Notes about access restrictions, reprintings, etc., should be placed after the template, and before {{tag|ref|c}}.

====Online sources====
{{main|WP:External links|WP:Citing sources}}
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 [[Wikipedia:Verifiability|verifiability policy]].

Do not link to:
{{main|WP:LINKSTOAVOID}}
* Sites that do not have permission to republish the work or which otherwise violate copyright.
* Commercial sites such as Amazon.
* 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:

:http://books.google.com/books?id=wPQelKFNA5MC&lpg=PP1&dq=monty%20python&pg=PP1#v=onepage&q&f=false

But can be trimmed to:

:http://books.google.com/books?id=wPQelKFNA5MC

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

:http://books.google.com/books?id=wPQelKFNA5MC&l&pg=PA173

If the same source is reused with different pages, separate citations must be created. A way around this problem is to use {{tlx|rp}} to provide linked page number citations.

====Special characters====
URLs containing certain characters will display and link incorrectly unless those characters are encoded. For example, a space must be replaced by <code>%20</code>.
{| class="wikitable"
! sp !! " !! , !! ' !! ; !! < !! > !! ? !! [ !! ]
|-
| %20 || %22 || %2c || %3a || %3b || %3c || %3e || %3f || %5b || %5d
|}
:{{small|Single apostrophes do not need to be encoded; multiples will be parsed as italic or bold markup}}

The link button [[File:Vector toolbar insert link button.png]] on the enhanced editing toolbar will encode a link.

====Access date====
* '''accessdate''': The date the web link was accessed; only shows when a link is included.

====Icons====
{{main|Help:External link icons}}
URLs with certain filename extensions or URI schemes will apply an icon specific to that file type. This is done through MediaWiki CSS, not these templates.

===Web archives===
{{see|Wikipedia:Link rot}}
* '''archiveurl'''
* '''archivedate'''
The original link may become unavailable. When an archived version is located, the original URL is retained and {{para|archiveurl}} is added with a link to an archived copy of a web page, usually from services like WebCite and the Internet Archive. {{para|archivedate}} must be added to show the date the page was archived, not the date the link was added. When {{para|archiveurl}} is used, {{para|url}} and {{para|archivedate}} 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:

:{{cite journal |title=Monty Python and Philosophy |url=http://books.google.com/books?id=wPQelKFNA5MC |archiveurl=http://wayback.archive.org/web/*/http://books.google.com/books?id=wPQelKFNA5MC |archivedate=October 12, 2011}}
* '''deadurl''': To change the order with the title retaining the original link and the archive linked at the end, set {{para|deadurl|no}}:

:{{cite journal |title=Monty Python and Philosophy |url=http://books.google.com/books?id=wPQelKFNA5MC |archiveurl=http://wayback.archive.org/web/*/http://books.google.com/books?id=wPQelKFNA5MC |archivedate=October 12, 2011 |deadurl=no}}

===Identifiers===
Most templates support these identifiers:
* '''arxiv''': [[ArXiv]]
* '''asin''': [[Amazon Standard Identification Number]]
* '''bibcode''': [[Bibcode]]
* '''doi''': [[Digital object identifier]]
** '''doi_brokendate''': Date the DOI is broken
* '''id''': A general identifier
* '''isbn''': [[International Standard Book Number]]
* '''issn''': [[International Standard Serial Number]]
* '''jfm''': [[Jahrbuch über die Fortschritte der Mathematik]]
* '''jstor''': [[JSTOR]]
* '''lccn''': [[Library of Congress Control Number]]
* '''mr''': [[Mathematical Reviews]]
* '''oclc''': [[Online Computer Library Center]]
* '''ol''': [[Open Library]]
* '''osti''': [[Office of Scientific and Technical Information]]
* '''PMC''': [[PubMed Central]] article number for full-text free repository of an article
* '''PMID''': [[PubMed]] Unique Identifier
* '''rfc''': [[Request for Comments]]
* '''ssrn''': [[Social Science Research Network]]
* '''zbl''': [[Zentralblatt MATH]]

===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 needs to include terminating punctuation.

===Anchors===
* '''ref''': Creates an anchor for use with [[WP:CITESHORT|Shortened footnotes]] and [[WP:PAREN|parenthetical referencing]]. These styles use in-text cites with a link that will jump to an anchor created by the CS1 template. Anchors are not enabled by default, they are created by use of {{para|ref}}
* '''{{para|ref|harv}}''': Creates an anchor of the format <code>CITEREF''authorslastnameyear''</code> suitable for a {{tlx|harv}}, {{tlx|sfn}} etc. Examples:
:{{cite book |first=Gary L. |last=Hardcastle |title=Monty Python and Philosophy |year=2006 |ref=harv}}
::Creates an anchor named [[#CITEREFHardcastle2006|<code>CITEREFHardcastle2006</code>]] which may be linked from {{tlx|harv|Hardcastle|2006|4=pp=12-34}}.
:{{cite book |first=Gary L. |last=Hardcastle |first2=George A. |last2=Reisch |title=Monty Python and Philosophy |year=2006 |ref=harv}}
::Creates an anchor named [[#CITEREFHardcastleReisch2006|<code>CITEREFHardcastleReisch2006</code>]] which may be linked from {{tlx|harv|Hardcastle|Reisch|2006|5=pp=12-34}}.
* '''{{para|ref|<var>ID</var>}}''': Creates a custom anchor defined by <var>ID</var>. This is useful where the author and/or date is unknown. The {{tlx|harvid}} template may be used here to create an anchor suitable for a {{tlx|harv}}, {{tlx|sfn}} etc. For example, {{para|ref|{{tlx|harvid|Monty Python and Philosophy|2006}}}} creates an anchor which may be linked from {{tlx|harv|Monty Python and Philosophy|2006|4=pp=12-34}}

===Display options===
These features are not often used, but can customize the display for use with other styles.
* '''author-mask''': Primarily intended for use in bibliographies for some styles where multiple works by a single author are listed. It replaces the name of the first author with a strike-thru dash (—) author-mask em in length. If {{para|author-mask|1}} then the dash will be one em in length and so on. Set author-mask to a text value to display a word instead:– for example, 'with'. You must still include the parameters for all authors for metadata purposes. Do not use in a list generated by {{tl|reflist}} or {{tag|references|s}} as there is no control as to the order that references will display.
* '''author-name-separator''': Changes the separator between last and first names; defaults to a comma (,)
* '''author-separator''': Changes the separator between authors; defaults to a semicolon (;)
* '''display-authors''': By default, the number of authors displayed is limited to 8; if 9 are provided, the ninth is displayed as "et al." This parameter allows display of fewer authors before the "et al." (e.g., {{para|display-authors|2); alternatively, the "et al." may be suppressed by the use of {{para|display-authors|9}}.
* '''lastauthoramp''': When set to any value, changes the separator to use between the last two names in lists of authors to an ampersand (&). Defaults to a semicolon and space (; ), else {{para|author-separator}} if set.
* '''postscript''': The closing punctuation for the citation; defaults to a period (.); if the parameter is present, but blank, no terminating punctuation will be used. Ignored if {{para|quote}} is specified.
* '''separator''': The punctuation used to separate lists of authors, editors, etc. Defaults to a period (.); if the parameter is present, but blank, no separator punctuation will be used.

==Subscription or registration required==
{{main|WP:PAYWALL}}
Online sources that require subscription or registration are acceptable. In these instances, add {{tl|subscription required}} or {{tl|registration required}} directly after the CS1 template.

==Printing==
When viewing the page, CS1 templates render the URL to the title to create a link; when printing, the URL is printed. [[Help:External link icons|External link icons]] are not printed.

==Elements not included==
Not all pieces of information about the source are required in a citation. Some elements not included:

The total number of pages in a source are not part of a citation.

Web hosts and physical locations are not part of a citation. There is no need to include a host such as Google Books, Project Gutenberg or Scribd and they should never be noted as the publisher. Similarly, a specific library, library record or a shelf location would not be included.

==Tools==
CS1 templates may be inserted manually or by use of tools:
* [[Wikipedia:RefToolbar|RefToolbar]] is part of the editing tool bar. Version 2.0 does not yet support all templates supported by version 1.0.
* [[User:ProveIt GT|ProveIt]] provides a graphical interface for editing, adding, and citing references. It may be enabled per the documentation.
* [http://reftag.appspot.com/ Wikipedia citation tool for Google Books]
* [http://reftag.appspot.com/doiweb.py DOI Wikipedia reference generator]
* [http://reftag.appspot.com/nytweb.py New York Times Wikipedia reference generator]
* [[tools:~dispenser/view/Reflinks|Reflinks]] - Adds references to templates while updating/filling-in title/dates/publisher/accessdates etc.
Error checking:
* [[User:Ucucha/HarvErrors]] is a script that may be enabled to display errors when using [[WP:CITESHORT|Shortened footnotes]] or [[WP:PAREN|parenthetical referencing]].

==Common issues==
{{shortcut|WP:CS1PROBS}}
;{{para|accessdate}} does not show. :If {{para|url}} is not supplied, then {{para|accessdate}} does not show; by design.

;The bare URL shows before the title. :If the {{para|title}} field includes a newline or an invalid character then the link will be malformed; see [[#Web links|Web links]].

;The title appears in red. :If URL is supplied, then the title cannot be wikilinked.

;A field is truncated. :A pipe &#124; in the value will truncate it.

;The template markup shows. :Double open brackets &#91;&#91; are used in a field without closing double brackets &#93;&#93;.

;The author shows in brackets with an external link icon. :The use of an URL in {{para|authorlink}} 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 {{para|last}} or {{para|last1}} is not defined, then {{para|last2}} will not show. By design.

;{{para|page}}, {{para|pages}} or {{para|at}} do not show. :These parameters are exclusive and only one will show; by design.

;The periods separating the series of fields are missing :If {{para|separator}} is present but blank, no separator punctuation will be used.

;The citation is broken across lines, successive lines are indented and may be bulleted or numbered. :If {{para|separator}} is set to an asterisk (*), colon (:) or hash (#) they will be interpreted as wikimarkup.

==Notes==
{{reflist|group=Note}}

==References==
{{reflist}}

{{Wikipedia referencing}}
{{Citation Style 1}}

[[Category:Citation Style 1 templates|*]]