Implementation of the Chicago Manual of Style, 18th edition

edited 29 days ago
After six months of development and testing, I am delighted to announce a major update to the Citation Style Language (CSL) styles for the Chicago Manual of Style, available via the Zotero Style Repository. This rewrite is based on a close section-by-section reading of the 18th edition, significantly expanding the styles’ ability to process the information that CSL can collect. The styles can now produce sensible results for nearly every section of the Manual.

For full technical details, see the notes on changes by section available via GitHub.

Main updates from the 17th to 18th edition

See Chicago’s What’s New in the 18th Edition page for a list of changes. Key differences for citations include:
  • Author limits: Up to six authors now appear in bibliographies, and up to two in notes or in-text citations accompanied by bibliographies. Notes-only styles differ from notes with bibliographies to accommodate a larger number of authors.
  • Shortened notes: Subsequent citations of the same work are now shortened to author–title notes by default; other options include author-only, title-only, and “Ibid.”
  • Journal dates: Months or seasons now appear in fewer circumstances, and not at all if there is a volume and issue, meaning that Chicago's critique of Zotero's date display is no longer a problem. The styles also now support ahead-of-print articles, supplements, special issues, and preprints.
  • Books: The place of publication is no longer required, and page ranges are optional for book chapters. Use one of the "classic" variants available on the repository to retain these features.
  • Bibliographies: Chicago no longer recommends the use of 3-em dashes, preferring to repeat the author’s name. The "classic" variants retain this feature.
The styles also include new or improved support for annotated bibliographies, database and dataset citations, classical and medieval works, audiovisual sources, legal documents, and many other categories.

Expanded variant coverage

The new CSL styles implement more than thirty official Chicago variants. There are four basic systems: in addition to the notes and bibliography and author–date systems, the Manual allows shortened author–title notes and notes without a bibliography. It also gives authors and editors leeway in many smaller details, such as the presentation of references without URLs.

Variants from previous editions that the 18th edition still allows have been grouped into “classic” legacy variants (not an official Chicago term).

Working with the new styles

The styles are designed to match the examples in Chicago’s Citation Quick Guide and the full chapter 14 examples (freely searchable without a subscription). You can explore the variables that each citation type uses through the Zotero Test Items Library. Search for a CMOS section number to see examples encoded from it.

Suppose that you wish to know how to cite a review correctly: Chicago has written a post on the difficulties that this type of citation presents. By searching the CMOS website, you can learn that the Manual covers this topic especially in 14.100 and 14.101. Searching for 14.100 in the Test Items Library will show several examples encoded from this section. In Zotero for desktop, it is also possible to add a Rights column to the display and sort by this to see the examples in the order of the Manual's categories, allowing you to see all the relevant examples from 14.100–102 together. This is especially valuable for citations that rely heavily on the Extra field.

New fields in future Zotero updates

These styles aim to support the full CSL specification. Although Zotero does not yet expose all CSL variables as fields in its interface, this implementation ensures that as new fields are added, Chicago styles will be able to take full advantage of them. For now, you can enter any CSL variable manually via the Extra field. As Zotero adds additional fields, these styles will immediately be able to do something useful with them.

Supporting CSL development

