# Tom's Obvious Minimal Language (TOML)

> A simple format for settings. Titles sit in brackets, with one setting per line.

**Field:** Software Development  
**Category:** Files & Formats  
**Also known as:** TOML, .toml file

## Think of it like

Think of it like a book with titles. Under each title, each line sets one thing.

## Definition

TOML is a simple text format for config files. It groups settings under headings in square brackets, like [package]. Each line sets one value, like name = "shop". It is stricter than YAML, so there are fewer surprises, and it allows comments. Rust projects use it in Cargo.toml, and Python projects use it in pyproject.toml.

## Example

Emma sets her Python project's name and version in pyproject.toml. Her build tool reads both from there.

## Example code

```toml
[package]
name = "shop"
version = "1.0.0"
```

Two settings under one heading.

## Why it matters

Rust and modern Python tools are set up in TOML. It is clear and hard to get wrong.

## Common mistake

Leaving quotes off text values. In TOML, name = shop is an error; it must be name = "shop".

## Three principles

- **Headings in brackets.** Sections group the settings.
- **One value per line.** Each line says key = value.
- **Strict but clear.** Fewer surprises than YAML.

## Related terms

- [YAML Ain't Markup Language (YAML)](https://learn.benibix.com/term/development/yaml)
- [Configuration File](https://learn.benibix.com/term/development/config-file)
- [JavaScript Object Notation (JSON)](https://learn.benibix.com/term/development/json)
- [Rust](https://learn.benibix.com/term/development/rust)

## Taught in

- [Config Files, YAML and TOML](https://learn.benibix.com/learn/development-formats/config-files-yaml-and-toml): File Formats, 5/11

---

Source: https://learn.benibix.com/term/development/toml
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-18
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
