An ICS file is an iCalendar text file that stores events and tasks. RFC 5545 defines the format with the text/calendar media type. Every file starts with BEGIN:VCALENDAR and requires PRODID and VERSION. Events need UID and DTSTAMP and normally DTSTART.
You receive a meeting invite as an attachment named invite.ics and wonder what is inside. Inside is plain text with a strict structure.
Every fact follows RFC 5545, the iCalendar specification.
What is an ICS File?
RFC 5545 describes iCalendar as a data format for exchanging events and to-dos and journal entries and free or busy information. Format rules do not depend on any calendar service or protocol. Media type is text/calendar and the file extension is .ics.
What does an ICS File Contain?
Every iCalendar object starts with BEGIN:VCALENDAR and ends with END:VCALENDAR. Inside sit calendar properties and one or more components.
| Component | Purpose |
|---|---|
| VEVENT | Calendar event |
| VTODO | To-do item |
| VJOURNAL | Journal entry |
| VFREEBUSY | Free or busy time |
| VTIMEZONE | Time zone definition |
| VALARM | Reminder alarm |
BEGIN:VCALENDAR
VERSION:2.0
PRODID:-//Example Corp//Example Calendar//EN
BEGIN:VEVENT
UID:19970901T130000Z-123401@example.com
DTSTAMP:19970901T130000Z
DTSTART:19970903T163000Z
SUMMARY:Annual Employee Review
END:VEVENT
END:VCALENDAR
Which Rules does the Format Set?
- Required calendar properties. PRODID and VERSION where the version is 2.0.
- Required event properties. UID and DTSTAMP. DTSTART is normally needed too.
- Line endings. Content lines end with CRLF.
- Line folding. Lines longer than 75 octets should be split with a CRLF followed by a space or tab.
- Character set. UTF-8 by default.
- Date and time forms. Floating local time or UTC ending in Z or local time with a TZID reference.
Property and parameter names are case insensitive. Applications must ignore experimental X- names that they do not recognize.
Plain text means you can inspect an ICS file in any text editor. Edit a copy and not the original. For calendar protection see cloud data protection controls.
Frequently Asked Questions
What is an ICS File?
It is an iCalendar file that stores events and tasks as plain text.
Which Standard Defines ICS?
RFC 5545 defines the iCalendar format.
What is the Media Type of ICS?
It is text/calendar.
Which Properties are Required in an Event?
UID and DTSTAMP are required and DTSTART is normally needed.
Can I Open an ICS File in a Text Editor?
Yes. Plain text files with UTF-8 as the default character set.
Key Takeaways
- ICS files store events and tasks as plain text.
- RFC 5545 defines the iCalendar format.
- Files start with BEGIN:VCALENDAR and end with END:VCALENDAR.
- Events need UID and DTSTAMP.
- Edit a copy and not the original file.
Sources and References
Facts follow the RFC.