What is TOML and where is it used?

TOML stands for Tom's Obvious Minimal Language, a config format built to be easy for humans to read and to map cleanly onto a hash table. You meet it in Rust's Cargo.toml, Python's pyproject.toml, Hugo and Netlify site config, and many CLI tools. A line looks like name = "toolora", a section header looks like [database], and a repeated section looks like [[servers]]. If you already have the same data as JSON, this converter gives you the TOML form without retyping.

How does a nested JSON object become a TOML table?

Each nested object turns into a TOML table headed by its dotted key path. The JSON {"owner": {"name": "Li"}} becomes a [owner] header followed by name = "Li". Going deeper, {"a": {"b": {"c": 1}}} emits [a] then [a.b] then c = 1. Scalar values at a given level are written first, then the sub-tables, which keeps the output valid because a table header ends the previous table's body.

How are arrays of objects converted?

A JSON array whose elements are all objects becomes an array of tables, written with double brackets. The input {"servers": [{"host": "a"}, {"host": "b"}]} produces two blocks: one [[servers]] with host = "a" and a second [[servers]] with host = "b". A plain list of numbers or strings stays inline instead, for example ports = [8001, 8002, 8003], because inline arrays read better for short flat data.

What is the difference between JSON and TOML?

JSON is great for machine-to-machine data and supports null, but its braces and commas get noisy for hand-edited config. TOML drops the punctuation, adds first-class dates, and uses [section] headers so a config file reads top to bottom. The trade-off: TOML has no null and is awkward for deeply irregular trees. This tool targets the common case of turning API-shaped JSON config into a file a person will edit.

How does the converter handle null values?

TOML has no null literal, so writing key = null would produce a file no parser accepts. Instead this tool drops any key whose JSON value is null. The input {"a": 1, "b": null, "c": 2} converts to a = 1 and c = 2 with b omitted entirely. If you need to preserve the fact that a key was present, replace null with an empty string "" or a sentinel like "none" in your JSON before converting.

Seed a Cargo.toml or pyproject.toml from JSON

You have project metadata sitting in a JSON file or an API response, and you need it as a Cargo.toml or pyproject.toml. Paste the JSON, copy the TOML, and drop it into your config. Nested objects land as [package] and [dependencies] tables, version pins come out as key = value, and you skip the error-prone retyping that usually introduces a stray comma or a missing quote.

Convert a config exported from a UI or admin panel

Many dashboards let you export settings as JSON but the runtime reads TOML. Rather than maintaining two formats by hand, run the JSON export through this tool whenever settings change. Arrays of service objects become [[services]] blocks and flat option lists stay inline, so the generated file looks like one a human wrote, not a machine dump.

Build TOML fixtures for tests

Writing tests for a tool that parses TOML? Author the expected data as JSON, where you already have editor support and validation, then convert it to a TOML fixture. You get a deterministic mapping for tables, arrays of tables and inline arrays, which keeps your fixtures consistent instead of hand-formatted differently each time.

Learn TOML syntax by example

If you know JSON but TOML headers and double-bracket arrays still look cryptic, paste a JSON shape you understand and read the TOML it produces side by side. Seeing {"a": {"b": 1}} become [a] then b = 1 makes the table model click faster than reading the spec, and the shareable link lets you save examples to revisit.

JSON to TOML Converter Online

Paste JSON, get clean TOML with proper tables and arrays of tables, all in your browser

Runs locally
Category Format Converter
Best for Turning pasted content or local files into a handoff-friendly format.

JSON input

TOML output

What this tool does

Free online JSON to TOML converter for developers who live in Cargo.toml, pyproject.toml, Hugo and Netlify config files. Paste any valid JSON and this tool serializes it to readable TOML: scalar values become key = value pairs, nested objects turn into [table] headers with dotted paths like [a.b.c], arrays of objects become [[array.of.tables]] blocks, and simple lists render as inline arrays such as [1, 2, 3]. Strings are double-quoted and escaped correctly, special key names get quoted, and ISO date strings are left bare so a TOML parser reads them as dates. Because TOML has no null, null-valued keys are dropped rather than written as broken syntax. Everything runs as plain JavaScript in your browser tab with one-click copy and a shareable link that reproduces your exact input. No upload, no account, no server round trip.

Tool details

