Zotero & CSL Variables
Table of Zotero variables matched to their CSL defined types
CSL variables marked with an Astrix ⟨ * ⟩ have no corresponding Zotero field. They can be added to the Zotero Extra field. The syntax follows the pattern
variable-name: value.
| CSL variable | Description |
|---|---|
| abstract | [standard] abstract of the item (e.g. the abstract of a journal article) |
| accessed | [date] date the item has been accessed |
| annote* | [standard] reader’s notes about the item content |
| archive | [standard] archive storing the item |
| archive_location | [standard] storage location within an archive (e.g. a box and folder number) |
| archive-place* | [standard] geographic location of the archive |
| author | [name] author |
| authority | [standard] issuing or judicial authority (e.g. “USPTO” for a patent, “Fairfax Circuit Court” for a legal case) |
| call-number | [standard] call number (to locate the item in a library) |
| chapter-number | [number] chapter number |
| citation-label* | [standard] label identifying the item in in-text citations of label styles (e.g. “Ferr78”). May be assigned by the CSL processor based on item metadata. |
| citation-number* | [standard] index (starting at 1) of the cited reference in the bibliography (generated by the CSL processor) |
| collection-editor | [name] editor of the collection holding the item (e.g. the series editor for a book) |
| collection-number | [number] number identifying the collection holding the item (e.g. the series number for a book) |
| collection-title | [standard] title of the collection holding the item (e.g. the series title for a book) |
| composer | [name] composer (e.g. of a musical score) |
| container* | [date] ? |
| container-author | [name] author of the container holding the item (e.g. the book author for a book chapter) |
| container-title | [standard] title of the container holding the item (e.g. the book title for a book chapter, the journal title for a journal article) |
| container-title-short | [standard] short/abbreviated form of “container-title” (also accessible through the “short” form of the “container-title” variable) |
| dimensions | [standard] physical (e.g. size) or temporal (e.g. running time) dimensions of the item |
| director | [name] director (e.g. of a film) |
| DOI | [standard] Digital Object Identifier (e.g. “10.1128/AEM.02591-07”) |
| edition | [number] (container) edition holding the item (e.g. “3” when citing a chapter in the third edition of a book) |
| editor | [name] editor |
| editorial-director* | [name] managing editor (“Directeur de la Publication” in French) |
| event | [standard] name of the related event (e.g. the conference name when citing a conference paper) |
| event-date* | [date] date the related event took place |
| event-place | [standard] geographic location of the related event (e.g. “Amsterdam, the Netherlands”) |
| first-reference-note-number* | [standard] number of a preceding note containing the first reference to the item. Assigned by the CSL processor. The variable holds no value for non-note-based styles, or when the item hasn’t been cited in any preceding notes. |
| genre | [standard] class, type or genre of the item (e.g. “adventure” for an adventure movie, “PhD dissertation” for a PhD thesis) |
| illustrator* | [name] illustrator (e.g. of a children’s book) |
| interviewer | [name] interviewer (e.g. of an interview) |
| ISBN | [standard] International Standard Book Number |
| ISSN | [standard] International Standard Serial Number |
| issue | [number] (container) issue holding the item (e.g. “5” when citing a journal article from journal volume 2, issue 5) |
| issued | [date] date the item was issued/published |
| jurisdiction* | [standard] geographic scope of relevance (e.g. “US” for a US patent) |
| keyword* | [standard] keyword(s) or tag(s) attached to the item |
| language | [standard] Language code. Not intended for display purposes. |
| locator* | [standard] a cite-specific pinpointer within the item (e.g. a page number within a book, or a volume in a multi-volume work). Must be accompanied in the input data by a label indicating the locator type (see the Locators term list), which determines which term is rendered by cs:label when the “locator” variable is selected. |
| medium | [standard] medium description (e.g. “CD”, “DVD”, etc.) |
| note | [standard] (short) inline note giving additional item details (e.g. a concise summary or commentary) |
| number | [number] number identifying the item (e.g. a report number) |
| number-of-pages | [number] total number of pages of the cited item |
| number-of-volumes | [number] total number of volumes, usable for citing multi-volume books and such |
| original-author* | [name] ? |
| original-date* | [date] (issue) date of the original version |
| original-publisher* | [standard] original publisher, for items that have been republished by a different publisher |
| original-publisher-place* | [standard] geographic location of the original publisher (e.g. “London, UK”) |
| original-title* | [standard] title of the original version (e.g. “Война и мир”, the untranslated Russian title of “War and Peace”) |
| page | [standard] range of pages the item (e.g. a journal article) covers in a container (e.g. a journal issue) |
| page-first* | [standard] first page of the range of pages the item (e.g. a journal article) covers in a container (e.g. a journal issue) |
| PMCID* | [standard] PubMed Central reference number |
| PMID* | [standard] PubMed reference number |
| publisher | [standard] publisher |
| publisher-place | [standard] geographic location of the publisher |
| recipient | [name] recipient (e.g. of a letter) |
| references | [standard] resources related to the procedural history of a legal case |
| reviewed-author | [name] author of the item reviewed by the current item |
| reviewed-title* | [standard] title of the item reviewed by the current item |
| scale | [standard] scale of e.g. a map |
| section | [standard] container section holding the item (e.g. “politics” for a newspaper article) |
| source | [standard] from whence the item originates (e.g. a library catalog or database) |
| status | [standard] (publication) status of the item (e.g. “forthcoming”) |
| submitted | [date] date the item (e.g. a manuscript) has been submitted for publication |
| title | [standard] primary title of the item |
| title-short | [standard] short/abbreviated form of “title” (also accessible through the “short” form of the “title” variable) |
| translator | [name] translator |
| URL | [standard] Uniform Resource Locator (e.g. “http://aem.asm.org/cgi/content/full/74/9/2766”) |
| version | [standard] version of the item (e.g. “2.0.9” for a software program) |
| volume | [number] (container) volume holding the item (e.g. “2” when citing a chapter from book volume 2) |
| year-suffix* | [standard] disambiguating year suffix in author-date styles (e.g. “a” in “Doe, 1999a”) |
Data Sources
- Vinckevicius, Zumstein & Bennett (2021)
- Vinckevicius, A., Zumstein, P. & Bennett, F. (2021). Data Transforms. In z2csl - Zotero to CSL extension and mappings.. Github Project. Retrieved from https://aurimasv.github.io/z2csl/typeMap.xml