JSON Diff

JSON diff is used for: comparing API responses between staging and production environments to catch regressions, reviewing changes to configuration files stored as JSON, debugging differences between an expected and actual test output, reviewing database schema migrations that export as JSON, and auditing changes to API response contracts between versions.

No — JSON objects are unordered by definition. This tool compares by key names, not position. {"a":1,"b":2} and {"b":2,"a":1} are considered identical. However, JSON arrays are ordered — [1,2,3] and [3,2,1] are different. Array element order is preserved and compared by position in this tool.

Arrays are compared element by element by index. If the original has 3 elements and the modified has 5, indices 0–2 are diffed normally; indices 3 and 4 are marked as added. This positional comparison is simpler than a full LCS diff but works well for most structured data comparisons. For complex array-of-objects diffing, consider using a tool like json-patch or a proper LCS algorithm.

JSON Diff (this tool) is a human-readable visualization of differences between two JSON documents. JSON Patch (RFC 6902) is a machine-readable format that describes the exact sequence of operations (add, remove, replace, move, copy, test) to transform one JSON document into another. JSON Patch is used for partial updates in REST APIs — you PATCH a resource by sending the patch document, not the full updated resource. JSON Diff visualization and JSON Patch are related concepts but serve different purposes.

Several CLI tools perform JSON diff: jq for sorting and normalizing before standard diff: diff <(jq -S . a.json) <(jq -S . b.json). The json-diff npm package: npm install -g json-diff && json-diff a.json b.json. Python's deepdiff library: python3 -c "from deepdiff import DeepDiff; import json; print(DeepDiff(json.load(open('a.json')),json.load(open('b.json'))))".

Yes. null in JSON is a distinct value. A key changing from a non-null value to null is marked as changed. A key that is absent from an object is different from a key that is present with a null value. This tool correctly distinguishes between a missing key (added/deleted) and a null-valued key (changed if it was previously a different value).

JSON Merge Patch (RFC 7396) is a simpler alternative to JSON Patch for partial updates. You send a document with only the changed keys — if a key maps to null, it is deleted; if a key is missing, it is unchanged; if a key has a value, that key is updated. For example, to update only the "age" field: PATCH /user with body {"age": 30}. It is less powerful than JSON Patch (no array operations, no move) but easier to construct programmatically.

Yes. All JSON comparison happens entirely in your browser using JavaScript — no data is sent to any server. You can use this tool safely with sensitive or proprietary JSON data, including configuration files, API credentials structures, and database exports. The tool works offline once the page is loaded.

In JavaScript, use the json-diff or deep-diff npm packages. In Python, use the deepdiff package. In PHP, implement a recursive array comparison or use a library like swaggest/json-diff. For producing RFC 6902 JSON Patch documents, use libraries like json-patch-generator (JavaScript) or php-json-patch (PHP) which output a machine-readable patch that can be applied with json-apply-patch.