Need help with jdd?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

659 Stars 133 Forks Apache License 2.0 119 Commits 10 Opened issues


A semantic JSON compare tool

Services available


Need anything else?

Contributors list

# 129,145
100 commits
# 461,456
3 commits
# 561,276
1 commit
# 563,965
1 commit


JSON Diff expands on the amazing work by the team at and provides a semantic compare tool for JSON documents.

I often work with large documents and it's difficult to see the differences between them. Normal text compare tools work well for finding the differences in JavaScript code, but JSON data can have many differences in the text that don't actually change the data.

JSON Diff sorts, formats, and compares two JSON documents to find the actual semantic differences instead of just the text ones.

Try it out:

Run the built-in unit tests:

Run JSONDiff in a Docker container

You can also run JSONDiff in a Docker container if you want to run it in your data center or just on your laptop. First install Docker and then open a terminal the run the following commands:

docker build -t jdd:v1 .
docker run -i --name jdd -p jdd:v1

Load my JSON data from the Internet

JSONDiff also supports two query paramaters so you can load your JSON data from the Internet instead of having to enter it into the UI.

| Parameter | Description | | --- | --- | |

| An URL to the file to compare on the left side of the diff | |
| An URL to the file to compare on the right side of the diff |

These parameters work like this:

Each parameter must be a full URL and must be publicly accessible over the Internet.

Is JSONDiff Secure?

You might notice that doesn't run with HTTPS and ask, is JSONDiff secure? The short answer is yes, but you shouldn't take my word for it.

JSONDiff does all of the comparing in the browser. It never sends any of your JSON data anywhere and you can run a little experiment to prove it.

Open the developer tools in your browser and select the Network tab. You'll see all of the requests your browser sends. It looks like this:

Network tools image

Now do a JSON compare with some sample data and watch the requests. There will be no new requests. That shows that we don't send your data anywhere.

What data does JSONDiff load?

JSONDiff loads the following files when it first starts up:

| File | Description | | --- | --- | |

| The main index page for the site | |
| The reset CSS file | |
| A CSS loading icon | |
| The CSS file for JSONDiff | |
| jQuery library used in the JSONDiff UI | |
| The JSON formatter and parser that JSONDiff uses when doing a compare | |
| The code that runs JSONDiff | |
| Google Analytics that we use to see how many people are using | |
| The JSONDiff icon that shows up in the tab of your browser |

Why don't you use HTTPS?

The short answer is that we don't need to. HTTPS protects the traffic being sent between your browser and a server so nobody in the middle can see it. JSONDiff doesn't send any data so there's nothing to protect.

What data does JSONDiff send back over the Internet?

It sends nothing. It just loads the open source files it needs to run and never sends any of the JSON data it is comparing anywhere.

That still doesn't feel secure enough

If that still doesn't feel secure enough you have some other options. It's very easy to host JSONDiff for yourself. You can either run in a JSON container, or run on any web server that supports PHP. You can even skip the PHP part if you don't want to support loading JSON automatically. Just drop the JSONDiff files in your web server directory and you're done.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.