Skip to main content
v2026.11,610 entries · CC-BY 4.0
Dictionary termTrack EStablev2026.1

Document version

During the development of a document there are usually several iterations of the work. There are periods along the authoring process that can be identified as a specific identifiable point where the work can be identified as a specific version of the work.

ByCASRAI Editorial Board
· Last updated 17 Aug 2026

Ask about Document version

Answers are drawn from this dictionary entry and the rest of the CASRAI corpus, with a link to every source.

Answers are AI-generated from CASRAI’s own published pages and can be wrong, so check the linked sources before relying on one; your question is logged without personal data — never sold, never used to train a third-party model — to show us what CASRAI is missing, so please do not type personal or confidential details. How we use this

Examples

Worked examples

  • Is an instance

    An author posts a preprint to a subject repository in January, submits the same manuscript to a journal, and after peer review the journal accepts a revised version in April (the accepted manuscript); the journal publishes its own typeset version online in June (the version of record) -- all three versions may legitimately coexist online at once.

Counter-examples

Looks similar, but isn't

  • Not an instance

    Two PDF exports of the exact same accepted manuscript, saved under different filenames but with identical content, are not different document versions -- a document version reflects a genuine change to the substantive content of the work, not merely a different file format or filename for the same content.

Editorial commentary

Document version refers to a specific, identifiable point in a work’s development — a manuscript is rarely a single fixed object; it passes through several iterations between initial drafting and final published form, and each of those iterations may be tracked, cited, and made accessible independently of the others.

The core version chain in scholarly publishing

CASRAI’s vocabulary, along with most publisher and repository self-archiving policies, distinguishes three core versions of a journal article as it moves toward publication:

Which version a given self-archiving policy, funder mandate, or repository permits an author to deposit varies — most publisher policies permit only the accepted manuscript, not the version of record, to be self-archived, and may attach an embargo to that permission. See CASRAI’s comparison of preprint vs. postprint vs. version of record for a fuller breakdown of the terminology and what each stage permits.

Why version identity matters for citation and compliance

Because the preprint, accepted manuscript, and version of record can differ in wording, figures, and even conclusions (peer review can meaningfully change a manuscript), citing or depositing the wrong version can misrepresent the work. Funder open access mandates and journal citation guidance typically specify which version satisfies a given requirement — commonly the accepted manuscript for repository deposit, and the version of record for the definitive citable reference.

Worked example

An author posts a preprint to a subject repository in January, submits the same manuscript to a journal, and after peer review the journal accepts a revised version in April (the accepted manuscript). The journal publishes its own typeset version online in June (the version of record). All three versions may legitimately coexist online at once, each carrying its own document version identity, and — depending on the repository — a distinct DOI.

Counter-example

Two PDF exports of the exact same accepted manuscript, saved under different filenames but with identical content, are not different document versions — a document version reflects a genuine change to the substantive content of the work, not merely a different file format or filename for the same content.

Frequently Asked Questions

How many document versions does a typical journal article have?

Most commonly three — preprint (optional), accepted manuscript, and version of record — though some repositories and preprint servers also track sequential preprint revisions (v1, v2, v3) as further distinct versions.

Which version should I deposit in a repository?

Check the specific publisher’s self-archiving policy — most permit depositing the accepted manuscript, often after an embargo, and restrict depositing the version of record without a separate open access license.

Which version should I cite?

The version of record is generally the definitive citable version once it exists. Cite a preprint or accepted manuscript explicitly as such if the version of record is not yet available.

Machine-readable encodings

Use in your systems

JATS XML <role> element
xml
<role vocab="credit"
      vocab-identifier="https://casrai.org/dictionary/"
      vocab-term="Document version"
      vocab-term-identifier="https://casrai.org/dictionary/term/document-version" />
Schema.org DefinedTerm (JSON-LD)
json
{
  "@context": "https://schema.org",
  "@type": "DefinedTerm",
  "@id": "https://casrai.org/dictionary/term/document-version",
  "name": "Document version",
  "identifier": "https://casrai.org/dictionary/term/document-version",
  "description": "During the development of a document there are usually several iterations of the work. There are periods along the authoring process that can be identified as a specific identifiable point where the work can be identified as a specific version of the work.",
  "inDefinedTermSet": "https://casrai.org/dictionary/domain/research-lifecycle#set",
  "url": "https://casrai.org/dictionary/term/document-version",
  "sameAs": [],
  "license": "https://creativecommons.org/licenses/by/4.0/",
  "publisher": {
    "@id": "https://casrai.org/#organization"
  },
  "dateModified": "2026-08-17T01:58:55",
  "inLanguage": "en"
}

Referenced across the research world

University of Cambridge logoColumbia University logoCrossref logoUniversity of Edinburgh logoHarvard University logoUniversity of Oxford logoPrinceton University logoStanford School of Medicine logoUniversity College London logoORCID logoUniversity of Cambridge logoColumbia University logoCrossref logoUniversity of Edinburgh logoHarvard University logoUniversity of Oxford logoPrinceton University logoStanford School of Medicine logoUniversity College London logoORCID logo
  • University of Cambridge logo
  • Columbia University logo
  • Crossref logo
  • University of Edinburgh logo
  • Harvard University logo
  • University of Oxford logo
  • Princeton University logo
  • Stanford School of Medicine logo
  • University College London logo
  • ORCID logo

View CASRAI adoption →