This document is for an older version of
Calendar. View latest version →
Calendar allows you to group your events into calendars, very similar to popular calendaring apps like Apple Calendar and Google Calendar. Calendars can be customized to have their own fields / field layouts and calendar color.
The calendar area in the control panel displays a list of all existing calendars. You can update or remove existing ones, as well as create new ones here.
Removing calendar(s) will also permanently remove ALL associated events!
Calendars allow you to set the following data for each one:
The name of the calendar that will be visible everywhere.
The name you'll use when referring to the calendar in your templates. Auto-generated from the Name field.
The description of the calendar. Can be accessed in your templates.
The unique color for each calendar. Choose from picker (Calendar also automatically internally generates a lighter and darker version of this color for use in control panel and front end templates)
Enable this to set up automatic routing of URL's for your events. Enabling this will also allow you to use the Live Preview feature.
The templates will look for
- Event URI Format - what the event URLs should look like. You can include tags that output event properties, such as
- Template - the template to use when an event's URL is requested.
Show the Title field
Uncheck this to set your own title format, auto-generated from other field(s).
- Title Format - What the auto-generated event titles should look like. You can include tags that output entry properties, such as
ProAllow Repeating Events
Disable this option to allow only single occurrence events for this calendar.
ProForced ICS Event Timezone
Choose a timezone that will be forced upon exported ICS event dates. Default is Floating Timezone (recommended), which means no timezone.
ICS subscriptions currently do not work correctly for Google Calendar when using Floating Timezone. The issue is that there's a "bug" or at least oddity in the way Google Calendar handles events with floating dates compared to all other calendaring apps. Google does not to conform to iCal standards for this. You can work around this by setting the Forced ICS Event Timezone setting to a real timezone.
ProICS Description field
Set the custom field which is used for event description in ICS exports.
ProICS Location field
Set the custom field which is used for event location in ICS exports.
Design Field Layout
Works just like regular Craft field layouts. Simply create how you want your event publishing experience to be. Layouts are unique per Calendar.
Calendars also include an option to share calendars with a publicly accessible ICS subscription URL (Pro), allowing users to subscribe (one way sync) their calendaring app to your sites' calendar(s). To enable this, click on the Share this calendar button next to the applicable calendar(s) on the list view of calendars. Once enabled, you can then copy the ICS URL and share it with whoever you wish (admins, show it publicly, etc).