JSON Smart Diff
Dual pane · Add/remove/change highlight · Text/visual
JSON Diff
Ready
ABOUT
About JSON Smart Diff
Compare two JSON documents for structural and value differences—visual highlights or text report—to spot API response changes fast.
Pre-release API contract checks, config drift, Mock data updates—Diff is one of the most common JSON tasks. JSONSort diffs locally; neither copy leaves your device.
DEEP DIVE
Learn more about JSON Smart Diff
API versions, hot config updates, A/B regression—you often need "where do these two JSON files differ?" Plain text diff is noisy for JSON: key order and indentation create false signals. JSONSort compares by JSON semantics with clear add/remove/change highlights.
Visual dual-pane Diff and plain text report. Visual for quick scans; text for PR descriptions or Jira tickets.
Diff uses parsed JSON AST—not line-by-line text. Indent or key-order tweaks won't false-positive; real adds, deletes, and value changes highlight—handy for Code Review and release checklists.
FEATURES
Core capabilities
Dual-pane input
Left baseline, right comparison—intuitive layout.
Visual highlights
Green added, red removed, yellow changed—structure changes at a glance.
Text Diff report
Switch to plain text diff for copy into docs or IM.
Semantic structure compare
Compare by JSON key/value semantics—less whitespace/order noise.
Local processing
Neither JSON uploads—safe for sensitive API responses.
Live refresh
Either side changes → auto re-diff, no button click.
Summary
Change stats and path-level summary for PR descriptions.
Dual mode toggle
Switch visual vs text report in one click.
HOW TO USE
How to use
-
1
Paste JSON in left and right panes
-
2
Choose visual or text Diff mode
-
3
Review highlights and copy the report
-
4
Adjust indent, JSON5, sort, and other advanced options in the toolbar
-
5
Copy results or continue with Diff, path query, and other tools
WORKFLOW
Typical workflow
End-to-end flow from import to export so teams use JSON Smart Diff consistently.
Prepare two JSON files
Left: baseline (old API / prod config). Right: version to compare.
Pre-format (optional)
Format both sides separately to reduce whitespace noise while reading.
Pick Diff mode
Visual for quick scan; text report for archival.
Confirm changes
Walk highlights to verify expected changes; copy summary to PR.
USE CASES
Use cases
Backend developers
Review API v1 → v2 response changes—deprecated and new fields.
QA engineers
Regression: diff actual vs expected JSON.
DevOps
Compare ConfigMap JSON between two deploys.
Frontend developers
After Mock updates, Diff which fields affect component rendering.
API product
Diff doc examples vs live responses—docs match implementation.
Config admin
Pre/post release: diff Nacos / Apollo exported JSON configs.
TIPS
Tips
- Format both JSON sides before diffing for cleaner results.
- For large JSON, strip unneeded fields (merge & clean) then diff the core.
- Text report summary works as changelog material.
- Arrays compare by index—if order doesn't matter, sort first.
- Visual mode: both panes scroll independently for same-level fields.
- API debugging: paste two Postman responses—diff in seconds.
- For v1/v2 APIs, save each version as a file for repeat diffs.
- Only care about some fields? Path extract subtrees first, then diff.
- Text report attaches well to Slack / Feishu tickets as change records.
- When sizes differ wildly, confirm you didn't grab the wrong environment.
LOCAL VS ONLINE
Local vs online tools
JSONSort stays purely frontend—this comparison shows why local tools fit dev data better.
TROUBLESHOOTING
Common pitfalls & fixes
Issues you may hit in practice and how to handle them—save time on trial and error.
Too much Diff noise
Tip:Format and sort keys on both sides; or drop timestamps and other moving fields.
Array elements don't line up
Tip:Arrays diff by index—sort first or build an id map if you only care about set content.
One side failed to parse
Tip:Fix syntax with the formatter first—both sides must be valid JSON.
Looks the same but differs
Tip:Check hidden type differences (string "123" vs number 123).
FAQ
FAQ
Does array order count as a difference?
Yes—compared index by index; reorder shows as modify or add/remove.
Can I diff JSON and JSON5?
Yes. Each side parses independently; compared as JSON structure after parse.
Can I export visual Diff?
Copy summary and diff content from text report mode.
Must both sides be valid JSON?
Yes. Parse errors show the failing side and line.
Do float precision differences count?
Yes—0.1 + 0.2 style float representation shows as-is; normalize numbers if needed.
Can I ignore certain fields?
Full compare today. Delete keys you don't care about first, or preprocess with merge tools.
Is data uploaded to a server?
No. All JSONSort tools run locally in your browser—your input is never sent to any backend.
Do I need to sign up or install anything?
No. Open the page and go—no account, no client download, PWA offline cache supported.
How large can files be?
Depends on browser memory; multi-MB data usually runs smoothly. Split very large files or use merge & clean first.