What is JSON and How to Format It — A Beginner's Guide
JSON is the language of the web. Whether you are building APIs, reading responses from a third-party service, or debugging a frontend app, you will encounter JSON constantly. This guide explains what it is, how it works, and how to format it cleanly in seconds.
Try the free JSON Formatter
Paste messy JSON and get it clean, readable, and validated instantly.
What is JSON?
JSON stands for JavaScript Object Notation. It is a lightweight, text-based format for storing and exchanging data. Despite the name, JSON is language-independent and is used in Python, Ruby, Go, Java, and virtually every other modern language.
JSON was popularised by Douglas Crockford in the early 2000s as a simpler alternative to XML. Today it is the default data format for REST APIs, configuration files, databases like MongoDB, and browser storage.
JSON Syntax — The Basics
JSON is built on two structures:
- Objects — a collection of key/value pairs wrapped in curly braces
- Arrays — an ordered list of values wrapped in square brackets
A simple JSON object looks like this:
JSON Data Types
JSON supports exactly six data types:
| Type | Example |
|---|---|
| String | "hello" |
| Number | 42 or 3.14 |
| Boolean | true or false |
| Null | null |
| Object | { "key": "value" } |
| Array | [1, 2, 3] |
The Most Common JSON Errors
JSON syntax is strict. One misplaced character breaks the entire document. Here are the errors developers make most often:
1. Trailing commas
JSON does not allow a comma after the last item in an object or array. This is valid JavaScript but invalid JSON:
2. Single quotes instead of double quotes
All strings in JSON must use double quotes. Single quotes are not valid:
3. Unquoted keys
Object keys must always be strings wrapped in double quotes:
4. Comments
JSON does not support comments. Both // single line and /* block */ comments will cause a parse error.
Pretty Print vs Minified JSON
JSON can be formatted in two ways. Pretty-printed JSON uses indentation and line breaks to make it human-readable. Minified JSON strips all whitespace to reduce file size — useful for production API responses where bandwidth matters.
When debugging, you always want pretty-printed JSON. When shipping to production, minified is preferred. A good JSON formatter handles both in one click.
How to Format JSON Instantly
You do not need to install anything or write code. The free JSON Formatter lets you:
- Paste any raw or minified JSON into the input
- See it instantly formatted with proper indentation
- Validate it — any syntax errors are highlighted clearly
- Minify it back to a single line if needed
- Copy the result with one click
JSON vs XML — Why JSON Won
Before JSON, XML was the dominant data format for web services. JSON replaced it in most web contexts because it is significantly more compact, easier to read, and maps naturally to data structures in JavaScript and other languages. A JSON payload is typically 30–40% smaller than its XML equivalent.
Format and validate your JSON now
Free, instant, no signup needed.