JSON for Beginners: Syntax, Examples, and First Steps

Who this guide is for

If you have never written JSON by hand, this walkthrough is for you. You will learn the rules that matter, see complete examples, and pick up habits that prevent the most common mistakes. You do not need deep JavaScript knowledge—only curiosity about how modern apps move data.

Your first valid document

Create a file named hello.json and paste:

{
  "greeting": "Hello, world",
  "count": 1
}

That is a complete JSON document: one object with two properties. Save it, then open it in any formatter or validator. If the tool accepts it, you are already writing legal JSON.

Rules you should memorize early

1. Use double quotes for keys and string values.
2. Separate properties with commas, but never leave a trailing comma after the last item.
3. Nest with care — objects inside objects, arrays inside objects, and so on.
4. Numbers are bare — write 10, not "10", unless you truly need a string.
5. Booleans and null are lowercase — true, false, null.

Invalid example (trailing comma):

{
  "ok": true,
}

Valid version:

{
  "ok": true
}

Arrays and nesting

Arrays hold ordered values of any JSON type:

{
  "skills": ["json", "http", "apis"],
  "scores": [9, 8.5, 10],
  "flags": [true, false]
}

Nesting lets you model real entities:

{
  "orderId": "ORD-1001",
  "customer": {
    "name": "Sam Rivera",
    "email": "sam@example.com"
  },
  "items": [
    { "sku": "A1", "qty": 2 },
    { "sku": "B3", "qty": 1 }
  ]
}

Indentation is optional for machines but essential for humans. Pretty-printed JSON with two-space indents is the usual convention in code reviews.

How beginners usually break JSON

• Copying JavaScript objects that use single quotes or unquoted keys
• Adding comments (JSON has no comments in the official standard)
• Mixing tabs and broken quotes after paste from chat apps
• Treating undefined as a value (use null or omit the key)

When something fails, paste the text into a trusted validator. JSON Editor highlights syntax issues and lets you format the document so the structure becomes obvious.

Reading JSON in everyday work

You will meet JSON in browser DevTools Network panels, Postman collections, OpenAPI examples, and error logs. Practice reading from the outside in: identify the root type (object or array), then expand one path at a time. Ask: which keys are required? which values can be null? which lists can be empty?

A simple practice routine

1. Write a profile object with name, age, and hobbies array.
2. Add an address nested object.
3. Minify the file, then pretty-print it again.
4. Intentionally break a quote and fix it with a validator.

Fifteen minutes of deliberate practice beats hours of vague reading. Once syntax feels automatic, move on to APIs, schemas, and path queries—still using the same core vocabulary you learned here.