Skip to content

JSON to CSV

Convert JSON arrays to CSV format online. Free JSON to CSV converter for exporting data to spreadsheets with proper formatting.

CSV to JSON
CSV output will appear here...

About JSON to CSV Conversion

Convert JSON arrays to CSV (Comma-Separated Values) format. Each object in the array becomes a row, with object keys as column headers. Nested objects are serialized as JSON strings.

How to Use JSON to CSV

1

Paste your JSON

Paste a JSON array of objects into the input editor. Each object should have similar keys; rows are derived from object values, columns from object keys.

2

Configure output

Choose delimiter (comma for standard CSV, tab for TSV, semicolon for European CSV). Decide whether to flatten nested objects (user.name) or fail on nesting.

3

Verify the headers

Headers come from the union of all object keys across the array. Missing fields become empty cells. Inspect the first row to confirm column order matches your expectations.

4

Download or copy

Click Download to save as .csv (opens in Excel/Google Sheets) or Copy for clipboard. The output is RFC 4180 compliant — quotes around values containing commas, escaped internal quotes.

When to Use JSON to CSV

Generating Excel-friendly reports from APIs

When non-technical users need to analyze API data, deliver it as CSV that opens directly in Excel. Common scenarios: customer lists from CRM, transaction reports from billing, user analytics from product platforms — all typically JSON via API but consumed via spreadsheet.

Data exports for business intelligence

BI tools like Tableau, PowerBI, and Looker prefer CSV (or its big-data cousin Parquet) for ingestion. Converting JSON exports to CSV creates a standard pipeline: JSON → CSV → BI tool, regardless of source data structure. Especially useful for ad-hoc analyses.

Bulk operations in CRM/marketing tools

Tools like Salesforce, HubSpot, and Mailchimp accept CSV uploads for bulk record creation/updates. When your data is in JSON (from another system), converting to CSV bridges to these platforms without writing custom integrations.

Backup and archival in human-readable form

JSON is great for code, but CSV is the universal format that's readable in 50 years (Excel will still open it). For long-term archival of structured data, CSV with proper headers is more durable than JSON which depends on having compatible parsers.

JSON to CSV Examples

Array of flat objects

Input
[{"name":"Alice","age":30},{"name":"Bob","age":25}]
Output
name,age
Alice,30
Bob,25

Each object becomes a row; keys become headers. Output opens in Excel with two columns and two data rows. Most common JSON-to-CSV conversion pattern — flat objects with consistent keys.

Objects with different keys

Input
[{"name":"Alice","email":"a@x.com"},{"name":"Bob","phone":"555-1234"}]
Output
name,email,phone
Alice,a@x.com,
Bob,,555-1234

Headers union all keys across all objects. Missing fields become empty cells. Excel and downstream tools handle this gracefully — empty cells are simply blank when displayed.

Values containing commas

Input
[{"name":"Alice","note":"VIP, premium tier"}]
Output
name,note
Alice,"VIP, premium tier"

Values containing the delimiter are wrapped in double quotes. Internal quotes would be escaped by doubling (""). The output is RFC 4180 compliant — opens correctly in Excel without splitting the comma-containing value into separate cells.

Tips & Best Practices for JSON to CSV

  • 1.Flatten nested objects before converting. {user: {name: 'Alice'}} doesn't fit the row/column model. Either pre-process to {user_name: 'Alice'} or use a converter option to flatten with dot notation (user.name).
  • 2.Watch for inconsistent object shapes. If 99 objects have keys A, B, C and one object has D, the CSV will have 4 columns with mostly-empty D. Either normalize the JSON first or accept the wider CSV.
  • 3.For Excel internationalization, use the right delimiter. US Excel expects commas; many European versions expect semicolons. Choose based on your audience's Excel version, or distribute as TSV (tab-delimited) which works universally.
  • 4.Add UTF-8 BOM (Byte Order Mark) at the start of CSV when sharing with Excel users — without it, Excel may misinterpret special characters (é, ä, 中) as Latin-1. The byte order mark signals UTF-8 encoding to Excel's CSV importer.
  • 5.For numeric data with leading zeros (zip codes, IDs starting with 0), Excel auto-converts to numbers, dropping the leading zero. Either pre-format as text in the CSV ('="01234"') or instruct users to import as text instead of using auto-detection.
  • 6.Don't include sensitive data in CSV columns visible to anyone receiving the file. Excel's column filtering is no security barrier. For sensitive exports, encrypt the file or use access-controlled platforms instead of CSV email attachments.

Frequently Asked Questions

CSV is the universal format for spreadsheets — Excel, Google Sheets, and Numbers all open CSV directly. Converting API responses, database query results, or any tabular JSON to CSV lets non-developer users analyze data in familiar tools. Also useful for: Excel reports, BigQuery uploads, data lake imports, and Salesforce data loaders.