This is the official manual for the latest Org-mode release.
A large part of Org mode's inter-operability success is its ability to easily export to or import from external applications. The iCalendar export back-end takes calendar data from Org files and exports to the standard iCalendar format.
The iCalendar export back-end can also incorporate TODO entries based on the
configuration of the
org-icalendar-include-todo variable. The
back-end exports plain timestamps as VEVENT, TODO items as VTODO, and also
create events from deadlines that are in non-TODO items. The back-end uses
the deadlines and scheduling dates in Org TODO items for setting the start
and due dates for the iCalendar TODO entry. Consult the
variables for more details.
For tags on the headline, the iCalendar export back-end makes them into
iCalendar categories. To tweak the inheritance of tags and TODO states,
configure the variable
org-icalendar-categories. To assign clock
alarms based on time, configure the
The iCalendar format standard requires globally unique identifier—UID—for
each entry. The iCalendar export back-end creates UIDs during export. To
save a copy of the UID in the Org file set the variable
org-icalendar-store-UID. The back-end looks for the
property of the entry for re-using the same UID for subsequent exports.
Since a single Org entry can result in multiple iCalendar entries—as timestamp, deadline, scheduled item, or TODO item—Org adds prefixes to the UID, depending on which part of the Org entry triggered the creation of the iCalendar entry. Prefixing ensures UIDs remains unique, yet enable synchronization programs trace the connections.
org-agenda-filesand store in a separate iCalendar file for each Org file.
org-agenda-filesand write it to
The iCalendar export back-end includes SUMMARY, DESCRIPTION and LOCATION
properties from the Org entries when exporting. To force the back-end to
inherit the LOCATION property, configure the
When Org entries do not have SUMMARY, DESCRIPTION and LOCATION properties,
the iCalendar export back-end derives the summary from the headline, and
derives the description from the body of the Org item. The
org-icalendar-include-body variable limits the maximum number of
characters of the content are turned into its description.
Exporting to iCalendar format depends in large part on the capabilities of the destination application. Some are more lenient than others. Consult the Org mode FAQ for advice on specific applications.