---
title: "JSON Diff Checker"
description: "Compare two JSON documents in one tool. Default view lists semantic paths (added, removed, modified). Switch to unified pretty-print for a git-style line diff."
url: https://findutils.com/developers/json-diff/
category: developers
---

# JSON Diff Checker

Compare two JSON documents in one tool. Default view lists semantic paths (added, removed, modified). Switch to unified pretty-print for a git-style line diff.

**Use this tool:** [JSON Diff Checker](https://findutils.com/developers/json-diff/)

## Programmatic access

- REST id `json-diff`: POST https://api.findutils.com/api/tools/json-diff/execute (reference: https://findutils.com/api/json-diff/)
- MCP tool `json_diff` on https://mcp.findutils.com (reference: https://findutils.com/mcp/json-diff/)

## Why Use JSON Diff Checker?

JSON Diff Checker is one tool with two modes. Semantic paths list which keys were added, removed, or modified. Unified pretty-print formats both documents and shows a git-style line diff. Paste left and right JSON once, then switch modes without pasting again.

## Tips for Effective JSON Comparison

- Format both JSON inputs before comparing to ensure consistent indentation and make the diff output easier to read.
- Use the 'Ignore Key Order' option when comparing objects generated by different systems that may serialize keys in different orders.
- Click any property path in the diff results to copy it. This is handy for referencing specific changes in bug reports or code reviews.
- For large JSON files, use the filter tabs to focus on one change type at a time instead of scrolling through all differences.
- Swap the left and right panels to reverse the perspective of the diff, turning additions into removals and vice versa.

## Frequently Asked Questions

### What is semantic JSON comparison?

Semantic comparison walks JSON structure. It matches objects by keys and values, so formatting and key order do not create false diffs. That is the default mode on this page.

### What is unified pretty-print mode?

Unified pretty-print formats both JSON documents and then shows a git-style line diff with + and - prefixes. Use it when you want the same view you see in a pull request. Paste once, then switch from Semantic paths.

### How are arrays compared in semantic mode?

Arrays are compared by index. If an array item is added or removed, later items can show as modified because their indices shifted.

### Can I drag and drop JSON files?

Yes. Drag a .json file onto either panel. The file content loads in that panel.

### Can I filter the diff results?

Yes. Semantic mode filters added, removed, or modified properties. Unified mode filters added or removed lines. Click a property path in semantic mode to copy it.

### Does JSON Diff Checker require a signup?

No. There is no signup and no usage limit. The compare runs in your browser. Your JSON is not uploaded.

### What is the maximum file size supported?

The compare runs in your browser, so the limit depends on device memory. Most browsers handle JSON files up to 10 MB. Split larger files first.

### How is this different from a regular text diff?

A regular text diff compares raw lines, so reformatting or reordering keys can look like a change. Semantic mode parses both documents and reports only data changes. Unified mode still compares lines, but only after pretty-print.

### Can I use JSON Diff Checker to compare API responses?

Yes. Paste one response on the left and the other on the right. Semantic mode lists every field that differs. Unified mode shows the formatted line view.

### Does JSON Diff Checker handle comments or trailing commas?

Standard JSON does not support comments or trailing commas, and the parser flags them as invalid. Remove those elements first, or use the JSON Formatter to clean the input.

## Related Tools

- [CSV Diff](https://findutils.com/convert/csv-diff/)
- [JSON Formatter](https://findutils.com/developers/json-formatter/)
- [Visual JSON Editor](https://findutils.com/developers/visual-json/)
- [Diff Checker](https://findutils.com/text/diff-checker/)
- [JSON Path Finder](https://findutils.com/developers/json-path-finder/)
- [JSON Schema Validator](https://findutils.com/developers/json-schema-validator/)
- [JSON Minifier](https://findutils.com/developers/json-minifier/)
- [JSON to TypeScript](https://findutils.com/developers/json-to-typescript/)