What is a TOML file?

TOML — configuration sans ambiguïté

What is it?

TOML is a configuration format built to deliver what YAML never quite managed: the complete absence of ambiguity. Every value has an explicit type, and there's never more than one way to read the same line.

Its syntax echoes old-school INI files — bracketed sections, keys and values — but backed by a rigorous specification.

History & origin

Tom Preston-Werner, co-founder of GitHub, created TOML in 2013, in direct response to YAML's pitfalls.

It has established itself as the configuration format of choice in several major ecosystems, notably Rust and, more recently, Python.

Why it is useful

No ambiguity, explicit types, excellent readability, and support for comments.

It handles dates natively, which JSON does not.

Limits & drawbacks

Deeply nested structures quickly become unwieldy: this isn't its strong suit.

It's less widespread than YAML or JSON, and its tooling is more limited.

Practical tips

TOML excels as a configuration file format, where clarity matters more than compactness.

For data exchange or complex structures, convert it to JSON.

Convert your TOML in seconds, on our secure servers in France.

Convert a TOML