Pure Frontend · Recursive Comparison · Path Tracking · Highlight Changes
Zero Dependencies · Works OfflineWhat can JSON Schema Diff Viewer do?
JSON Schema Diff Viewer is a pure frontend online tool for comparing structural differences between two JSON Schema definitions. Input old and new Schemas, and the tool automatically recursively compares property definitions, types, constraints, etc., highlighting added, removed, and modified fields with full property path tracking. Supports ignoring non-functional differences like description/title. All computation happens on your device — JSON Schema Diff Viewer, other values and other inputs stay in your browser.
Core Features
- Recursive Comparison: Automatically dives into nested object and array definitions, comparing layer by layer
- Diff Classification: Added (green), removed (red), modified (yellow) three-color highlighting
- Path Tracking: Shows full property path for each diff, e.g.
properties.user.properties.age - Smart Filtering: Can ignore non-functional differences like description, title
- Statistics Summary: Shows count of added/removed/modified changes
How to Use
Step 1: Paste the old JSON Schema in Schema A input.
Step 2: Paste the new JSON Schema in Schema B input.
Step 3: Click "Compare Diff" or Ctrl+Enter to see the diff report.
Step 4: Click "Copy Report" or "Download" to export the diff result.
Use Cases
API Version Migration
Compare API v1 and v2 Schema definitions to quickly identify field changes and assess client compatibility impact.
Data Model Evolution
Track database model Schema version changes, recording field additions, deletions, and modifications for each iteration.
Team Collaboration Review
Compare Schema changes in Code Review to ensure modifications meet expectations and avoid missing breaking changes.
CI/CD Integration
Integrate Schema diff reports into CI pipelines to automatically detect API compatibility changes.
Extended Knowledge
JSON Schema is a specification for describing JSON data structure (JSON Schema Draft 2020-12, etc.). When comparing two Schemas, the core is comparing properties, required, type, items, and other key fields. The recursive comparison algorithm traverses each property in properties, continuing deeper for nested object types. Diff detection includes: property existence, type changes, constraint changes (min/max/enum/pattern, etc.), required array changes. In API design, Schema diff comparison is an important method for ensuring backward compatibility.
FAQ
What is JSON Schema diff?
JSON Schema diff compares two JSON Schema definitions to find structural differences, including added fields, removed fields, type changes, constraint changes, etc.
What diff types are supported?
Supports added properties, removed properties, type changes, required changes, format changes, enum value changes, min/max constraint changes, nested object recursive diffs.
Can it compare nested Schemas?
Yes. The tool supports recursive comparison of nested object and array definitions, automatically tracking property paths.
Can I export the diff result?
Yes. You can copy the diff report as JSON format or download it as a file.
Is my data uploaded to a server?
No. All Schema comparison is done locally in your browser. Your data is never uploaded.
What scenarios is this tool best for?
Best for API version migration, data model evolution tracking, Schema compatibility checking, and team collaboration Schema change review.