title

section

Specification Links

docs

label	url
Draft 05	/draft-05

label	url
Migration	/specification/migration

You can find the latest released draft on the Specification page. The complex numbering and naming system for drafts and meta-schemas is fully explained here as well.

Understanding draft names and numbers

IETF Internet-Drafts (I-Ds) are named with the editor's name and a sequential number which resets with each new editor. Meta-schemas were more-or-less numbered sequentially up through Draft 7, but the increasingly confusing mismatch between "draft-nn" versions on the meta-schemas and the IETF documents has made that unsustainable. The practice of fixing meta-schema bugs in place to preserve the sequential numbering has also been controversial.

Starting with what had been called "Draft 8" while it was being written, meta-schemas are identified by the year and month of publication. This allows for bug fixes to be published with new URIs (as long as it is not more than once a month).

Table of All Versions of Everything

For links to the somewhat more readably formatted versions on this web site, and for links to the various meta-schemas and other supplemental documents, see the the following sections.

common name	published	meta-schema identifiers	IETF identifiers	notes
Draft 2021-NN	(TBD)	(TBD)	(TBD)	Milestone: Draft 2021-NN
Draft 2020-12	16-June-2022	`2020-12`	`draft-bhutton-json-schema-00` `draft-bhutton-json-schema-validation-00` `draft-bhutton-relative-json-pointer-00`	Milestone: draft-08-patch-1 Changes and fixes as a result of discussion with the OpenAPI community. (Includes breaking changes.)

			`draft-bhutton-json-schema-01` `draft-bhutton-json-schema-validation-01`
Draft 2019-09	17-September-2019	2019-09	draft-handrews-json-schema-02 draft-handrews-json-schema-validation-02 draft-handrews-json-schema-hyperschema-02 draft-handrews-relative-json-pointer-02	Milestone: draft-08
Draft 7	19-March-2018	draft-07	draft-handrews-json-schema-00 draft-handrews-json-schema-validation-00 draft-handrews-json-schema-hyperschema-00 draft-handrews-relative-json-pointer-00	the draft-handrews-*-01 drafts were bugfixes and/or clarifications without meta-schema or functional changes Milestone: draft-07

			draft-handrews-json-schema-01 draft-handrews-json-schema-validation-01 draft-handrews-json-schema-hyperschema-01 draft-handrews-relative-json-pointer-01
Draft 6	21-April-2017	draft-06	draft-wright-json-schema-01 draft-wright-json-schema-validation-01 draft-wright-json-schema-hyperschema-01	Milestones: draft-6, Meta-schema draft-06
Draft 5	13-October-2016	draft-04	draft-wright-json-schema-00 draft-wright-json-schema-validation-00 draft-wright-json-schema-hyperschema-00	meta-schemas not changed, so "draft-05" is really draft-04 Milestone: draft-5 (2016-10-13)
Draft 4	31-January-2013	draft-04	draft-zyp-json-schema-04 draft-fge-json-schema-validation-00 draft-luff-json-hyper-schema-00 draft-pbryan-zyp-json-ref-03	json-ref drafts 00-02 were all published between json-schema-03 and json-schema-04
Draft 3	22-November-2010	draft-03	draft-zyp-json-schema-03
Draft 2	23-March-2010	draft-02	draft-zyp-json-schema-02
Draft 1	05-December-2009	draft-01	draft-zyp-json-schema-01
Draft 0	05-December-2009	draft-00	draft-zyp-json-schema-00	due to a markup error, this draft was replaced by draft-01 on the same day

Published Drafts

2020-12

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
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)

Draft 2019-09 (formerly known as Draft 8)

NOTE: All meta-schema URIs now use https://. While currently also available over plain HTTP due to the limitations of GitHub pages and the need to keep prior drafts available over HTTP, only the HTTPS URIs should be used.

