What is MIME type "text/x-toml"?

A MIME type is a string that tells browsers and other tools how to handle a particular kind of file.

text/x-toml is the MIME type for files written in the TOML format.
It signals that the file is plain text with a structured configuration style that is simple and easy to read.
The format organizes settings as key/value pairs and supports nested data in a clear hierarchy.

Application configuration: Many programs use it to store settings.
Development projects: It manages project and build tool configurations.
Readable data files: Users can manually edit the file.

Files using this MIME type include TOML files.
For more details, check out additional resources like Wikipedia.

Associated file extensions

.toml

Usage Examples

HTTP Header

When serving content with this MIME type, set the Content-Type header:


    Content-Type: text/x-toml

HTML

In HTML, you can specify the MIME type in various elements:


    <a href="file.dat" type="text/x-toml">Download file</a>

Server-side (Node.js)

Setting the Content-Type header in Node.js:


    const http = require('http');    
    
    http.createServer((req, res) => {    
      res.setHeader('Content-Type', 'text/x-toml');    
      res.end('Content here');    
    }).listen(3000);

Associated file extensions

.toml

FAQs

What is the purpose of the text/x-toml MIME type?

The text/x-toml MIME type is used to identify configuration files written in TOML (Tom's Obvious, Minimal Language). It tells web servers and browsers that the content is a structured, human-readable text file often used for application settings, such as Cargo.toml in Rust or pyproject.toml in Python projects.

How do I configure Apache to serve .toml files correctly?

To serve files with the /file-extension/toml extension using the correct MIME type in Apache, add the following line to your .htaccess file or main configuration: AddType text/x-toml .toml. This ensures browsers and clients interpret the file as a TOML configuration rather than generic text.

How do I add text/x-toml support to Nginx?

In Nginx, you can add the MIME type mapping in your mime.types file or inside a server block. Add the line text/x-toml toml; to ensure that any file ending in .toml is served with the correct Content-Type header.

Is text/x-toml the official IANA MIME type for TOML?

No, the x- prefix indicates that it is a non-standard or experimental type. While there is no officially registered IANA media type for TOML yet, text/x-toml is the most widely used convention. Some systems may also recognize application/toml, but the text-based variant is generally preferred for readability.

How can I view or edit a file sent as text/x-toml?

Since TOML is a plain text format, you can open these files with any standard text editor, such as Notepad, VS Code, or Sublime Text. If a browser downloads the file instead of displaying it, you can simply open the downloaded file in your editor to view the configuration keys and values.

Why does my browser download the TOML file instead of displaying it?

Most web browsers do not have a built-in viewer for the text/x-toml format, so they often default to downloading the file. To force the browser to attempt to display it as text, the server can send a Content-Disposition: inline header alongside the MIME type.

Are there security risks associated with text/x-toml files?

Generally, text/x-toml files are safe because they are plain text and do not execute code. However, you should be careful not to expose sensitive server configuration files (like database passwords or API keys) publicly. Ensure your web server is configured to block access to sensitive .toml files if they are not meant for public consumption.

General FAQ

What is a MIME type?

A MIME (Multipurpose Internet Mail Extensions) type is a standard that indicates the nature and format of a document, file, or assortment of bytes. MIME types are defined and standardized in IETF's RFC 6838.

MIME types are important because they help browsers and servers understand how to process a file. When a browser receives a file from a server, it uses the MIME type to determine how to display or handle the content, whether it's an image to display, a PDF to open in a viewer, or a video to play.

MIME types consist of a type and a subtype, separated by a slash (e.g., text/html, image/jpeg, application/pdf). Some MIME types also include optional parameters.

How do I find the MIME type for a file?

You can check the file extension or use a file identification tool such as file --mime-type on the command line. Many programming languages also provide libraries to detect MIME types.

Why are multiple MIME types listed for one extension?

Different applications and historical conventions may use alternative MIME identifiers for the same kind of file. Showing them all helps ensure compatibility across systems.