6 min read

Minified JSON vs formatted JSON

Formatted JSON is for humans, minified JSON is for compact transport. The data is the same, but the workflow is different.

Table of contents

  1. Formatted JSON
  2. Minified JSON
  3. Choosing the right form
  4. A simple workflow

Formatted JSON

Formatted JSON includes line breaks and indentation. It is easier to read, review, debug, and document. When humans need to understand the structure, formatted JSON is the right choice. It makes nesting visible and reduces the chance of missing important fields.

Formatted JSON is especially useful in examples, configuration files, pull requests, and support conversations.

Minified JSON

Minified JSON removes whitespace outside string values. It is compact and usually appears as one line. This is useful when a payload needs to be embedded in a small field, sent over a network, or compared in normalized form.

Minification does not change object keys or values. If it does, something is wrong with the conversion process.

Choosing the right form

Use formatted JSON when a person will read or edit the data. Use minified JSON when compact output matters and the JSON will mostly be consumed by machines. Many workflows use both: format while debugging, then minify when copying into a compact target.

Always validate before switching formats. A formatter or minifier should parse first and only produce output when the input is valid.

A simple workflow

When you receive a payload, validate it. If it is valid, format it for inspection. Make any edits in formatted form. Validate again. If you need compact output, minify the final version. This keeps the human editing step clear while still producing machine-friendly output when needed.

Related guides

FAQ

Does minified JSON contain less data?

No. It contains the same data with less whitespace.

Is formatted JSON slower?

Whitespace adds bytes, but for debugging and documentation readability is usually more important.

Can minified JSON be formatted again?

Yes. As long as it is valid JSON, it can be formatted again at any time.

Which should I commit to a repository?

For human-edited files, formatted JSON is usually better. Generated compact files are a separate case.