What Is JSON Formatting?
JSON formatting transforms minified or poorly structured JSON into a human-readable form with proper indentation, line breaks, and consistent spacing. While computers work equally well with compact or formatted JSON, humans find indented JSON far easier to read and understand.
Why JSON Needs Formatting
JSON from APIs, database queries, and log files often arrives minified or with inconsistent formatting:
Minified (machine-readable, hard for humans):
{"user":{"id":1,"name":"Alice","roles":["admin","editor"],"settings":{"theme":"dark","notifications":true}}}
Formatted (human-readable):
{
"user": {
"id": 1,
"name": "Alice",
"roles": [
"admin",
"editor"
],
"settings": {
"theme": "dark",
"notifications": true
}
}
}
JSON Formatting Options
Indentation
- 2 spaces: Most common for web projects (default in many formatters)
- 4 spaces: Common in Python and some style guides
- Tabs: Consistent physical width, but renders differently in different editors
Key Sorting
Sorting object keys alphabetically makes large JSON objects easier to navigate and produces stable diffs in version control.
Array Formatting
Arrays can be formatted with one item per line (better readability) or compact (better for short arrays). Smart formatters apply different rules based on array content and length.
JSON Validation
Formatting tools also validate JSON syntax. Common JSON errors:
- Trailing commas: JSON does not allow commas after the last array/object element (unlike JavaScript)
- Unquoted keys: JSON requires keys to be quoted with double quotes
- Single quotes: JSON uses double quotes only, not single quotes
- Comments: Standard JSON does not support comments (JSON5 and JSONC do)
- Undefined/NaN/Infinity: These JavaScript values are not valid JSON
JSON in Different Contexts
Configuration Files
Most configuration files (package.json, tsconfig.json, .eslintrc.json) use 2-space indentation by convention. Version-controlling these files benefits from consistent formatting for readable diffs.
API Responses
APIs typically serve minified JSON over HTTP. Formatting is applied by developer tools (browser devtools, Postman, Insomnia) for display.
Logs
Structured JSON logging produces minified output. Log analysis tools like Kibana, Splunk, and Datadog parse the raw JSON and format it for display.
Database Storage
PostgreSQL's JSONB type stores JSON internally as binary. The json_pretty() function formats it for display when querying.
JSON Schema
JSON Schema is a vocabulary for annotating and validating JSON documents:
{
"$schema": "http://json-schema.org/draft-07/schema",
"type": "object",
"required": ["name", "email"],
"properties": {
"name": {"type": "string", "minLength": 1},
"email": {"type": "string", "format": "email"},
"age": {"type": "integer", "minimum": 0}
}
}
Validators check JSON data against schemas, catching structure and type errors before they reach application code.
Using the JSON Formatter Tool
Our tool:
- Paste JSON data — accepts minified, partially-formatted, or malformed input
- Instant formatting — applies consistent indentation and line breaks
- Syntax validation — reports errors with line numbers for easy fixing
- Sort keys — optionally alphabetize object properties
- Multiple indent options — 2 spaces, 4 spaces, or tabs
- Minify toggle — switch between formatted and compact views
- Copy formatted JSON — one-click clipboard copy
Use it for reading API responses, debugging JSON data, formatting configuration files, and validating JSON syntax before using it in applications.