Specifications
- Core: draft-handrews-json-schema-02 (changes)
- Validation: draft-handrews-json-schema-validation-02 (changes)
- Hyper-Schema: draft-handrews-json-schema-hyperschema-02 (changes)
- Relative JSON Pointer: draft-handrews-relative-json-pointer-02 (changes)
- Published: 17-September-2019
General use meta-schemas
Individual vocabulary meta-schemas
Output schemas
- JSON Schema recommended output schema
- JSON Hyper-Schema recommended output schema
Output examples
- JSON Schema verbose output example

Draft 7

Core: draft-handrews-json-schema-01 (changes)
Validation: draft-handrews-json-schema-validation-01 (changes)
Hyper-Schema: draft-handrews-json-schema-hyperschema-01 (changes)
JSON Schema meta-schema
JSON Hyper-Schema meta-schema
JSON Hyper-Schema Link Description Object meta-schema
JSON Hyper-Schema recommended output schema
Relative JSON Pointer: draft-handrews-relative-json-pointer-01 (changes)
Published: 19-March-2018

Obsolete Draft 7 Documents

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

Core: draft-handrews-json-schema-00 (changes)
Validation: draft-handrews-json-schema-validation-00 (changes)
Hyper-Schema: draft-handrews-json-schema-hyperschema-00 (changes)
Relative JSON Pointer: draft-handrews-relative-json-pointer-00 (changes)

Draft 6

Core: draft-wright-json-schema-01 (changes)
Validation: draft-wright-json-schema-validation-01 (changes) (schema migration FAQ)
Hyper-Schema: draft-wright-json-schema-hyperschema-01 (changes) (hyper-schema migration FAQ)
JSON Schema meta-schema
JSON Hyper-Schema meta-schema
Published: 21-April-2017

Draft 5

Core: draft-wright-json-schema-00 (changes)
Validation: draft-wright-json-schema-validation-00 (changes)
Hyper-Schema: draft-wright-json-schema-hyperschema-00 (changes)
Draft 5 was primarily a cleanup of Draft 4 and continued to use the Draft 4 meta-schemas.
Published: 13-October-2016

Draft 4

Core: draft-zyp-json-schema-04 (changes)
Validation: draft-fge-json-schema-validation-00 (changes)
Hyper-Schema: draft-luff-json-hyper-schema-00 (changes)
JSON Reference: draft-pbryan-zyp-json-ref-03 (changes)

JSON Schema meta-schema
JSON Hyper-Schema meta-schema

Published: 31-January-2013

Draft 3

Complete Specification: draft-zyp-json-schema-03 (changes)

JSON Schema meta-schema
JSON Hyper-Schema meta-schema

Published: 22-November-2010

Draft 2

Complete Specification: draft-zyp-json-schema-02 (changes: Appendix-A)

JSON Schema meta-schema
JSON Hyper-Schema meta-schema

Published: 23-March-2010

Draft 1

Complete Specification: draft-zyp-json-schema-01 (changes)

JSON Schema meta-schema
JSON Hyper-Schema meta-schema

Published: 05-December-2009

Draft 0

Note that Draft 0 erroneously claimed to update another RFC, and was replaced the same day by Draft 1. It is included here for completeness only.

Specification: draft-zyp-json-schema-00 (changes: Appendix-A))

JSON Schema meta-schema
JSON Hyper-Schema meta-schema

Published: 05-December-2009

Latest Snapshot (work in progress)

The next unreleased draft is a work in progress. You can give feedback and get involved on GitHub.

The specification links here link to the raw sources. We do not provide rendered work-in-progress drafts except near the very end of a publication cycle, during the final review period.

Core: jsonschema-core.md
Validation: jsonschema-validation.md
Hyper-Schema: jsonschema-hyperschema.xml
Relative JSON Pointer: relative-json-pointer.xml
JSON Schema meta-schema
JSON Hyper-Schema meta-schema
JSON Hyper-Schema Link Description Object meta-schema
JSON Schema Vocabulary meta-schemas
JSON Schema Output schemas and examples

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Uh oh!