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

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

text/x-vcalendar is a MIME type that marks files in the vCalendar format.

This format holds calendar data in plain text. It stores events, meetings, and appointment details. Data can be easily read and exchanged between programs.

Main use case: Sharing scheduling information between calendar applications.
Other uses: Importing and exporting events for personal information management.
Functionality: Supports simple appointment details and recurring events.

Files using this format normally have the extension VCS.

For more technical details, check resources like MDN Web Docs.

Associated file extensions

.vcs

Usage Examples

HTTP Header

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


    Content-Type: text/x-vcalendar

HTML

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


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

Associated file extensions

.vcs

FAQs

What is the difference between text/x-vcalendar and text/calendar?

text/x-vcalendar is used for the older vCalendar 1.0 format (associated with .vcs files), whereas text/calendar is the standard MIME type for the newer iCalendar 2.0 format (associated with .ics files). While many modern applications like Microsoft Outlook and Apple Calendar support both, text/calendar is the preferred standard for modern web usage.

How do I configure Apache to serve .vcs files?

To ensure your Apache server sends the correct header for vCalendar files, add the following line to your .htaccess file or server configuration: AddType text/x-vcalendar .vcs. This ensures browsers and email clients recognize the file as calendar data.

How do I configure Nginx for text/x-vcalendar?

In your Nginx configuration file (usually nginx.conf or inside sites-available), locate the types block and add the entry: text/x-vcalendar vcs;. Reload the server to apply the changes.

Which applications can open text/x-vcalendar files?

Files with the text/x-vcalendar MIME type can typically be opened by Microsoft Outlook, Apple Calendar, Google Calendar, and Lotus Notes. Since the format is plain text, you can also view the raw data using any text editor like Notepad or VS Code.

Why is the MIME type prefixed with 'x-'?

The x- prefix indicates that text/x-vcalendar was originally defined as a non-standard or experimental type before the IETF standardized calendar data exchange. The modern, standardized successor dropped the prefix and is known simply as text/calendar.

Why are special characters displaying incorrectly in a .vcs file?

Legacy vCalendar files often use quoted-printable encoding or specific character sets like ISO-8859-1 rather than UTF-8. If characters appear garbled, ensure your Content-Type header specifies the charset, for example: Content-Type: text/x-vcalendar; charset=ISO-8859-1.

Can I use text/x-vcalendar for email invites?

Yes, but it is less reliable than the modern standard. While older email clients rely on text/x-vcalendar, most modern systems (Gmail, Office 365) prefer the text/calendar MIME type. For maximum compatibility, convert .vcs data to the iCalendar (.ics) format.

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.