Specification

Migrating from older drafts

Introduction

Just as your schemas evolve over time, the JSON Schema specification does as well. This guide provides useful information to make upgrading your schemas across versions of the specification a breeze.

Learn how to use our migration guides and tooling (AlterSchema) to bring your work with you.

Keywords Overview

Here is a comprehensive overview to get you going.

All Keywords	Specification	Draft introduction	Removed	Changed
`$anchor`	Core	2019-09	No	No (updated in 2020)
`$comment`	Core	07	No
`$id`	Core	06	No	Replaced `id`
`$defs`	Core	2019-09	No	Replaced `definitions`
`$dynamicAnchor`	Core	2020-12	No	Replaced `$recursiveAnchor`
`$dynamicRef`	Core	2020-12	No	Replaced `$recursiveRef`
`$recursiveAnchor`	Core	2019-09	2020-12	Replaced by `$dynamicAnchor`
`$recursiveRef`	Core	2019-09	2020-12	Replaced by `$dynamicRef`
`$ref` (legacy)	Core	03	2019-09	Replaced by `$ref`
`$ref`	Core	2019-09	No	Replaced `$ref` (legacy)
`$schema`	Core	03	No	No
`$vocabulary`	Core	2019-09	No	No
`additionalItems`	Core	03	2020-12	Replaced by `items`
`allOf`	Core	04	No	No
`anyOf`	Core	04	No	No
`const`	Validation	06	No	No
`contains`	Core	06	No	No
`contentEncoding`	Validation	07	No	No
`contentMediaType`	Validation	07	No	No
`contentSchema`	Validation	2019-09	No	No
`definitions`	Validation	04	No	Replaced by`$defs`
`default`	Validation	01	No	No
`dependencies`	Core	03	No	No
`dependentRequired`	Validation	2019-09	No	No
`dependentSchemas`	Core	2019-09	No	Replaced `dependencies`
`deprecated`	Validation	2019-09	No	No
`disallow`	Validation	03	Yes	No
`divisibleBy`	Validation	02	No	Replaced by `multipleOf`
`else`	Core	07	No	No
`enum`	Validation	01	No	No
`examples`	Validation	06	No	No
`exclusiveMaximum`	Validation	03	No	Replaced `maximumCanEqual`
`exclusiveMinimum`	Validation	03	No	Replaced `minimumCanEqual`
`extends`	Validation	03	Yes	No
`format`	Validation	02	No	-
`id`	Core	04	No	Replaced by `$id`
`if`	Core	07	No	No
`items`	Core	2019-09	No	Replaced by `prefixItems`
`maxContains`	Validation	2019-09	No	No
`maxProperties`	Validation	04	No	No
`maximumCanEqual`	Validation	02	No	Replaced by `exclusiveMaximum`
`minimumCanEqual`	Validation	02	No	Replaced by `exclusiveMinimum`
`minContains`	Validation	2019-09	No	No
`minProperties`	Validation	04	No	No
`multipleOf`	Validation	04	No	Replaced `divisibleBy`
`not`	Core	04	No	No
`oneOf`	Core	04	No	No
`optional`	Validation	02	No	Replaced by `required`
`pattern`	Core	03	No	No
`patternProperties`	Core	03	No	No
`prefixItems`	Core	2020-12	No	Replaced `items`
`propertyNames`	Core	06	No	No
`readOnly`	Validation	01	No	No
`required`	Validation	03	No	No
`requires`	Core	01	03	Replaced by `dependencies`
`title`	Validation	01	No	No
`then`	Core	07	No	No
`type`	Validation	02	No	No
`unevaluatedItems`	Core	2019-09	No	No
`unevaluatedProperties`	Core	2019-09	No	No
`uniqueItems`	Assertion	02	Yes	No
`writeOnly`	Validation	07	No	No

For a detailed read-through about all the changes see each Draft migration guide.

Draft 2019-09 to Draft 2020-12

Details for migrations from Draft 2019-09 to 2020-12.

Draft-07 to Draft 2019-09

Details for migrations from Draft-07 to 2019-09.

Draft-06 to Draft-07

Details for migrations from Draft-6 to Draft-07.

Draft-05 to Draft-06

Details for migrations from Draft-05 to Draft-06.

Did you find these docs helpful?

Help us make our docs great!

At JSON Schema, we value docs contributions as much as every other type of contribution!

Edit this page on Github

Learn how to contribute

Still Need Help?

Learning JSON Schema is often confusing, but don't worry, we are here to help!.

Ask the community on GitHub

Ask the community on Slack