What Is JSON? A Complete Beginner's Guide

What Is JSON?

JSON (JavaScript Object Notation) is a lightweight, text-based data format used to store and exchange structured information. It was derived from JavaScript object syntax by Douglas Crockford in the early 2000s and was formally specified as RFC 8259 in 2017. Despite its JavaScript origins, JSON is language-independent and is supported natively by virtually every modern programming language.

JSON is widely used for web data exchange; XML remains useful for document-oriented data and established XML systems. It is used by REST APIs, configuration files, databases (such as MongoDB and PostgreSQL's JSONB type), and messaging systems. Its popularity stems from a simple design philosophy: be human-readable, machine-parseable, and as minimal as possible.

A Brief History

Douglas Crockford identified a subset of JavaScript's literal notation that could serve as a standalone data format around 2001. He registered the domain json.org and published the grammar on a single page. The format gained rapid adoption because web developers were already familiar with the syntax from JavaScript. The first JSON RFC, RFC 4627, appeared in 2006. RFC 8259 is the current Internet Standard and permits any JSON value at the top level, including a string, number, boolean, or null.

JSON Syntax Rules

JSON follows a small set of strict rules:

• Data is organized in key-value pairs inside curly braces {} (objects) or as ordered lists inside square brackets [] (arrays).
• Keys must be strings enclosed in double quotes. Single quotes are not allowed.
• Values can be strings, numbers, booleans (true/false), null, objects, or arrays.
• Items in arrays and properties in objects are separated by commas. Trailing commas are not allowed.
• JSON does not support comments.

JSON Data Types

JSON supports exactly six data types:

1. String

A sequence of Unicode characters wrapped in double quotes.

2. Number

An integer or floating-point number. JSON does not distinguish between int and float.

3. Boolean

Either true or false (lowercase, unquoted).

4. Null

Represents an empty or unknown value.

5. Array

An ordered list of values enclosed in square brackets.

6. Object

An unordered collection of key-value pairs enclosed in curly braces.

A Complete JSON Example

Here is a realistic JSON document combining all six data types:

You can paste this into our JSON Formatter to see it pretty-printed with syntax highlighting, or use the JSON Validator to confirm it is valid.

Real-World Use Cases

• REST APIs: Many web APIs exchange JSON, but the response format is part of each API contract. Check the Content-Type and endpoint documentation rather than assuming every response is JSON.
• Configuration files: npm uses standard JSON for package.json. Some configuration formats, including VS Code settings and TypeScript configuration, permit comments or other extensions. Such files may need editing before a strict JSON validator accepts them.
• Databases: MongoDB stores documents in a JSON-like format (BSON). PostgreSQL and MySQL both offer native JSON column types for flexible schemas.
• Data exchange: Microservices communicate using JSON over HTTP or message queues. JSON is also the standard format for webhook payloads.
• Frontend development: JavaScript can parse JSON natively with JSON.parse() and serialize objects with JSON.stringify(), making it ideal for client-server communication.

Try Our Free JSON Tools

Now that you understand JSON, try working with it using our free, browser-based tools:

Want to compare JSON with other data formats? Read our JSON vs XML vs YAML comparison guide.