Document objects are used to describe and link to documents. This extension adds fields to document objects to:

  • Indicate the page numbers at which relevant information can be found within a large document
  • Describe any special arrangements needed to access the document
  • Name the author of the document (not to be confused with its publisher)
  • Indicate the languages in which unofficial translations of the document are available

Use cases include:

  • Accessing the document and locating the information within it
  • Checking whether authors are involved in other ways in the contracting process, e.g. as bidders
  • Measuring the accessibility of documents


  "tender": {
    "documents": [
        "id": "1",
        "documentType": "equityTransferCaps",
        "title": "Equity transfer cap terms",
        "description": "No equity transfer is permitted until construction is completed. See document for more details.",
        "url": "",
        "language": "en",
        "unofficialTranslations": [
        "pageStart": "334",
        "pageEnd": "336",
        "accessDetails": "This document can only be accessed by visiting the PPP unit office by appointment. Please see the PPP unit website for further details.",
        "accessDetailsURL": "",
        "author": "Contract department, PPP unit"


Report issues for this extension in the ocds-extensions repository, putting the extension's name in the issue's title.



  • Change unofficialTranslation field to unofficialTranslations array of languages.


  • Add accessDetailsURL and unofficialTranslation fields.


  • Add minProperties, minItems and/or minLength properties.


  • Improve documentation
  • Use non-normative keywords where appropriate


  • Remove obsolete mergeStrategy properties