NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI · #2275 most downloaded on PyPI
A jsonschema CLI and pre-commit hook
Last release 11 days ago
23 Sep 2026
Ships on a steady schedule
a new release about every 5 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
6 years old
100 releases · first in 2021
One column per quarter.
Update the version of click declared as a dependency
click declared as a dependencyUpdate vendored schemas: bitbucket-pipelines, buildkite, changie, circle-ci, compose-spec, dependabot, github-actions, github-workflows, gitlab-ci, me
check-jsonschema now has a logo. Thanks to Mylah Birdie!Update vendored schemas: bitbucket-pipelines, buildkite, circle-ci, codecov, compose-spec, dependabot, gitlab-ci, mergify, readthedocs, renovate, task
check-github-workflows-require-timeout pre-commit hook for requiring timeout-minutes on all GitHub Workflow jobs. (:issue:639)Update vendored schemas: bitbucket-pipelines, buildkite, changie, github-workflows, gitlab-ci, mergify, renovate, snapcraft, travis, woodpecker-ci (20
Update vendored schemas: bitbucket-pipelines, circle-ci, dependabot, github-workflows, gitlab-ci, mergify, readthedocs, renovate, snapcraft, woodpecke
Update vendored schemas: bitbucket-pipelines, buildkite, circle-ci, dependabot, drone-ci, github-actions, github-issue-forms, github-workflows, gitlab
Update vendored schemas: buildkite, circle-ci, dependabot, github-workflows, gitlab-ci, mergify, readthedocs, renovate, woodpecker-ci (2026-03-25)
Update vendored schemas: bamboo-spec, bitbucket-pipelines, circle-ci, gitlab-ci, mergify, renovate, woodpecker-ci (2026-02-26)
-v), all errors are reported but the checked filenames are no longer displayed. The list of filenames checked is now emitted at the second verbosity level (-vv) and above. (#648)check-jsonschema's sdist contents are now validated with check-sdist, and missing files have been added.Update vendored schemas: circle-ci, gitlab-ci, mergify, renovate, snapcraft, woodpecker-ci (2026-02-15)
Update vendored schemas: buildkite, circle-ci, dependabot, github-issue-forms, github-workflows, gitlab-ci, mergify, readthedocs, renovate, snapcraft,
Update vendored schemas: bitbucket-pipelines, buildkite, circle-ci, dependabot, gitlab-ci, mergify, readthedocs, renovate, snapcraft (2025-12-14)
edgarrmondragon! (:pr:626)Update vendored schemas: bitbucket-pipelines, buildkite, circle-ci, compose-spec, dependabot, gitlab-ci, meltano, mergify, renovate, snapcraft (2025-1
Update vendored schemas: azure-pipelines, bamboo-spec, buildkite, circle-ci, drone-ci, github-workflows, gitlab-ci, meltano, mergify, renovate, woodpe
Update vendored schemas: bitbucket-pipelines, buildkite, compose-spec, dependabot, drone-ci, github-issue-forms, gitlab-ci, meltano, mergify, renovate
Update vendored schemas: bitbucket-pipelines, buildkite, compose-spec, dependabot, drone-ci, github-issue-forms, gitlab-ci, meltano, mergify, renovate, snapcraft, woodpecker-ci (2025-09-17)
Add GitHub issue config schema and pre-commit hook. Thanks vivodi! (589)
Add GitHub issue form schema and pre-commit hook. Thanks vivodi! (588)
Add Codecov config schema and pre-commit hook. Thanks vivodi! (598)
Update vendored schemas: bitbucket-pipelines, buildkite, compose-spec, dependabot, github-actions, gitlab-ci, meltano, mergify, renovate, taskfile, wo
Update vendored schemas: bitbucket-pipelines, mergify, renovate (2025-06-29)
date-time format on non-string data, which incorrectly rejected values for which string was one of several valid types. Thanks @katylava! (#571)Update vendored schemas: bamboo-spec, bitbucket-pipelines, circle-ci, cloudbuild, compose-spec, dependabot, drone-ci, github-actions, github-workflows
click==8.2.0Last-Modified header parsing which used local time and could result in improper caching. Thanks @fenuks! (#565)Update vendored schemas: bitbucket-pipelines, buildkite, circle-ci, compose-spec, github-workflows, mergify, renovate, taskfile, woodpecker-ci (2025-0
--force-filetype, is now supported and allows users to explicitly specify which parser should be used for instance files. Thanks @mschoettle! (#557, #341)Fix the check-meltano hook to use types_or. Thanks @edgarrmondragon!
check-meltano hook to use types_or. Thanks @edgarrmondragon! (#543)Fix the check-meltano hook to use types_or. Thanks edgarrmondragon! (543)
Update vendored schemas: circle-ci, compose-spec, dependabot, github-workflows, gitlab-ci, mergify, renovate, taskfile (2025-03-25)
Update vendored schemas: circle-ci, compose-spec, dependabot, github-workflows, gitlab-ci, mergify, renovate, taskfile (2025-03-25)
Add Meltano schema and pre-commit hook. Thanks edgarrmondragon! (540)
Add Snapcraft schema and pre-commit hook. Thanks fabolhak! (535)
Update vendored schemas: circle-ci, github-workflows, mergify, renovate, taskfile (2025-03-07)
Update vendored schemas: dependabot, github-workflows, gitlab-ci, mergify, renovate, woodpecker-ci (2025-02-19)
Update vendored schemas: buildkite, cloudbuild, compose-spec, mergify, renovate (2025-01-26)
gitlab and renovate hooks to use --regex-variant nonunicode. Thanks @quentin-ag and @Callek for reporting! (#516, #518)ruamel.yaml version to a range, >=0.18.10,<0.19.0.Update vendored schemas: buildkite, cloudbuild, compose-spec, mergify, renovate (2025-01-26)
Update the gitlab and renovate hooks to use --regex-variant nonunicode. Thanks quentin-ag and Callek for reporting! (516, 518)
Update the required ruamel.yaml version to a range, >=0.18.10,<0.19.0.
Rename --format-regex to --regex-variant and convert --format-regex to a deprecated alias. It will be removed in a future release.
Update vendored schemas: azure-pipelines, bamboo-spec, buildkite, circle-ci, dependabot, gitlab-ci, mergify, readthedocs, renovate, taskfile (2025-01-07)
Drop support for Python 3.8
Rename --format-regex to --regex-variant and convert --format-regex to a deprecated alias.
It will be removed in a future release.
Regular expression interpretation in "pattern", "patternProperties", and "format": "regex" usages now uses unicode-mode JS regular expressions by default. (#353)
--regex-variant nonunicode to get non-unicode JS regular expressions, the default behavior from previous versions.jsonschema library's extend() API to control the pattern and patternProperties keywords.This fixes a cache confusion bug in which the wrong schema could be retrieved from the cache. This resolves CVE-2024-53848. Thanks @sethmlarson for re…
--cache-filename flag. It no longer has any effect and will be removed in a future release.Update vendored schemas: azure-pipelines, github-workflows, gitlab-ci, mergify, renovate (2024-10-06)
.renovaterc.json5 as well. Thanks @tpansino! (#491)Update vendored schemas: azure-pipelines, github-workflows, gitlab-ci, mergify, renovate (2024-10-06)
Fix the renovate hook to allow for .renovaterc.json5 as well. Thanks tpansino! (491)
Add Mergify schema and pre-commit hook. Thanks hofbi and jd for the issue and feedback! (487)
Update vendored schemas: buildkite, circle-ci, dependabot, gitlab-ci, renovate, taskfile, woodpecker-ci (2024-09-29)
Update vendored schemas: buildkite, github-workflows, gitlab-ci, renovate, woodpecker-ci (2024-08-22)
setup.cfg to pyproject.toml for python package metadataUpdate vendored schemas: circle-ci, dependabot, gitlab-ci, renovate, woodpecker-ci (2024-07-21)
--schemafile evaluation. This also fixes a bug in the remote $ref cache. Thanks @alex1701c for reporting! (#463, #466)Update vendored schemas: github-workflows, renovate, woodpecker-ci (2024-07-07)
$ref downloads. This should improve performance in cases where a schema has many remote refs and is used in repeat invocations. The $ref cache can be disabled via the same --no-cache flag which disables use of the pre-existing cache. Thanks @alex1701c! (#452, #454)Update vendored schemas: bitbucket-pipelines, circle-ci, readthedocs, renovate (2024-06-23)
Update vendored schemas: bitbucket-pipelines, circle-ci, readthedocs, renovate (2024-06-23)
Add CircleCI schema and pre-commit hook. Thanks jrdnbradford! (444)
Update vendored schemas: bitbucket-pipelines, dependabot, github-actions, github-workflows, gitlab-ci, readthedocs, renovate (2024-06-10)
intellij-bitbucket-references-plugin. For more details on this decision, see #440.
Thanks @blade2005 for the PR! (#442)Update vendored schemas: buildkite, github-workflows, gitlab-ci, renovate, taskfile, woodpecker-ci (2024-05-19)
Update vendored schemas: dependabot, github-workflows, gitlab-ci, renovate, woodpecker-ci (2024-05-05)
Update vendored schemas: cloudbuild, gitlab-ci, renovate (2024-04-10)
Update vendored schemas: cloudbuild, gitlab-ci, renovate (2024-04-10)
Add Taskfile schema and pre-commit hook. Thanks jrdnbradford! (417)
Update vendored schemas: buildkite, cloudbuild, dependabot, github-actions, github-workflows, gitlab-ci, renovate, woodpecker-ci (2024-03-31)
Update vendored schemas: cloudbuild, dependabot, gitlab-ci, readthedocs, renovate (2024-02-06)
date-time format validation (RFC 3339) and time format validation (ISO 8601). This makes the date-time and time formats always available for validation. (#378)orjson for faster JSON parsing when it is installed. This makes it an optional parser which is preferred over the default json module when it is available.tomli on older Python versions, ensuring that TOML formatted data is always supported. Users should no longer need to install tomli manually in order to use TOML files.Update vendored schemas: cloudbuild, dependabot, drone-ci, github-actions, github-workflows, gitlab-ci, renovate, travis (2024-01-29)
Update vendored schemas: bitbucket, gitlab-ci, readthedocs, renovate (2023-12-05)
Update vendored schemas: dependabot, github-workflows, renovate (2023-11-24)
github-workflows-require-timeout schema which forbade the use of GitHub expression syntax for the timeout value. (#354)Update vendored schemas: buildkite, drone-ci, github-workflows, gitlab-ci, readthedocs, renovate (2023-11-03)
Update vendored schemas: azure-pipelines, bitbucket-pipelines, gitlab-ci, renovate (2023-09-27)
--validator-class option for specifying a custom jsonschema.protocols.Validator class to use (#327, #262)- (#332, #251). chars. Thanks @skwde! (#325)Fix a minor bug with the verbose output introduced in v0.26.2
When -v/--verbose is used, output will include a list of all files which were checked on success
-v/--verbose is used, output will include a list of all files which were checked on success (#312)Update vendored schemas: github-workflows, renovate (2023-08-25)
The deprecated --disable-format flag has been removed. Users should use --disable-formats "*" if they wish to disable all format checking.
--format-regex disabled option has been removed. Users should use --disable-formats regex if they wish to disable regex format checking.--disable-format flag has been removed. Users should use --disable-formats "*" if they wish to disable all format checking.Update vendored schemas: bamboo-spec, dependabot, drone-ci, github-actions, github-workflows, readthedocs, renovate, travis (2023-08-25)
--base-uri option for specifying an explicit base URI (#305)Update vendored schemas: bamboo-spec, dependabot, drone-ci, github-actions, github-workflows, readthedocs, renovate, travis (2023-08-25)
Add Drone-CI schema and pre-commit hook. Thanks s-weigand! (299)
Add a --base-uri option for specifying an explicit base URI (305)
Fix bugs related to the new $ref resolution behavior
$ref resolution behavior (https://github.com/python-jsonschema/check-jsonschema/pull/298)Full Changelog: https://github.com/python-jsonschema/check-jsonschema/compare/0.24.0...0.24.1
<!-- Release notes generated using configuration in .github/release.yml at 0.24.0 -->
<!-- Release notes generated using configuration in .github/release.yml at 0.24.0 -->
referencing implementation in jsonschema (https://github.com/python-jsonschema/check-jsonschema/pull/289)
$ref usage may now refer to YAML, TOML, or JSON5 files, or any other non-JSON format supported by check-jsonschema. The file type is inferred only from the file extension in these cases and defaults to JSON if there is no recognizable extension.Full Changelog: https://github.com/python-jsonschema/check-jsonschema/compare/0.23.3...0.24.0
Update vendored schemas: buildkite, dependabot, github-workflows, gitlab-ci, readthedocs, renovate
Full Changelog: https://github.com/python-jsonschema/check-jsonschema/compare/0.23.2...0.23.3
Update vendored schemas: buildkite, dependabot, github-workflows, gitlab-ci, readthedocs, renovate (2023-07-11)
Add Bitbucket Pipelines schema and pre-commit hook. Thanks djgoku! (282)
Update vendored schemas: github-workflow, gitlab-ci, renovate
Full Changelog: https://github.com/python-jsonschema/check-jsonschema/compare/0.23.1...0.23.2
Update vendored schemas: github-workflow, gitlab-ci, renovate (2023-06-13)
Fix the handling of malformed and missing Last-Modified headers in the caching downloader. Thanks balihb! (275)
## What's Changed - Updates to built-in schemas Full Changelog: https://github.com/python-jsonschema/check-jsonschema/compare/0.23.0...0.23.1
Full Changelog: https://github.com/python-jsonschema/check-jsonschema/compare/0.23.0...0.23.1
Update vendored schemas: github-workflows, gitlab-ci, renovate (2023-05-30)
The schema for enforcing timeout-minutes on GitHub Actions jobs has been updated to allow for workflow call jobs (which cannot have a timeout)
Update ruamel.yaml to latest by @sirosen in https://github.com/python-jsonschema/check-jsonschema/pull/260
--disable-formats flag to replace --disable-format by @sirosen in https://github.com/python-jsonschema/check-jsonschema/pull/261Full Changelog: https://github.com/python-jsonschema/check-jsonschema/compare/0.22.0...0.23.0
Update vendored schemas: azure-pipelines, buildkite, dependabot, github-workflows, gitlab-ci, renovate (2023-05-03)
A new option, --disable-formats replaces and enhances the --disable-format flag. --disable-formats takes a format to disable and may be passed multiple times, allowing users to opt out of any specific format checks. --disable-formats "*" can be used to disable all format checking. --disable-format is still supported, but is deprecated and emits a warning.
Add a check for tests which are always skipped by @sirosen in https://github.com/python-jsonschema/check-jsonschema/pull/240
Full Changelog: https://github.com/python-jsonschema/check-jsonschema/compare/0.21.0...0.22.0
Update vendored schemas: buildkite, github-workflows, gitlab-ci, renovate, travis (2023-03-08)
The check-dependabot hook now also supports .github/dependabot.yaml Thanks noorul!
Fix a mistake in the dependency bound for jsonschema, which was intended to change in v0.21.0
Update vendored schemas: github-workflows, gitlab-ci, renovate (2023-01-24)
Update vendored schemas: github-workflows, gitlab-ci, renovate (2023-01-24)
Fix a bug in which --check-metaschema was not building validators correctly. The metaschema's schema dialect is chosen correctly now, and metaschema formats are now checked by default. This can be disabled with --disable-format.
Fix the resolution of $schema dialect to format checker classes
Fix package dependency lower bounds, including setting jsonschema>=4.5.1
Output colorization can now be controlled with --color [never|always|auto]. Thanks WillDaSilva!
Update vendored schemas: bamboo-spec, buildkite, dependabot, github-actions, github-workflows, gitlab-ci, readthedocs, renovate, travis (2023-01-03)
Update vendored schemas: bamboo-spec, buildkite, dependabot, github-actions, github-workflows, gitlab-ci, readthedocs, renovate, travis (2023-01-03)
Add --fill-defaults argument which eagerly populates "default" values whenever they are encountered and a value is not already present (200)
Add Buildkite schema and pre-commit hook (198)
Remove the deprecated --show-all-validation-errors option
Update vendored schemas: gitlab-ci, renovate (2022-11-14)
Downloads of schemas from remote (http/https) locations will now retry if the downloaded data is not valid JSON (183)
Remove the deprecated --show-all-validation-errors option
Add support for Python 3.11, and tomllib as an alternative to tomli
The github-actions hook now requires a filename of action.yml or action.yaml for action definitions in .github/actions/, in accordance with the GitHub Documentation (186)
Fix handling of file descriptors created using the /proc/self/fd/ mechanism (176)
Fix handling of file descriptors created using the /proc/self/fd/ mechanism (176)
Update vendored schemas: github-workflows, gitlab-ci, renovate (2022-11-10)
Update vendored schemas: github-workflows, gitlab-ci, renovate (2022-11-10)
Improve the behaviors of filetype detection. --default-filetype now defaults to json, and can be passed toml or json5 if those parsers are installed. Detection is now only done by suffix mapping and will not attempt to read files.
Tweak format checker usage to avoid deprecation warning from jsonschema
Update vendored schemas: bamboo-spec, dependabot, github-workflows, gitlab-ci, renovate (2022-10-20)
Tweak format checker usage to avoid deprecation warning from jsonschema
The Azure Pipelines data transform is now more permissive, which should allow it to handle a wider variety of pipelines files (162)
Your coding agent can read these notes before it upgrades. Set up the MCP server →