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

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

The MIME type text/x-properties labels plain text files that store key-value pairs. This format lets software and systems read configuration settings easily. It is built for simple text storage and modifications.
Files using this type hold various settings or data entries for applications. They use a line-based structure where each key is paired with a value.

The type is used in many file formats. Examples include VCF for vCard contacts, ICS and ICAL for calendar events, and several configuration files like INI, CFG, PROPERTIES, URL, REG, MC, PRO, CNF, PREFS, DOF, GITCONFIG, EDITORCONFIG, and LEKTORPROJECT.

It holds structured configuration data via simple text.
It is used in many applications for settings and verification.
Its simplicity makes it easy to modify and update manually.

For more context about MIME types, see the IANA Media Types registry.

Associated file extensions

.vcf, .ics, .ini, .cfg, .sfv, .properties, .url, .reg, .mc, .pro, .cnf, .prefs, .dof, .ical, .gitconfig, .editorconfig, .lektorproject

Usage Examples

HTTP Header

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


    Content-Type: text/x-properties

HTML

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


    <a href="file.dat" type="text/x-properties">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-properties');    
      res.end('Content here');    
    }).listen(3000);

Associated file extensions

.vcf, .ics, .ini, .cfg, .sfv, .properties, .url, .reg, .mc, .pro, .cnf, .prefs, .dof, .ical, .gitconfig, .editorconfig, .lektorproject

FAQs

What is the text/x-properties MIME type used for?

This MIME type is used to label configuration files that store data in a key=value format. It is most commonly associated with Java .properties files, Windows .ini files, and other generic configuration formats like .cfg or .editorconfig.

How do I open a file with the text/x-properties content type?

Since text/x-properties files are effectively plain text, you can open and edit them with any standard text editor. Popular choices include Notepad on Windows, TextEdit on macOS, or developer tools like VS Code and Sublime Text.

Is text/x-properties a standard MIME type?

No, the x- prefix indicates that it is a non-standard or experimental type not officially registered with IANA. While it is widely understood by applications to mean "configuration text," specific formats often have their own standard types (e.g., text/calendar for .ics files).

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

You can map the file extension to the MIME type in your .htaccess or main configuration file. Add the line: AddType text/x-properties .properties. This ensures the server tells the browser exactly what kind of data is being sent.

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

Browsers often default to downloading files with x- MIME types because they do not have a built-in viewer for them. To force the browser to display the text, you can configure your server to send the header Content-Disposition: inline or serve the file as text/plain instead.

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

Yes, configuration files often contain sensitive information like database passwords, API keys, or internal paths. You should ensure your web server is configured to block public access to sensitive files like .gitconfig or server .cnf files to prevent data leaks.

Should I use text/x-properties for VCF or ICS files?

While .vcf and .ics files technically use a key-value structure, it is better to use their specific MIME types. Use text/vcard for contacts and text/calendar for calendars to ensure they open directly in applications like Outlook or Google Calendar.

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.