index.md

title	Draft 2020-12
Published	16 June 2022
type	docs
authors	Austin Wright Henry Andrews Ben Hutton Greg Dennis
Metaschema	https://json-schema.org/draft/2020-12/schema
Specification	https://json-schema.org/draft/2020-12/json-schema-core.html
prev	label url Specification /specification
next	label url Draft 2019-09 /draft/2019-09

Introduction

The JSON Schema Draft 2020-12 is a comprehensive update to the previous draft 2019-09, addressing feedback and implementation experiences. This draft introduces features to simplify creating and validating JSON schemas.

Here's an overview of updates to Draft 2020-12;

• Redesigned Array and Tuple Keywords: The items and additionalItems keywords have been replaced by prefixItems and items.
• Dynamic References: The introduction of $dynamicRef and $dynamicAnchor replaces the older $recursiveRef and $recursiveAnchor.
• Contains and UnevaluatedItems: Specifies how the contains keyword affects the unevaluatedItems keyword.
• Regular Expressions: Now expected to support Unicode characters, addressing inconsistencies in previous drafts.
• Media Type Changes: Drops the schema media type parameter.
• Embedded Schemas and Bundling: Provides guidance on bundling schemas into a Compound Schema Document.
• Vocabulary Changes: Separates the format vocabulary into format-annotation and format-assertion.

Draft 2020-12 Documents

• Specifications
  • Core: draft-bhutton-json-schema-01 (changes)
  • Validation: draft-bhutton-json-schema-validation-01 (changes)
  • Relative JSON Pointer: draft-bhutton-relative-json-pointer-00 (changes)
  • Published: 16-June-2022
• General use meta-schemas
  • JSON Schema meta-schema
  • JSON Hyper-Schema meta-schema (2019-09 Hyper-Schema with 2020-12 Validation)
  • JSON Hyper-Schema Link Description Object meta-schema
• Individual vocabulary meta-schemas
  • Core Vocabulary meta-schema
  • Applicator Vocabulary meta-schema
  • Validation Vocabulary meta-schema
  • Unevaluated Vocabulary meta-schema
  • Format Annotation Vocabulary meta-schema
  • Format Assertion Vocabulary meta-schema
  • Content Vocabulary meta-schema
  • Meta-Data Vocabulary meta-schema
• Output schemas
  • JSON Schema recommended output schema
• Output examples
  • JSON Schema verbose output example

Obsolete Draft 2020-12 Documents

These were updated without changing functionality or meta-schemas due to a few errors and unclear sections.

• Core: draft-bhutton-json-schema-00 (changes)
• Validation: draft-bhutton-json-schema-validation-00 (changes)

Release Notes

• Draft 2020-12 Release Notes