Skip to content
T
Tools.Town
Free Online Tools for Everyone
Data Tools

How to Use JSON to CSV — Complete Guide

Learn how to convert JSON arrays to spreadsheet-ready CSV using the free JSON to CSV tool on Tools.Town — flatten nested objects, pick columns, download instantly.

7 May 2026 4 min read By Tools.Town Team Fact Checked

Key Takeaways

  • Arrays of objects (the most common API response format)
  • Nested objects are flattened with dot-separated keys
  • Yes
  • Comma by default

What is JSON to CSV?

JSON to CSV takes a JSON array of objects and converts it to a CSV file with each object as a row and each key as a column header. Nested objects can be flattened and you can pick exactly which columns to include.

Your JSON data is processed entirely in the browser. Nothing is uploaded to any server.


Handling Nested Data

Flat Objects

Direct key-value pairs become columns directly — no special handling needed.

Nested Objects

Toggle flattening to expand nested objects into columns with dot notation: address.city, address.zip.

Array Values

Arrays inside objects can be serialized as JSON strings in the cell, or each item output as separate rows.


How to Use JSON to CSV

Paste JSON

Paste your JSON array into the input. Syntax errors are highlighted immediately.

Set options

Toggle nested object flattening and select your preferred CSV delimiter.

Pick columns

Deselect any columns you don't want in the output using the column picker.

Download or copy

Click Download to save the .csv file, or Copy to grab the CSV text.


Example Conversion

Input JSON:

[
  { "name": "Alice", "age": 28, "address": { "city": "Mumbai" } },
  { "name": "Bob",   "age": 34, "address": { "city": "Delhi" } }
]

Output CSV (with flattening):

name,age,address.city
Alice,28,Mumbai
Bob,34,Delhi

Tips & Common Mistakes

Excel in some regions uses semicolons. If you open the CSV in Excel and see all data in one column, switch the delimiter to semicolon — common in German, French, and other European locales.

Inconsistent keys across objects cause empty cells. If some objects have more keys than others, missing values become empty cells in the output. This is expected CSV behavior.


Advertisement

Try JSON to CSV Converter — Free

Apply what you just learned with our free tool. No sign-up required.

Try JSON to CSV Converter

Frequently Asked Questions

What JSON structures can it convert?
Arrays of objects (the most common API response format). A single object can be converted as a single-row CSV. Deeply nested objects can be flattened using dot notation.
What is dot-notation flattening?
Nested objects are flattened with dot-separated keys. { 'address': { 'city': 'Mumbai' } } becomes a column named 'address.city'.
Can I choose which columns to include?
Yes. After parsing, a column picker lets you deselect any fields you don't want in the output.
What delimiter does the CSV output use?
Comma by default. Switch to semicolon or tab for compatibility with regional Excel settings (Europe commonly uses semicolons).

Was this guide helpful?

Your feedback helps us improve our content.

Continue Reading

All Data Tools Guides

Get the best Data Tools tips & guides in your inbox

Join 25,000+ users who get our weekly data tools insights.