Input: Text + Structured content; The page exposes text boxes, numeric controls, file pickers, or structured inputs depending on the tool.
Output: Live result + Copy + Download; The result area focuses on usable output, with copy, download, or preview actions when supported.
Privacy: Browser-side processing; The main tool logic does not call an external API, so inputs normally stay in the current tab.
Save / share: Shareable URL state; Key settings are encoded in the URL so another person can reopen the same setup.
Performance budget: Initial JS <= 10 KB; No WASM budget is declared, keeping the tool quick to open on mobile.
Best fit: Format Converter · Developer; Category and role tags drive related tools, internal links, and quick fit checks.

How to use

1. Input

Paste or drop your content into the tool panel.
2. Process

Click the button. All processing is local in your browser.
3. Copy / Download

Copy the result or download to disk in one click.

How JSON to TOML Converter fits into your work

Use it when the main problem is getting content from one practical format into another.

Conversion jobs

Turning pasted content or local files into a handoff-friendly format.
Previewing a conversion before you use it in a larger workflow.
Cleaning small format mismatches without opening a full editor.

Conversion checks

Try a small sample first when the source format is messy.
Check character encoding, separators, and line endings after conversion.
Keep the source until the converted output has been reviewed.

Good next steps

These links move the current task into a more complete workflow.

Real-world use cases

Seed a Cargo.toml or pyproject.toml from JSON
You have project metadata sitting in a JSON file or an API response, and you need it as a Cargo.toml or pyproject.toml. Paste the JSON, copy the TOML, and drop it into your config. Nested objects land as [package] and [dependencies] tables, version pins come out as key = value, and you skip the error-prone retyping that usually introduces a stray comma or a missing quote.
Convert a config exported from a UI or admin panel
Many dashboards let you export settings as JSON but the runtime reads TOML. Rather than maintaining two formats by hand, run the JSON export through this tool whenever settings change. Arrays of service objects become [[services]] blocks and flat option lists stay inline, so the generated file looks like one a human wrote, not a machine dump.
Build TOML fixtures for tests
Writing tests for a tool that parses TOML? Author the expected data as JSON, where you already have editor support and validation, then convert it to a TOML fixture. You get a deterministic mapping for tables, arrays of tables and inline arrays, which keeps your fixtures consistent instead of hand-formatted differently each time.
Learn TOML syntax by example
If you know JSON but TOML headers and double-bracket arrays still look cryptic, paste a JSON shape you understand and read the TOML it produces side by side. Seeing {"a": {"b": 1}} become [a] then b = 1 makes the table model click faster than reading the spec, and the shareable link lets you save examples to revisit.

Common pitfalls

Expecting null to survive. TOML has no null, so a null-valued key is dropped, not written as key = null. If you need the key kept, swap null for an empty string or a placeholder before converting.
Feeding a JS object literal instead of strict JSON. Single quotes, trailing commas and unquoted keys are not valid JSON and the parser rejects them. Run the source through a JSON formatter first if you are unsure.
Assuming a top-level array maps one to one. TOML documents need a table at the root, so a bare JSON array is wrapped under an items key. Restructure your JSON as an object if you want a specific top-level table name.

Privacy

The whole conversion is plain JavaScript running in your browser tab. Your JSON, the parsed data and the TOML output never leave the page and nothing is logged. The one caveat: the shareable link encodes your input in the URL query string, so a link pasted into chat will record that input in the recipient server's access log. For secrets or private config, use the copy button and paste the text instead of sharing the URL.

FAQ

Tool combos

Folks in your role tend to reach for these alongside this tool.

Developer

Browse all tools for this role

JSON to TOML Converter Online

What this tool does

Tool details

How to use

1. Input

2. Process

3. Copy / Download

How JSON to TOML Converter fits into your work

Conversion jobs

Conversion checks

Good next steps

Real-world use cases

Seed a Cargo.toml or pyproject.toml from JSON

Convert a config exported from a UI or admin panel

Build TOML fixtures for tests

Learn TOML syntax by example

Common pitfalls

Privacy

FAQ

JSON Formatter & Validator

YAML ⇄ JSON Converter

JSON to YAML Converter

JSON to CSV Converter

Angle Converter

Base64 Encoder & Decoder

Base64 to File Converter

BBCode to HTML Converter

Chinese Numeric Converter

Chinese Pinyin Converter

Chinese Zodiac Sign Checker (Sheng Xiao)

Cooking Measurement Converter