ToolzYard Blog

Developer guides and tutorials

JSON to CSV Guide

How to Convert JSON to CSV for Excel and Google Sheets

Published: March 9, 2026 • Updated: March 17, 2026 • By ToolzYard

JSON is excellent for APIs, applications, and structured data exchange. CSV is better for spreadsheets, reports, imports, and sharing tabular data with non-technical users. If you need to open API results in Excel, import records into Google Sheets, or export structured data into rows and columns, converting JSON to CSV is usually the fastest solution.

This guide explains how JSON to CSV conversion works, what kind of JSON converts best, how to handle nested objects, and what common issues to watch for. Whether you are working with API responses, exported application data, or test records, understanding this conversion can save time and prevent messy spreadsheet output.

Why convert JSON to CSV?

JSON is designed for structured machine-readable data, but many people ultimately need the data in a spreadsheet. CSV is simple, widely supported, and easy to open in Excel, Google Sheets, and other data tools.

What kind of JSON works best for CSV conversion?

JSON arrays of objects work best when converting to CSV. In that structure, each object becomes a row and each property becomes a column. This is the cleanest and most predictable form for spreadsheet output.

[
  {"name":"John","age":30,"city":"New York"},
  {"name":"Sara","age":25,"city":"London"}
]

That JSON usually becomes CSV like this:

name,age,city
John,30,New York
Sara,25,London

This structure is ideal because it maps naturally to columns and rows. If your JSON looks like a single object or contains deep nesting, it may need cleanup before conversion produces a useful CSV.

How JSON becomes CSV

JSON uses objects and arrays, while CSV uses rows and columns. To convert JSON to CSV, the converter typically looks at the object keys and uses them as column headers. Then it reads each object in the array as one row of values.

For example:

[
  {"product":"Laptop","price":999,"stock":12},
  {"product":"Mouse","price":25,"stock":100}
]

becomes:

product,price,stock
Laptop,999,12
Mouse,25,100

This is why arrays of similar objects convert so well. The keys are consistent across records and map neatly into a spreadsheet structure.

How to convert JSON to CSV

Step 1: Make sure your JSON is valid

Before converting anything, confirm that the JSON is valid. Broken quotes, missing commas, or bad brackets will break the conversion process. If needed, format or validate your JSON first.

Step 2: Prefer an array of objects

JSON arrays of objects usually convert best to CSV. If your data is not already in that format, you may need to extract or flatten it first.

Step 3: Paste it into the converter

Use ToolzYard’s JSON to CSV tool to transform the data into spreadsheet-ready CSV output.

Step 4: Review the output columns

Check whether all expected fields became columns and whether rows are aligned properly. If the JSON had inconsistent keys, some columns may be empty in certain rows.

Step 5: Copy or download the CSV

After conversion, paste the CSV into Excel, import it into Google Sheets, or save it for reporting, export, and analysis workflows.

Using JSON to CSV for Excel

CSV is one of the easiest formats for Excel. Once your JSON is converted, you can open the CSV directly in Excel or import it using Excel’s data tools. This is useful for reporting, sorting, filtering, charts, and manual review.

Common use cases include:

Using JSON to CSV for Google Sheets

Google Sheets also works very well with CSV. Once the JSON is converted, you can import the CSV file or paste the values directly into a sheet. This is especially useful when collaborating with teams or building lightweight dashboards and reports.

Common problems when converting JSON to CSV

1. Nested objects

Nested JSON does not always fit neatly into CSV because CSV is flat. If an object contains another object, you may need to flatten it first.

{
  "user": {
    "name": "John",
    "city": "New York"
  }
}

A flattened version might become:

{
  "user.name": "John",
  "user.city": "New York"
}

2. Arrays inside objects

Arrays can also create problems because one spreadsheet cell cannot naturally represent a full list in a structured way. Some converters place the full array into one cell, while others require preprocessing.

3. Inconsistent keys

If objects in your JSON array do not share the same keys, the CSV may end up with uneven columns or blank cells.

[
  {"name":"John","age":30},
  {"name":"Sara","city":"London"}
]

This may create columns for both age and city, with empty cells where data is missing.

4. Invalid JSON

If the input JSON is malformed, conversion will fail. Validation is often the first thing to check when output is missing or broken.

What to do with nested JSON

If your JSON comes from an API, it may contain nested objects or arrays. In those cases, flattening the structure before conversion usually gives much cleaner spreadsheet output. Flattening turns deeply nested fields into simple keys that can become CSV columns.

This is especially useful for:

Best practices for clean JSON to CSV output

Useful ToolzYard tools

Conclusion

JSON to CSV conversion is one of the most useful ways to turn structured application data into something spreadsheet tools can handle easily. Arrays of objects convert cleanly, while nested or inconsistent structures may need flattening or cleanup first.

If you regularly work with APIs, exports, reports, or spreadsheet analysis, understanding how JSON maps into CSV will help you create cleaner files, avoid broken columns, and make the data easier to share and analyze in Excel or Google Sheets.

Frequently Asked Questions

Can nested JSON be converted to CSV?

Yes, but flattening the JSON first usually makes the CSV output much cleaner and easier to use.

Can I use the CSV in Excel?

Yes. CSV is one of the most common formats for Excel and is easy to open, import, sort, and filter.

Can I use JSON to CSV for Google Sheets?

Yes. After conversion, you can import the CSV file into Google Sheets or paste the values directly.

Does every JSON structure convert cleanly to CSV?

No. Arrays of objects work best. Deeply nested, inconsistent, or complex structures may need cleanup before conversion.

Why are some CSV columns blank after conversion?

Blank columns usually happen when records in the JSON array do not all contain the same keys.