CSL is a volunteer-run, open-source project separate from Zotero. If the Chicago styles support your work, you might consider:Thanks are due to @bwiernik (whose APA styles provided the foundation for the new Chicago styles) and @adamsmith for guidance. I am especially appreciative of the CMOS staff members who saved me from misinterpreting several sections by answering my queries (but they have not reviewed the implementation as a whole).
«1
  • This is great news! Thanks so much for your work on this.

    I may be mistaken, but I think this misreads CMOS 18 slightly. According to 14.30 and 14.31, books published before 1900 should be place only (no publisher), while books published after 1900 should be publisher only (no place). Right now, Zotero is just omitting place from all books, regardless of publication date.
  • Congratulations on this release! I'm in awe how methodological, precise and thorough you've been with this project!
    Thank you for having spent so much time and energy for the scientific/academic community in your free time!
  • edited 29 days ago
    @jdriddle
    may be mistaken, but I think this misreads CMOS 18 slightly. According to 14.30 and 14.31, books published before 1900 should be place only (no publisher), while books published after 1900 should be publisher only (no place).
    See the technical release notes on github on this:

    14.30: A place of publication is no longer required in citations of books. The CSL implementation is not complete, since for books published before 1900, the place of publication only is to be provided, but there is no way to achieve this in CSL 1.0.2.
    Note that the style will print the place of publication if there is no publisher, so that would be a way of getting the right pre-1900 citations, but at the cost of deleting the publisher in your data.
  • Thank you very much! I just made a small one-time donation on Github.
  • Thank you for your work and especially for including the "classic variants" option! I was a little shocked when my beloved 3-em dashes disappeared and I'm glad they're now back.

    My apologies if I missed this, but is there an option to include "ibid. in subsequent citations" with the classic variants? Right now, I only find a Chicago 18th ed. style with ibid. for the styles without classic variants. I (and I imagine others) would appreciate having "ibid." as an option with the classic variants styles, too (without having to edit the code ourselves). Thank you!
  • @adamsmith Understood! Thank you for clarifying. I can make the changes manually.

    My thanks again to you and @dunning for taking on this monumental task. I rely on Zotero and therefore on your all's hard work. Cheers!
  • edited 28 days ago
    Thank you very much for the effort...
    Can you please explain how to edit the fields used in references?
    I am about to submit an article, and found out that some fields that I am using for 'library management', like (Location in Archive and Rights) are displayed in the references. This happens also for Books and Journal Articles (which do not have usually require Location in Archive and Rights). I tried to install earlier styles, but they seem to have been updated to include these fields as well.
  • My apologies if I missed this, but is there an option to include "ibid. in subsequent citations" with the classic variants?
    I was doing all I could to limit the number of variants – this one occurred to me but I left it out as it would result in another four styles to cover notes and shortened notes. I can certainly create these if there is demand for it.
  • I am about to submit an article, and found out that some fields that I am using for 'library management', like (Location in Archive and Rights) are displayed in the references. This happens also for Books and Journal Articles (which do not have usually require Location in Archive and Rights).
    The contents of the Rights, Library Catalogue, and Call Number fields will never appear in Chicago citations. This is also true for nearly all CSL styles, though MLA uses the Library Catalogue field.

    Previously, an archival reference did not appear with journal articles and books, but this did not allow users to meet Chicago's requirements and was not consistent with other CSL styles. The Chicago Manual calls for citing database references for sources consulted online: in the 17th edition, see the examples in sections 14.161 (books) and 14.175 (journal articles). Unfortunately there is no way in CSL/Zotero to distinguish between database and archival references.
  • @dunning I appreciate the need to limit the number of variants, but I think "ibid. in subsequent citations" would be appreciated especially by the people using "classic variants" — if anything, if you would want to limit the number of variants, I would possibly even suggest including ibid. as default in the "classic variants" options.

    In any case, I think I would be among many others who would really appreciate it if you could create a Chicago style variant with ibid. and classic variations. Thank you very much for your work!
  • Hi all, and thank you for the release of CMOS18!

    I was hoping to adapt this style to my faculty’s requirements using the CSL Visual Editor (https://editor.citationstyles.org/visualEditor/), but I noticed that the style hasn’t yet been added to the CSL GitHub repository or made available in the editor’s search.

    I tried manually uploading the style via the Visual Editor, but it hangs indefinitely—likely due to new CSL features or complexity. Is there any plan to submit CMOS18 to the CSL repository so it becomes accessible via the Visual Editor?

    Many thanks in advance!
  • Generally yes, but the fact that it doesn't work when uploaded doesn't bode well -- the visual editor isn't terribly resource effective and struggles with large styles like the updated CMoS ones.
    There aren't any new features in the style that should cause problems -- how long did you let it hang?
  • Thanks, adamsmith. I’ve tried both uploading the full CSL file and pasting the code into the Code Editor, then switching to the Visual Editor. In both cases, the Visual Editor remains stuck on the loading screen, even after waiting over 30 minutes across multiple attempts and browsers.

    I also tried breaking the style into smaller chunks and pasting those into the Code Editor. However, when switching to the Visual Editor, it seems to reject the incomplete code and defaults back to APA—likely because the CSL is not fully formed.

    Appreciate any further suggestions or workarounds!
  • The Visual Editor unfortunately falls apart once there are more than about thirty macros, and the Chicago style is obliged to provide duplicates of most of its macros because of the minor differences between notes and bibliography. My aim in writing these was to focus on logic whilst capturing as many details from the CSL specification and Chicago Manual as possible. If I had more time to work on the styles, I would love to start again and produce an optimized version, but right now there are far more pressing needs.
  • The bibliography by Zotero uses '...', but if I understand the manual correctly, shouldn't it be "..."?
  • You mean the quote format? Switch to US English in the document preferences (this behavior hasn't changed with the updated styles).
  • Thank you!
  • Hi folks, thank you for this working on making Chicago 18 available in all its, er, glory, to Zotero users.
    I've got a manuscript to submit to Journal of Law, Medicine, and Ethics. Their style guide says this:

    ZOTERO
    If you're using Zotero, the Chicago Manual of Style 18th edition (full note) should be
    available by August 1. If you are submitting before August 1, use the format Chicago
    Manual of Style 17th edition (full note). Please ensure Zotero has produced numbers
    in your article text that correspond to numbered footnotes or endnotes before
    submitting, as it is easy to accidentally produce an unnumbered bibliography or author-date citations instead.

    From that paragraph, I believe that they are using Chicago 18 "notes and bibliography" system, rather than Chicago 18 "author-date" system.

    Question: there are 30 results in the Zotero Style Repository style search for chicago 18 -- but none of them is labeled "(full note)." Do you have any idea what they might mean? I will also ask the journal.

    Thanks!
    Kate
  • Thanks! I will let the journal know and suggest that they update the instructions in their style guide.
  • adamsmith, thank you for your work in making this edition available. Can I ask two quick questions? In the update, many footnotes in my MS now carry the phrase "unpublished manuscript". Is there any way to remove this phrase? And second, subsequent citations after the first now carry more than author's last name and short title - the translator and publisher are now showing up in subsequent citations. Is there any way to correct this?
  • The questions are for @dunning and it'd be important which style exactly you're using as well as a couple of examples of what you're talking about.
  • Understood, thank you. @dunning, I'm using the newest Chicago, full note. To give a few examples for each issue:

    First, many footnotes in my MS now carry the phrase "unpublished manuscript". Is there any way to remove this phrase? Examples include

    ASG, Notai Antichi 944/VI, unpublished manuscript (docs. 19, 21, and 25, Pera, 20 August 1478 through 26 August 1479)

    BAV, Reg. Lat. 548, unpublished manuscript, 143r

    In both cases, readers already know what abbreviations I'm using, and already know that these are unpublished manuscripts. But my footnotes now contain about 400 instances of the phrase. Is there any way to eliminate this?

    For the second, subsequent citations after the first now carry more than author's last name and short title - the translator and publisher are now showing up in subsequent citations. The problem seems to occur only if there is an editor or translator alongside an author (the citations for which there is only an author seem to be fine). For example:

    First, an example of correct subsequent citation (even though no italics appear here, all are correct in the notes themselves):

    Balletto, Liber, 329–30 (she is listed as editor, but there is no author or translator, and the subsequent citations look fine)

    Examples of incorrect subsequent citations:

    Doukas, Decline and Fall, trans. Magoulias (Wayne State University Press, 1975), 200–201.

    The first citation correctly looks like this: Doukas, Decline and Fall of Byzantium to the Ottoman Turks: An Annotated Translation of Historia Turco-Byzantina, trans. Harry J. Magoulias (Wayne State University Press, 1975), 212


    and

    “Prima serie,” ed. Belgrano (Tipogr. del R. Istituto de’ Sordo-Muti, 1877), 259–72

    The first citation slightly incorrectly looks like this: “Prima serie di documenti riguardanti la colonia di Pera,” in Atti della Società ligure di storia patria, ed. Luigi Tommaso Belgrano, 13 (fasc. II) (Tipogr. del R. Istituto de’ Sordo-Muti, 1877), 179


    If there's only an editor or translator, they should appear first, whether in the first or subsequent citations. And there appears to be a glitch in subsequent citations which carry an editor or translator alongside an author. Publisher and year are incorrectly retained in subsequent citations, and editor or translator are often incorrectly retained as well.

    I'm sorry for the long post. Any guidance you might have would be greatly appreciated!




  • edited 4 days ago
    1. See CMOS 14.114 for the usage of 'unpublished manuscript', which will only appear if the citation lists no means of accessing a manuscript. In your example, 'BAV' should be in the Archive field and the shelfmark, 'Reg. Lat. 548', should be in the Loc. in Archive field.

    2. Normally you will only see author–title subsequent citations, but the style will add extra details to disambiguate shortened notes. I would guess that you are citing more than one edition of Doukas, Decline and Fall; or perhaps you are simply citing two instances of a duplicated item in your library, in which case merging them should fix the problem.

    3. There are some circumstances in which editors should appear in notes after the part of the title for which they are responsible, especially in multivolume works; see for example CMOS 14.24–26. In your case Atti della Società ligure di storia patria looks to me like a journal rather than a book section.
  • @dunning, I appreciate your help. For now, I think I'll revert to a previous version. Going through by hand to change several hundred entries in zotero will likely be more time-consuming than going through the manuscript and cleaning up the "unpublished manuscript" mentions.

    For the second, I'm definitely using only one version of Doukas's Decline and Fall, and the problem is widespread enough to just revert to a previous version. For the third, Atti della Società ligure di storia patria is indeed a hard thing to deal with. The problem with treating it as a journal is that it also functions as a series for monographs, so I've elected to treat a particular volume as an edited volume when there are multiple authors, and as a monograph when appropriate. Yet another reason for me to revert to a previous version. But I really appreciate your help!
  • edited 2 days ago
    I was so excited to see Chicago 18 is my styles list. And then sad, because notes-no bib wasn't there.

    But it is. IT IS!!! I love you Zotero people. So very much!!

    BUT -- it only gives 3 authors and notes-no bib requires the first 6. Per 13.23.

    (I tried to output all notes-bib styles as Bibliography as well as Notes and cannot get more than 3 authors. )


  • @rudyleon CSL styles cannot automatically detect whether or not a document includes a bibliography. To meet the requirements of CMOS 13.23, use one of the Chicago notes without bibliography options in the Zotero styles repository.
  • edited 2 days ago
    These are the results of the notes without bibliography style.

    That additional comment was to clarify that there is no style in the set that puts out 6 authors. Including the (notes without bibliography) style, which requires the first 6 authors.
  • No, it requires up to 6 authors, but only the first 3 if there are more than 6. That's exactly what the style does
  • edited 2 days ago
    No, that's not correct. Here's the text of 13.23 The relevant bit is the final parenthetical. Notes without bibliography requires the first note for any citation to be as complete as a bibliographic entry would be. It stands in for that. (notes with bib points to the bibliography. Notes without bib has to stand in for it)

    In a note that cites a book with more than two authors or editors (in previous editions it was more than three), list only the first author or editor, followed by “et al.” (Latin for “and others”). In the bibliography, list up to six authors; if there are more than six, list only the first three, followed by “et al.” (In a work with no bibliography, list up to six authors in the first, full citation in a note—as in a bibliography entry.)
Sign In or Register to comment.