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)

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": "",
        "pageStart": "334",
        "pageEnd": "336",
        "accessDetails": "You must register for document access via the following url:",
        "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.



  • Add minProperties, minItems and/or minLength properties.


  • Improve documentation
  • Use non-normative keywords where appropriate


  • Remove obsolete mergeStrategy properties