How to use the JSON to TOML Converter
- Paste a JSON object — the top level must be an object.
- The TOML appears as you type; invalid JSON is reported with the position.
- Copy or download the TOML file.
How JSON maps to TOML
Simple values become key = value lines. Nested objects become tables — {"server": {"port": 8080}} turns into [server] followed by port = 8080. Arrays of objects become arrays of tables written with double brackets, [[servers]], one block per item. Arrays of plain values stay inline: tags = ["a", "b"].
What can’t be converted
TOML has no null, so null values are left out. A TOML document is always a table, so the JSON must be an object at the top level — wrap a top-level array in an object first. Dates in ISO 8601 strings stay strings; write them as TOML dates by hand if your tool expects a date type.
Private by design
The conversion runs in your browser; nothing is uploaded.
Tools that pair well with the JSON to TOML Converter
- TOML Converter — Convert TOML config files — Cargo.toml, pyproject.toml, Hugo or Netlify configs — to JSON or YAML, or turn JSON and YAML into TOML.
- JSON to YAML — Paste JSON and get clean YAML for Kubernetes manifests, Docker Compose, GitHub Actions or any config file.
- YAML to JSON — Paste YAML — a Compose file, Kubernetes manifest or CI config — and get formatted JSON.
- JSON Validator — Paste JSON to check whether it is valid.
Frequently asked questions
Why is my top-level JSON array rejected?
TOML documents are tables (objects). Wrap the array, for example {"items": [...]}, and it becomes an array of tables named items.
What happens to null values?
They are skipped, because TOML has no null type. Remove the key or give it a default value.
Can I convert TOML back to JSON?
Yes — choose TOML → JSON in the same tool.
Can I install JSON to TOML Converter as a web app and use it offline?
Yes. JSON to TOML Converter is an installable web app (PWA) — installed from your browser, not downloaded from an app store. Click Install app at the top of this page in Chrome or Edge (Windows, macOS, Linux, ChromeOS) or on Android, use Share → Add to Home Screen on iPhone and iPad, or File → Add to Dock in Safari 17+ on a Mac. It then opens in its own window with its own icon, and because it runs entirely in your browser it keeps working offline. Firefox on desktop can’t install web apps. How installing works.