How to open .TOML files on Windows
To open .TOML files on Windows, right-click the .toml file and choose Open with.
Step-by-step instructions
- Right-click the .toml file and choose Open with.
- Select a text editor (for example, Notepad) or your preferred code editor to view and edit it.
Common issues
Tool reports a TOML parse error
Configuration tools that read TOML (such as Rust Cargo or Python packaging tools reading pyproject.toml) will reject invalid TOML syntax, often stopping builds or packaging steps.
- Validate the structure against the official TOML v1.0.0 specification (pay attention to quoting, commas in arrays, and table headers).
- If the file is Cargo.toml or pyproject.toml, compare your keys/sections to the relevant tool documentation to ensure the expected fields and layout.
Double-clicking doesn’t open in the expected app
Some systems may not have a dedicated association for .toml, or the association may point to an unsuitable application.
- Use “Open with” and choose a plain text editor or code editor.
- On Linux desktops, MIME/association behavior can be influenced by the shared-mime-info database; updating or correcting associations may help, but you can always open TOML as plain text.
Encoding or line-ending problems after moving between systems
A TOML file is text; if it is saved with an unexpected encoding or altered line endings, some tooling may fail to read it correctly.
- Re-save the file as UTF-8 in a plain text editor.
- Avoid editors that silently convert the file into rich text or change formatting in non-obvious ways.
Security note
TOML files are not executable by themselves, but they can influence how developer tools behave (for example, build, packaging, or dependency settings). Review untrusted TOML before using it in your toolchain.