All Parameters

Accepted Values

Value	Default	Pro	Description
true			Use AJAX to retrieve calendar dynamically after page loads
false	Default		Load calendar directly in page HTML

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

Introduced in version 10.3.0.

This parameter is intended for sites that are using a caching plugin that is interfering with the regular loading of the calendar.

By default, ICS Calendar loads the entire calendar data directly in the page HTML. This may result in a caching plugin treating its content as static, and updates to your calendar will not be reflected on the page. When you use this parameter, a placeholder element is included in the page HTML, and AJAX is used to dynamically replace the placeholder with the calendar.

This is a beta feature. It is not guaranteed to function properly, and its functionality may change in a future update.

Just as with the standard loading method, the entire calendar data is loaded. This is not an interactive AJAX feature. It is our observation that the user experience is more likely to include unacceptable lag on AJAX interactions, whereas our standard approach of loading all of the calendar data up-front, and allowing the interactions to occur entirely on the client side, provides a much snappier user experience.

What is AJAX?

Example Usage

[ics_calendar url="https://example.com/calendar.ics" ajax="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Accepted Values

Value	Default	Pro	Description
true			Returns parsed calendar data array only, rather than display HTML
false	Default		Returns the full display HTML based on the selected view

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

This parameter is intended for use by experienced PHP developers only. It is also used by some features of ICS Calendar Pro currently under development.

When this parameter is present, processing stops as soon as the full calendar data has been parsed, prior to any template rendering. The returned value can then be used in your custom code.

Note: Because this parameter returns a data array rather than echoing any HTML code to the browser, it is useless in the context of a typical shortcode. Instead, you should use the r34ics_get_ics_data() PHP function. (When this function is used, the value of arrayonly is automatically set to true.)

Accepted Values

Value	Default	Pro	Description
true			Include attachments in event description
false	Default		Do not include attachments in event description

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

Use the attach="true" parameter to display attachments with events. Attachments that are browser-friendly images (e.g. JPEG or PNG) will display directly on the page along with the event’s description. Other attachments will display as a clickable download link.

Images shared from Google Drive will be clickable links, rather than displaying inline, due to the structure of Google Drive links and file access permissions.

If a user who does not have permission to access a particular file on your Google Drive clicks the link, you will receive an automated email from Google requesting permission for that user to access the file. For this reason, you may not want to include attachments in your feed if your site is public.

Google does not provide any way around this limitation, nor a way to make event images/attachments directly publicly accessible.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" attach="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Accepted Values

Value	Default	Pro	Description
true			Use HTTP basic authentication
false	Default		Do not use HTTP basic authentication

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

For calendars that use HTTP basic authentication, this provides a way for you to supply a username and password to allow ICS Calendar to retrieve the calendar data.

Basic authentication is inherently not very secure. But to avoid the added risk of storing the credentials in plain text in the database, the shortcode parameter is a simple boolean: basicauth="true". You must define the R34ICS_FEED_BASICAUTH constant in your site’s wp-config.php file.* Its value should be the username and password, separated by a colon, as such:

define('R34ICS_FEED_BASICAUTH', 'username:password');

* We took this approach because that file also contains the WordPress database credentials in plain text, so anyone who has access to this file implicitly has access to everything anyway.

Limitations:

1. This configuration only supports one HTTP basic authentication username/password combination per site. Multiple basic auth-protected calendars can be accessed if they all use the same credentials.
2. If a shortcode contains multiple feeds, the same credentials will be applied to all of the feeds.
3. Public calendars ignore the credentials, so a shortcode can include a combination of basic auth-protected and public calendars, as long as any and all basic auth-protected calendars use the same credentials.
4. Because basic auth uses a colon : as a delimiter, neither the username nor the password can contain a colon. (Since this is an inherent limitation, it should not be an issue for any existing credentials.)
5. This feature currently cannot be used in conjunction with eventdl. If this setting is used, it will force eventdl to false.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" basicauth="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Accepted Values

Value	Default	Pro	Description
#RRGGBB			One or more hex color codes, separated by spaces or the pipe character

Description

You can apply a color to events in your feed by using the color parameter. This is especially helpful if you have multiple feeds and you want to use color coding to distinguish the feeds within your calendar. Add hex color values to this parameter and they will be applied to your feeds in the same order as the feeds are entered in the url parameter. For example, if you have three feeds and you want to color them purple, green and orange, you could use color="#800080 #008000 #ffa500". The base color will be used as a left border on each event, and a lighter tint of that color will be used as the background on the events. Use a tool like the HTML Color Picker to select hex values, if necessary. (Note: the color parameter supports either space- or pipe-delimited lists.)

Example Usage

[ics_calendar url="https://example.com/calendar.ics" color="#800080 #008000 #ffa500"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Accepted Values

Value	Default	Pro	Description
(empty)	Default		Default for view (varies by view)
full			Full day name, e.g. "Monday"
short			Abbreviated day name, e.g. "Mon"
min			Initial for day, e.g. "M"

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

By default the grid’s column labels will be the full names of the days of the week. For tighter layouts you can add columnlabels="short" to use 3-letter abbreviations, or columnlabels="min" to use 1- or 2-letter abbreviations. (The full day names and abbreviations are in the plugin’s translation files for all supported languages.) Applies to month and week views only.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" columnlabels="full"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Applicable Views

month
week
month-with-sidebar

Calendar Builder (Pro) users: This input displays conditionally, based on the View setting(s).

Accepted Values

Value	Default	Pro	Description
true			Visually combine multi-day events
false	Default		Show multi-day events as a series of individual all-day events

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

This is an experimental feature. Your feedback is welcomed. Please see this blog post for more information.

This parameter is not yet supported in Calendar Builder. ICS Calendar Pro users can still take advantage of this feature by adding the necessary parameter directly to their shortcode.

Due to template design limitations, the Month, Week and Month with Sidebar views do not display multi-day events as a block spanning across multiple day cells in the calendar table, but as a series of discrete single-day all-day events.

This parameter uses CSS to modify the appearance of these events to simulate the effect of a multi-day span. It should be useful in most scenarios, although calendars with complicated sequences of overlapping multi-day events may have some display issues.

ICS Calendar Pro users are encouraged to try Full view, which has full support for multi-day events spanning table cells.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" combinemultiday="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Applicable Views

month
week
month-with-sidebar

Accepted Values

Value	Default	Pro	Description
true			Display the calendar in a compact layout
false	Default		Display the calendar in the normal layout
desktop			Compact view on desktop breakpoint only
mobile			Compact view on mobile breakpoint only

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

Set compact="true" to activate a more compact display of whichever view you are currently using. The exact layout changes will vary by view; not all views are affected. It is recommended that you also use toggle="true" on list view for maximum effect.

Note:This is currently an experimental feature, and we are looking for feedback. Presently the changes are that all text is reduced slightly in size, and the list view is collapsed into a new layout with the times left-aligned next to the event titles.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" compact="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Accepted Values

Value	Default	Pro	Description
INTEGER			Number of events to display

Description

Number of events to display, e.g. count="5". Applies in list view only.

Note: This parameter’s default value was changed in ICS Calendar version 10.6. Please see this blog post for more information.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" count="5"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Applicable Views

basic
list

Calendar Builder (Pro) users: This input displays conditionally, based on the View setting(s).

Accepted Values

Value	Default	Pro	Description
cookie			Sets a cookie when making requests
useragent			Sets a user agent string when making requests (DEPRECATED)

Description

This is an experimental parameter, intended for use on sites that are having trouble loading feeds. It is used to facilitate testing additional request headers when retrieving a feed.

The useragent value is deprecated; ICS Calendar now always sends a user agent string when requesting the feed.

It has come to our attention that some services like Cloudflare (providing load balancing, CDNs, and DDOS mitigation services) may reject requests generated by ICS Calendar due to their superficial similarity to malicious requests. If you are using a service like this and are finding that ICS Calendar is unable to retrieve your feeds, please try adding curlopts="cookie" to your shortcode and let us know if it is helpful.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" curlopts="cookie"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Accepted Values

Value	Default	Pro	Description
STRING			Pipe-delimited list of custom options

Description

If you are writing your own custom code to extend the plugin’s functionality, use customoptions to create your own configuration options for the shortcode. The value passed in this attribute is automatically converted into an array using the pipe character | as a delimiter. This attribute will never be used directly within the core ICS Calendar plugin, but may be used in ICS Calendar Pro or in customizations/add-ons to pass additional data into the shortcode for use within filters.

Notes:

• If no pipes are present in the value, it will still be converted into an array with one node.
• The value is converted to a numbered array of values; that is, it does not automatically get converted into an associative array of key/value pairs. You will need to handle the values accordingly in your code.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" customoptions="key1=value1|key2=value2"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Accepted Values

Value	Default	Pro	Description
(empty)	Default		Debug mode off
1			Basic debugging
true			(Same as 1)
2			Extended debugging
3			Full debugging; also turns off ICS Calendar's caching

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

Use debug="true" to turn on the debugger. Extended debugging output is available by setting debug="2". Only Administrator-level users will see debugging code. When turned on, a panel will appear at the bottom of the screen with a raw dump of the ICS data array, and possibly additional debugging information. When debugging you may also want to set reload="true" to reload the feed on each page load.

Basic mode includes the fully parsed event array and general details about the request. It uses cached data if available. Extended mode adds the raw data as handled by the ics-parser library (before being processed by ICS Calendar itself), along with additional details about the server connection. Full mode always requests fresh data from the source server, rather than using the cache, and it also outputs the entire raw contents of the ICS feed itself.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" debug="1"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Accepted Values

Value	Default	Pro	Description
true			Automatically displays the description of the calendar from the source feed (if the calendar only contains one feed)
false	Default		Hides the source calendar's description; does not display any description above the calendar
STRING			Displays the text entered, instead of the source calendar's description

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

Text string to display as a general description of the calendar. Displays above the calendar, just below title. If omitted, the feed’s description will display (if any). Use "false" to display no description.

Note: This parameter’s default value was changed in ICS Calendar version 10.6. Please see this blog post for more information.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" description="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Calendar Builder (Pro) users: This input displays conditionally, based on the Hide Calendar Title and Description; Customize Title and Description setting(s).

Note: This parameter is available in ICS Calendar Pro only.

Description

If Fill Empty Days is on, you can enter a generic description to display on empty days. Event Descriptions must be turned on. HTML is allowed in this field.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" empty_day_description="No events."]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Calendar Builder (Pro) users: This input displays conditionally, based on the Fill Empty Days setting(s).

Note: This parameter is available in ICS Calendar Pro only.

Description

If Fill Empty Days is on, you can enter a generic title to display on empty days.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" empty_day_title="Free"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Calendar Builder (Pro) users: This input displays conditionally, based on the Fill Empty Days setting(s).

Accepted Values

Value	Default	Pro	Description
true	Default		Show event descriptions
false			Do not show event descriptions
INTEGER			Show an excerpt of the description, INTEGER words long

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

Use the eventdesc="true" parameter to display event descriptions. Note: In the month view, descriptions will display on hover; in the list view, descriptions will display in full on the page below the event title (and location/organizer, if shown). In the list view, you can choose to display an excerpt of the description by entering the number of words to show, e.g. eventdesc="12". Hovering over the shortened description will show the full description in a tooltip. Month view always shows the full description.

Note: This parameter’s default value was changed in ICS Calendar version 10.6. Please see this blog post for more information.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" eventdesc="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Note: This parameter is available in ICS Calendar Pro only.

Description

If your event descriptions are long, enter a number of words to display as an excerpt instead. Full description text will appear if the user clicks the excerpt.

This exists as a separate parameter only to facilicate the Calendar Builder interface in ICS Calendar Pro. To set an excerpt length in ICS Calendar (free), enter an integer value for eventdesc as shown below.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" eventdesc="12"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Applicable Views

list
month-with-sidebar
widget
year-with-sidebar

Calendar Builder (Pro) users: This input displays conditionally, based on the Event Descriptions setting(s).

Accepted Values

Value	Default	Pro	Description
true			Add an individual .ics download to each event
false	Default		Do not add individual .ics downloads

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

Add eventdl="true" to your shortcode to add a clickable download link to each event. This will download a customized .ics file containing only the selected event for users to add the event to their personal calendars.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" eventdl="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Accepted Values

Value	Default	Pro	Description
true			Extend multi-day events to include the end date
false	Default		End multi-day events before the end date, per spec

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

Per the iCalendar specification, the DTEND value on all-day events is the first free date in the range, i.e. the date after the event finishes. By default, multi-day all-day events are handled this way. If your feed includes multi-day all-day events that should include the date specified by DTEND, add extendmultiday="true" to your shortcode.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" extendmultiday="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Accepted Values

Value	Default	Pro	Description
STRING			Labels for each feed in the legend, pipe-delimited

Description

By default, each calendar in the color key will be labeled using the title provided in that calendar’s feed. You can override the titles by using feedlabel. Note that because feed labels may need to contain spaces, the values for this parameter are pipe-delimited | rather than space-delimited. You can provide custom labels for some feeds and use the default titles as labels for others. For example, if you had three feeds and wanted to keep the default title for the second one, you could use feedlabel="Calendar Label 1||Calendar Label 3". (Note two pipes together; this is leaving the second delimited value empty.)

Example Usage

[ics_calendar url="https://example.com/calendar.ics" feedlabel="Calendar Label 1|Calendar Label 2"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Note: This parameter is available in ICS Calendar Pro only.

Accepted Values

Value	Default	Pro	Description
true		Pro Only	Adds Empty Day Title and Empty Day Description to days with no events
false	Default	Pro Only	Days with no event are left blank

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

If your calendar is intended to show availability, use this option to add a general “available” message to all dates that do not have any events in your feed. You can set the specific title (and/or description) to be displayed using the Empty Day Title and Empty Day Description fields.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" fill_empty_days="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Accepted Values

Value	Default	Pro	Description
(empty)	Default		No effect
1			Removes multiple events that have the same UID in the source feed
true			(Same as 1)
2			Removes multiple events that start at the same time and have the same SUMMARY, regardless of UID

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

Addresses an issue where an iCloud source feed may include multiple past edits of an event as separate, redundant instances of the event in the calendar. If you are experiencing this issue, add fixredundantuids="1" to your shortcode. Note that this will not remove redundant-looking events if they have different UIDs. (For instance, if you’ve deleted a single instance of a recurring event, and then created a new one-off event at the same date and time, or with the same title… those events will have different UIDs and be treated as separate events.)

Setting fixredundantuids="2" wil remove any duplicates that start at the same time and have the same SUMMARY value, regardless of matching UIDs. (This is intended for handling edge cases where an individual instance of a recurring event has been edited.)

We are still testing this feature and it is subject to change or removal. Your feedback is welcomed.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" fixredundantuids="1"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Description

By default list view will display dates in the U.S. standard day-month-date format (e.g. “Thursday March 14”). Other views use the format in your general WordPress settings under Settings → General → Date Format.

To use a different date format in your ICS Calendar shortcode, use a value in standard PHP date format with the format parameter.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" format="D n/j"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Description

In places where the month and year are displayed without the day number (e.g. headers and month selection dropdown menu in month view), the default format is F Y (e.g. “March 2020”). Use the formatmonthyear parameter with PHP date format strings to customize the display. Note: This option only supports month and year characters (F, m, M, n, Y, y), plus spaces, hyphens, periods and slashes. All other formatting characters will be stripped from the output.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" formatmonthyear="F Y"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Note: This parameter is available in ICS Calendar Pro only.

Accepted Values

Value	Default	Pro	Description
INTEGER		Pro Only	Number of days to show at once in grid view

Description

Use this option to adjust the number of days to display at once in grid view. The default is 5.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" grid_max_days="5"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Applicable Views

grid

Calendar Builder (Pro) users: This input displays conditionally, based on the View setting(s).

Note: This parameter is available in ICS Calendar Pro only.

Accepted Values

Value	Default	Pro	Description
true			Show empty days in grid
false	Default		Show only days with events in grid

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

By default, grid view only shows dates that contain one or more events. Turn on this option to show all dates, regardless of whether or not they contain events.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" grid_show_empty="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Applicable Views

grid

Calendar Builder (Pro) users: This input displays conditionally, based on the View setting(s).

Description

A “GUID” or “globally unique identifier,” can be used to give your calendar’s container element a unique HTML id attribute, making it easy to create an “anchor” link to the calendar within a long page. Must consist of only lowercase letters or numerals. Cannot start with a numeral. Once set, you can use this string as an anchor link or in creating custom CSS specific to this calendar.

The shortcode parameter is guid instead of id to avoid a conflict with the id attribute in the Pro version.

Note: This is not strictly a true “GUID” but the name was chosen for familiarity.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" guid="My Calendar"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Description

By default, all-day events are grouped at the top of each day’s events list, with an “ALL DAY” header. Use hidealldayindicator="true" to remove this header. (The all-day events will still be grouped together, above any time-specific events.)

Example Usage

[ics_calendar url="https://example.com/calendar.ics" hidealldayindicator="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Accepted Values

Value	Default	Pro	Description
true			Hides events marked PRIVATE or CONFIDENTIAL
false	Default		Does not hide any events that are in the feed

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

By default, ICS Calendar displays any events that are included in the feed. In terms of the iCalendar specification, it does not do anything with the CLASS property on events.

This parameter is mainly intended for a specific Google Calendar use case, although it may be useful with other services as well. When your calendar is set to public and you are using what Google calls the Public address in iCal format, it automatically excludes any events in that calendar that are marked “private”. But if you use the Secret address in iCal format, those private events are included in the feed.

Using the hideprivateevents parameter in your shortcode will tell ICS Calendar to exclude any events with CLASS:PRIVATE or CLASS:CONFIDENTIAL from display.

This feature was added in ICS Calendar version 10.8.1 and is not currently available in the Pro Calendar Builder as of version 4.4.5. (It will be added in the next Pro update.)

Example Usage

[ics_calendar url="https://example.com/calendar.ics" hideprivateevents="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Accepted Values

Value	Default	Pro	Description
true	Default		Does not show recurrence frequency
false			Shows recurrence frequency

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

You can hide recurrence frequency messages using hiderecurrence="true", or you can hide specific frequency types by entering one or more pipe-delimited frequencies to hide, e.g. hiderecurrence="yearly" or hiderecurrence="yearly|monthly".

Note: This parameter’s default value was changed in ICS Calendar version 10.6. Please see this blog post for more information.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" hiderecurrence="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Description

By default, start times are always displayed, and end times are displayed on hover. To hide all times (for instance, if the times are also in your event description), add the hidetimes="true" parameter.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" hidetimes="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Note: This parameter is available in ICS Calendar Pro only.

Description

When using the Calendar Builder, the start and end times are entered separately in the Daily Start Time and Daily End Time fields. If entering directly in the shortcode, the start and end times are handled as a pair of 4-digit values (24-hour time, HHMM) separated by a hyphen.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" hours="0800-1900"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Applicable Views

grid

Calendar Builder (Pro) users: This input displays conditionally, based on the View setting(s).

Accepted Values

Value	Default	Pro	Description
STRING			Accepts one of a designated subset of HTML tags

Description

This parameter is intended for SEO-focused developers who wish to control which HTML tags are used for the date headings in list view. The default value is h4. The following accepted values are allowed (must be lowercase):

h2, h3, h4, h5, h6, p, div, span

Note: h1 is deliberately excluded as it is never SEO-appropriate to use an h1 tag in the context of ICS Calendar.

This parameter was introduced in ICS Calendar v. 10.11.0.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" htmltagtitle="h5"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Accepted Values

Value	Default	Pro	Description
STRING			Accepts one of a designated subset of HTML tags

Description

This parameter is intended for SEO-focused developers who wish to control which HTML tags are used for the event descriptions. The default value is div. The following accepted values are allowed (must be lowercase):

h2, h3, h4, h5, h6, p, div, span

Note: h1 is deliberately excluded as it is never SEO-appropriate to use an h1 tag in the context of ICS Calendar.

This parameter was introduced in ICS Calendar v. 10.13.0.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" htmltageventdesc="span"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Accepted Values

Value	Default	Pro	Description
STRING			Accepts one of a designated subset of HTML tags

Description

This parameter is intended for SEO-focused developers who wish to control which HTML tags are used for the event titles. The default value is span. The following accepted values are allowed (must be lowercase):

h2, h3, h4, h5, h6, p, div, span

Note: h1 is deliberately excluded as it is never SEO-appropriate to use an h1 tag in the context of ICS Calendar.

This parameter was introduced in ICS Calendar v. 10.13.0.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" htmltageventtitle="div"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Accepted Values

Value	Default	Pro	Description
STRING			Accepts one of a designated subset of HTML tags

Description

This parameter is intended for SEO-focused developers who wish to control which HTML tags are used for the month headings. (Note: In year-based Pro views, this heading is used for the year.) The default value is h3. The following accepted values are allowed (must be lowercase):

h2, h3, h4, h5, h6, p, div, span

Note: h1 is deliberately excluded as it is never SEO-appropriate to use an h1 tag in the context of ICS Calendar.

This parameter was introduced in ICS Calendar v. 10.11.0.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" htmltagmonth="h4"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Accepted Values

Value	Default	Pro	Description
STRING			Accepts one of a designated subset of HTML tags

Description

This parameter is intended for SEO-focused developers who wish to control which HTML tags are used for the event times. The default value is span. The following accepted values are allowed (must be lowercase):

h2, h3, h4, h5, h6, p, div, span

Note: h1 is deliberately excluded as it is never SEO-appropriate to use an h1 tag in the context of ICS Calendar.

This parameter was introduced in ICS Calendar v. 10.13.0.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" htmltagtime="div"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Applicable Views

basic

Accepted Values

Value	Default	Pro	Description
STRING			Accepts one of a designated subset of HTML tags

Description

This parameter is intended for SEO-focused developers who wish to control which HTML tags are used for the main calendar title. The default value is h2. The following accepted values are allowed (must be lowercase):

h2, h3, h4, h5, h6, p, div, span

Note: h1 is deliberately excluded as it is never SEO-appropriate to use an h1 tag in the context of ICS Calendar.

This parameter was introduced in ICS Calendar v. 10.11.0.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" htmltagtitle="h3"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Note: This parameter is available in ICS Calendar Pro only.

Accepted Values

Value	Default	Pro	Description
INTEGER		Pro Only	The post ID of your saved calendar from Calendar Builder

Description

If you are using ICS Calendar Pro’s Calendar Builder to configure your calendar, you do not need to enter a complicated shortcode in your pages. Instead, the Calendar Builder displays a Shortcode field at the top of the page, containing the unique ID for this particular calendar configuration.

You can edit the calendar configuration at any time, and any instances of the simple shortcode using this ID throughout your site will automatically pick up the changes. (Note: you may need to run the Clear Cached Calendar Data utility on the ICS Calendar admin page, as well as any additional caches generated by third-party caching plugins.)

ICS Calendar shortcodes that are built with this parameter can also include any of the other standard parameters, for example if you want to use a saved Calendar Builder calendar in multiple places on your site, but override one or more of the settings in any individual instance, as such:

[ics_calendar id="123" format="n/d"]

Description

An update to the ics-parser library introduced in ICS Calendar v. 9.0 presented a problem for a small number of users, where the new version of ics-parser strips CSS classes out of HTML-formatted event descriptions. Using this parameter will cause ICS Calendar to continue using the older version of the parser.

This option will be removed when an updated version of ics-parser that resolves this issue is available.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" legacyparser="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Accepted Values

Value	Default	Pro	Description
above	Default		Shows legend above the calendar
below			Shows legend below the calendar

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

Determines where to display the legend (list that identifies the different calendar feeds) relative to the calendar. Valid values are "above" and "below". If omitted or an invalid value, will default to above.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" legendposition="above"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Calendar Builder (Pro) users: This input displays conditionally, based on the Legend Style setting(s).

Accepted Values

Value	Default	Pro	Description
block	Default		Displays items in legend stacked vertically
inline			Displays items in legend inline in a row
none			Legend does not display

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

Determines how to display the legend. Valid values are "block", "inline" and "none". If omitted or an invalid value, will default to block.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" legendstyle="block"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Note: This parameter is available in ICS Calendar Pro only.

Accepted Values

Value	Default	Pro	Description
INTEGER		Pro Only	Number of events to show per day in the month table

Description

By default, Month with Sidebar view shows a maximum of 3 events per day in the month table, followed by a note indicating the number of additional events on that day. Clicking a day displays its full list in the sidebar.

This parameter lets you adjust the number of events to show per day in the table.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" limit_in_table="3"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Applicable Views

month-with-sidebar

Calendar Builder (Pro) users: This input displays conditionally, based on the View setting(s).

Description

By default, the plugin limits the displayed date range to the farthest future event in your feed. Use limitdays="NUMBER" to override the default limit. Replace NUMBER with your desired number of days. Note: If your calendar has a very large number of events, setting this value above 365 may affect performance.

Microsoft Outlook/Office 365 users: In some cases, Microsoft limits the source feed to 6 months. Please see this note for more information.

Note: This parameter’s default value was changed in ICS Calendar version 10.6. Please see this blog post for more information.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" limitdays="180"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Description

Use this option only if your feed formats event description line breaks in a way that does not conform properly to the iCalendar spec. Has no effect on properly formatted feeds.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" linebreakfix="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Description

If the event data contains a URL, the URL can be added to the display as a clickable link in one of two ways. Use the linktitles="true" parameter to make the event title into a clickable link to that URL. If linktitles is not used, and eventdesc="true" is used, then the URL will be displayed as a clickable link after the event description. These links will always open in a new tab/window. If you do not wish to have event URL links appear at all, use nolink="true".

Example Usage

[ics_calendar url="https://example.com/calendar.ics" linktitles="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Accepted Values

Value	Default	Pro	Description
true	Default		Displays event locations in the description area
false			Does not display event locations
maplinks			Displays event locations and automatically makes them clickable Google Maps links

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

Use the location="true" parameter to display event locations (if available). Note: In the month view, locations will display on hover; in the list view, locations will display in full on the page below the event title.

Use location="maplinks" to make event locations automatically convert into a clickable Google Maps link, unless the feed’s LOCATION field data already contains HTML or a URL.

Important: location="maplinks" performs a Google Maps search on the exact text of your events’ LOCATION fields. It does not have a way to verify that the value is a real address, so incomplete locations (e.g. conference room names within your office) may yield nonsensical map results.

Note: This parameter’s default value was changed in ICS Calendar version 10.6. Please see this blog post for more information.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" location="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Accepted Values

Value	Default	Pro	Description
google	Default		Use Google Maps for automatic map links
bing			Use Bing Maps for automatic map links
openstreetmap			Use OpenStreetMap for automatic map links

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

If your calendar is set to display event location information with map links, via location="maplinks", the default is to generate Google Maps links. This setting lets you choose one of the available alternate map options, Bing Maps or OpenStreetMap.

Please note: This parameter only works in conjunction with location="maplinks" in your shortcode. If that is not set, mapsource will have no effect.

OpenStreetMap users: OpenStreetMap works best if your feed includes exact longitude and latitude coordinates via the GEO property (which is rare). If your feed does not contain GEO data, ICS Calendar performs a search on the map service using the address in the LOCATION property of the feed. While this generally works well with Google or Bing, OpenStreetMap is a bit more restrictive in its search results, and it may not return a usable match.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" mapsource="bing"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Description

In some cases, such as for vacation rental availability, you may not want to show any event details, but simply block out days and times. Use maskinfo="MASK", replacing MASK with the text you wish to display in place of the event title. Event details, location and organizer will also be hidden automatically, regardless of any other settings.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" maskinfo="Booked"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Accepted Values

Value	Default	Pro	Description
(empty)	Default		Tries cURL, then fopen if cURL fails
curl			Tries cURL only
fopen			Tries fopen only

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

The method attribute can be used to force the plugin to only try retrieving the ICS feed via either cURL or fopen. By default, the plugin tries cURL first and then falls back on fopen. In cases where cURL fails, but with a long timeout, you can use method="fopen" in the shortcode to bypass cURL. This can significantly improve page load times for calendars that experience this issue with cURL receiving an HTTP 500 error from the calendar server. Conversely, if you only want to load the feed via cURL, and not allow the fopen fallback, use method="curl" in your shortcode.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" method="curl"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Note: This parameter is available in ICS Calendar Pro only.

Accepted Values

Value	Default	Pro	Description
true		Pro Only	Show all months when collapsed to mobile list view
false	Default	Pro Only	Retain month-by-month dropdown in collapsed view

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

By default (unless the nomobile parameter is set), month view collapses to a list on mobile devices, for usability. This collapsed list view retains the month dropdown menu, showing the events for only one month at a time.

Turn on this option to display all events at once on mobile devices. Has no effect on the desktop view.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" month_list_all="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Applicable Views

month

Calendar Builder (Pro) users: This input displays conditionally, based on the View setting(s).

Note: This parameter is available in ICS Calendar Pro only.

Accepted Values

Value	Default	Pro	Description
true		Pro Only	Adds month/list toggle option to month view
false	Default	Pro Only	Does not add the month/list toggle

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

When this option is turned on, month view adds a Month/List toggle button, allowing users to switch between the default table-based month layout and a simple day-by-day, event-by-event list view. This list view matches the version that month view automatically collapses to on mobile devices.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" month_table_list_toggle="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Applicable Views

month

Calendar Builder (Pro) users: This input displays conditionally, based on the View setting(s).

Accepted Values

Value	Default	Pro	Description
select	Default		Displays a select (dropdown) menu
arrows			Displays previous/next month arrows
both			Displays both a select menu and arrows
compact			Displays both, inline, without the default month/year header

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

By default, the month view shows a dropdown (select) menu to navigate available months. Add monthnav with a value of select, arrows, both or compact (both, inline without header) to change how this is displayed. Applies to month view only.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" monthnav="select"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Applicable Views

month
month-with-sidebar

Calendar Builder (Pro) users: This input displays conditionally, based on the View setting(s).

Description

Suppresses display of event links. Useful if your calendar feed automatically inserts a default link on all events that you do not wish to display along with the event description.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" nolink="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Description

The standard treatment for month and week views on mobile is to stack the display in a list style, because the grid does not work well scaled to the small size of a mobile display. However, if you wish to retain the grid, add nomobile="true" to your shortcode. Note that you will probably need to add your own custom CSS to make this display usable. Be sure to wrap your CSS in @media screen and (max-width: 782px) { } and use .ics-calendar.nomobile .ics-calendar-month-grid in your CSS selectors.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" nomobile="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Applicable Views

month
week

Calendar Builder (Pro) users: This input displays conditionally, based on the View setting(s).

Description

Use nomonthheaders="true" on list or month view to prevent month headers from displaying on the page. Reduces overall layout size by removing the month headers. Does not apply to views where month headers are necessary for usability. (Has no effect on week view since there are no month headers in that view anyway.)

Example Usage

[ics_calendar url="https://example.com/calendar.ics" nomonthheaders="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Accepted Values

Value	Default	Pro	Description
true
false	Default

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

Turns off most CSS styles for the Basic view (introduced in version 10.13), allowing for full customization with your own CSS. This parameter has no effect on any other views.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" nostyle="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Applicable Views

basic

Accepted Values

Value	Default	Pro	Description
true	Default		Shows the event organizer
false			Does not show the event organizer

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

Use the organizer="true" parameter to display event organizer (if available). Note: In the month view, organizers will display on hover; in the list view, locations will display in full on the page below the event title (and location, if shown).

Note: This parameter’s default value was changed in ICS Calendar version 10.6. Please see this blog post for more information.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" organizer="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Accepted Values

Value	Default	Pro	Description
INTEGER			Number of events to include per page

Description

This feature is new in ICS Calendar version 10.7.

With this parameter, list view supports pagination. When using pagination, be sure to also include the count parameter. You should use count to set the total number of events you want to display, and pagination to set the number of events to display per “page.”

Note: This value is approximate. The list will always keep events that occur on the same date grouped together on a single page, possibly resulting in some pages containing more than the designated number of events.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" pagination="5"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Applicable Views

basic
list

Accepted Values

Value	Default	Pro	Description
above	Default		Shows pagination links above the event list
below			Shows pagination links below the event list
both			Shows pagination links both above and below the event list

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

This setting is only relevant for list view when pagination is set. Determines if the pagination links appear above or below the list, or both. The default is below, but some users may wish to display the links above the list, since varying event description lengths can cause the links to move up or down on the page when clicked.

This parameter was introduced in ICS Calendar v.10.9.1.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" paginationposition="below"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Applicable Views

basic
list

Description

By default, list and month views do not include past dates (before the first of the current month, in month view) unless startdate is used to set an arbitrary start date. You can also set a rolling start by using pastdays="NUMBER" where NUMBER is replaced with the number of days back you wish to begin. For instance, to show 3 previous months you could enter pastdays="90". This option has no effect in week view.

Notes about the pastdays attribute:

1. You may need to make adjustments to the limitdays option when this is used, as it calculates from the first displayed date, not the current date.

2. This attribute has no effect on week view.

Note: This parameter’s default value was changed in ICS Calendar version 10.6. Please see this blog post for more information.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" pastdays="90"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Calendar Builder (Pro) users: This input displays conditionally, based on the Start On setting(s).

Note: This parameter is available in ICS Calendar Pro only.

Accepted Values

Value	Default	Pro	Description
true		Pro Only	Turns on Regular Expressions parsing
false	Default	Pro Only	No Regular Expressions parsing

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

Executes the PHP preg_replace() function on event data, allowing you to build complex text replacement logic if you need to customize how your event information is displayed. Requires an understanding of PCRE (Perl-Compatible Regular Expressions).

Important: This option just turns on the Regular Expressions functionality. You will also need to set the Pattern, Replacement and Scope parameters.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" regex="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Note: This parameter is available in ICS Calendar Pro only.

Description

Defines the pattern for the RegEx search. Requires an understanding of PCRE (Perl-Compatible Regular Expressions).

Example Usage

[ics_calendar url="https://example.com/calendar.ics" regex_pattern="/PATTERN/"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Calendar Builder (Pro) users: This input displays conditionally, based on the Regular Expressions setting(s).

Note: This parameter is available in ICS Calendar Pro only.

Description

Defines the replacement for the RegEx search. Requires an understanding of PCRE (Perl-Compatible Regular Expressions).

Example Usage

[ics_calendar url="https://example.com/calendar.ics" regex_replacement="REPLACEMENT"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Calendar Builder (Pro) users: This input displays conditionally, based on the Regular Expressions setting(s).

Note: This parameter is available in ICS Calendar Pro only.

Accepted Values

Value	Default	Pro	Description
(empty)	Default		No scope; search will not be performed
event_label_html			Searches in event titles only
event_description_html			Searches in event descriptions only

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

Regular Expressions can be applied to either the event titles or event descriptions, or to both. This parameter determines the scope of the search. Note that this parameter is required when applying regular expressions. If you wish to include both titles and descriptions, both values can be entered, pipe-delimited.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" regex_scope="event_label_html|event_description_html"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Calendar Builder (Pro) users: This input displays conditionally, based on the Regular Expressions setting(s).

Description

Note: This parameter’s functionality has changed as of version 8.5.5.

By default, ICS Calendar caches your parsed feed data for one hour (3600 seconds). Previous versions supported using reload="true" to tell the plugin not to cache the calendar data at all. This is still supported, but now the reload parameter supports any integer value, representing the number of seconds the cache should be retained. For instance, to set the cache to four hours instead of one, use reload="14400". If this parameter is omitted or set to 0, false, or a negative value, the default 3600-second (1-hour) cache will apply.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" reload="1"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Accepted Values

Value	Default	Pro	Description
true			Shows the event resources
false	Default		Does not show the event resources

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

If your calendar feed includes the RESOURCES property (typically used to assign rooms or equipment to an event), use this option to display that information in the event description hover/lightbox. Note: It is uncommon for most feeds to include this information.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" resources="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Description

If you want to display a list of past events, use reverse="true" in your shortcode. The list will start from the current date and move backwards from there.

Use in conjunction with pastdays to set the number of days to include in the display.

Notes:

1. When reverse is used, pastdays and limitdays are automatically set to the same value. If both are set, pastdays takes precedence.
2. Due to date scope logic in the parser, if both pastdays and limitdays are omitted, only events in the current calendar year will be displayed.
3. The reverse option applies only to list view. It has no effect on other views, due to a logical incompatibility with other layouts.
4. Multiple events within a single day are still displayed in “forward” time order.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" reverse="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Applicable Views

list

Calendar Builder (Pro) users: This input displays conditionally, based on the View setting(s).

Accepted Values

Value	Default	Pro	Description
true			Opens offsite links in the calendar in the same tab as the current page
false	Default		Opens offsite links in the calendar in a new tab

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

By default, ICS Calendar opens any links contained within the calendar that are offsite (on a different domain than your site) in a new browser tab.

Add sametab="true" to your shortcode to have these links open in the same browser tab as the current page.

This option was introduced in ICS Calendar version 9.9.0. At this time it is not yet included in the Calendar Builder in ICS Calendar Pro; however, as with all parameters, you can add it to your id based Calendar Builder shortcodes as well.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" sametab="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Accepted Values

Value	Default	Pro	Description
true	Default		Event end times are always displayed
false			Event end times are only displayed when the user hovers over the start time

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

By default, start times are always displayed, and end times are displayed on hover. To always display end times (not just on hover), add the showendtimes="true" parameter.

Note: This parameter’s default value was changed in ICS Calendar version 10.6. Please see this blog post for more information.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" showendtimes="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Calendar Builder (Pro) users: This input displays conditionally, based on the Hide Times setting(s).

Note: This parameter is available in ICS Calendar Pro only.

Accepted Values

Value	Default	Pro	Description
true		Pro Only	Adds search filter tool above calendar
false	Default	Pro Only	No search filter

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

Adds a simple form above the calendar to filter the events being displayed. Helps users locate specific items on calendars with a large number of events.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" showfilter="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Description

Add the skip="NUMBER" parameter in conjunction with the count parameter in list view to split a calendar across multiple shortcodes within a page (e.g. a multi-column layout). This NUMBER of events will be skipped in display. Should match the sum of the count value(s) from previous shortcode(s) on the page for the same feed.

Note: As of ICS Calendar version 10.7, you may wish to use the pagination parameter, rather than using skip with multiple instances of your shortcode.

ICS Calendar Pro users: This parameter is not included in the Calendar Builder because its intended use is inconsistent with the Calendar Builder logic. If you wish to use skip, you should create one single saved calendar, and then reuse its id-based shortcode multiple times, adding the skip parameter directly to each instance of the shortcode, as appropriate.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" skip="5"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Applicable Views

list

Accepted Values

Value	Default	Pro	Description
true			Won't try to load additional feeds from a server that has already returned an empty response or error
false	Default		Will try to load every feed included in all shortcodes on the page

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

By default, ICS Calendar tries to load every ICS feed in all ICS Calendar shortcodes contained on a page, regardless of whether or not any of the previous feeds failed to load.

In some cases, a page may contain a large number of feeds, all from the same server. If that server is unresponsive or returning errors, this could result in a page taking several minutes to load, as ICS Calendar futilely attempts to retrieve each additional feed.

By adding skipdomainerrors="true" to your shortcode, ICS Calendar will keep track of the domains (servers) that have failed to return a valid feed already on the same page, and will automatically skip even attempting to connect to them again.

Note: The logic for skipping feeds only applies to a single page load. However, caching (including ICS Calendar’s internal caching mechanism) may cause the empty response to be retained on subsequent page loads by other users. If you are using this option, you may also wish to set a fairly short cache duration, such as reload="300" (5 minutes).

Example Usage

[ics_calendar url="https://example.com/calendar.ics" skipdomainerrors="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Description

Add the skiprecurrence="true" parameter to skip parsing recurring events. Since this omits all recurrences, it should only be used if the calendar is extremely large (affecting performance), and recurring events are not needed.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" skiprecurrence="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Description

Include solidcolors="true" in your shortcode to make events in color-coded feeds use the designated color as a solid background behind the text, instead of the default lighter “tint” of the designated color.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" solidcolors="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Description

By default, the calendar display will start from the current date. To have the calendar start from an arbitrary date (either in the future or the past), use this parameter with the date in an 8-digit "YYYYMMDD" format.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" startdate="20220906"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Calendar Builder (Pro) users: This input displays conditionally, based on the Start On setting(s).

Accepted Values

Value	Default	Pro	Description
true	Default		The address bar URL changes when the user changes the displayed month, allowing links to a specific month
false			The address bar URL does not change when the user interacts with the calendar

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

Add stickymonths="true" to your shortcode to have the browser’s address bar automatically update with a month code when the user selects a month from the dropdown menu (month view only). Using this URL will open the page with the given month pre-selected.

Note: This parameter’s default value was changed in ICS Calendar version 10.6. Please see this blog post for more information.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" stickymonths="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Applicable Views

month
month-with-sidebar
widget

Calendar Builder (Pro) users: This input displays conditionally, based on the View setting(s).

Note: This parameter is available in ICS Calendar Pro only.

Accepted Values

Value	Default	Pro	Description
true		Pro Only	Add subscribe links
false	Default	Pro Only

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

This option adds a subscribe link below the calendar. For multi-feed calendars, the subscribe links will be in the color key next to the calendar names. Note: This will make the direct URL of your feed publicly available.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" subscribelink="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Note: This parameter is available in ICS Calendar Pro only.

Accepted Values

Value	Default	Pro	Description
events		Pro Only	Shows first few events on each day; exact number set by Limit in Table
dot		Pro Only	Shows a dot indicating day has events

Description

Month with Sidebar view is a design that combines a table-based month view with a sidebar showing the full details of events on a selected date. Because this view might need to fit into a variety of page widths, this option lets you control whether the table shows a list of a few of each day’s events, or a simple dot indicating the date has events.

With either option, clicking on a date in the table shows the full list of that day’s events in the sidebar.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" table_cell_contents="events"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Applicable Views

month-with-sidebar

Calendar Builder (Pro) users: This input displays conditionally, based on the View setting(s).

Description

Older versions of ICS Calendar automatically applied a transparent background color to the calendar table, taking on whatever background color was on the container element. In version 8.4.0 this was changed so the table by default has a white background. The tablebg parameter was added to allow site admins to set a custom background color.

Note that you can use tablebg="transparent" to restore the old functionality.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" tablebg="#ffffff"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Applicable Views

month
week
month-with-sidebar
widget
widget-availability
year-availability
year-with-sidebar

Description

Note: This parameter was introduced in ICS Calendar v. 9.8.0, and the Calendar Builder option was introduced in ICS Calendar Pro v. 3.17.0.

By default ICS Calendar will display all times in the format in your general WordPress settings under Settings → General → Time Format.

To use a different time format in your ICS Calendar shortcode, use a value in standard PHP date format with the timeformat parameter.

ICS Calendar Pro users: Because ICS Calendar’s custom time formatting function only supports a subset of the PHP options, the Calendar Builder field is a dropdown of valid options rather than a freeform text input.

Why does ICS Calendar have its own custom function for time format? PHP date functions use a DateTime object. This object has special properties to deal with the complexities of timezones, Daylight Saving Time, etc. However, by the point in the process where ICS Calendar is manipulating time formats, these details have already been addressed and we simply need a way to manipulate the format of a text string, ignoring things like timezone logic. Because the DateTime can’t work with a simple text string, we needed to create our own function.

The custom function is really only designed to handle manipulations of 12- and 24-hour time, various ways of presenting “am/pm” labels, and other common time formatting options. Ironically, the function cannot handle any timezone-related parameters such as T, because those do require the timezone data from the DateTime object. But using the object at this point can result in a doubling of any timezone offsets from UTC. We are working on an updated version of the function that will better handle these parameters.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" timeformat="H:i"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Accepted Values

Value	Default	Pro	Description
true			Automatically displays the title of the calendar from the source feed (if the calendar only contains one feed)
false	Default		Hides the source calendar's title; does not display any title above the calendar
(custom text)			Displays the text entered, instead of the source calendar's title

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

The title parameter is optional. If omitted, the title provided by the calendar feed will be displayed. Use “false” (e.g. title="false") to hide the title altogether.

Note: This parameter’s default value was changed in ICS Calendar version 10.6. Please see this blog post for more information.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" title="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Calendar Builder (Pro) users: This input displays conditionally, based on the Hide Calendar Title and Description; Customize Title and Description setting(s).

Accepted Values

Value	Default	Pro	Description
(empty)	Default		Event descriptions display in a floating box when user hovers over an event.
true			Event descriptions display inline. (Option in Calendar Builder is inline.)
lightbox			Event descriptions display in a pop-up "lightbox."

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

Note: This option’s functionality has been modified as of version 8.8.0.

By default, when eventdesc="true" is set, event descriptions display in a floating box when users hover over an event in table-based calendar views. In list view, the descriptions are displayed directly on the page below the event title.

The toggle option lets you change this behavior. Setting toggle="true" will make the event descriptions appear inline when the user clicks on an event’s title. Setting toggle="lightbox" will cause the description to appear in a pop-up “lightbox” when users click the event title. The lightbox option is especially well suited to calendars that tend to have very long event descriptions, as it allows a much larger space for displaying the descriptions.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" toggle="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Calendar Builder (Pro) users: This input displays conditionally, based on the Event Descriptions, Event Locations & Event Organizers setting(s).

Description

By default, the feed will display events with times adjusted for the local timezone configured under Settings > General > Timezone. You can override the site’s timezone for individual feeds by adding the tz="TIMEZONE" parameter. You must use a valid named timezone value or the setting will be ignored and the site’s local timezone setting will be used. If your calendar is displaying multiple feeds, you can assign each a separate timezone override, as with feed labels or colors, by entering multiple values, pipe-delimited, in the same order as the feeds in the url parameter, e.g. tz="America/New_York|Europe/London|Pacific/Auckland". If you have multiple feeds but all are in the same timezone, you only need to enter the timezone once.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" tz="America/Chicago"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Note: This parameter is available in ICS Calendar Pro only.

Accepted Values

Value	Default	Pro	Description
true		Pro Only	Shows timezone for each feed in the legend
false	Default	Pro Only	Does not show timezones in the legend

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

If the legend is being used, this option will add the timezone for each feed to the legend. Helpful mainly in situations where the different source calendars have different timezones.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" tzinlegend="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Calendar Builder (Pro) users: This input displays conditionally, based on the Legend Style setting(s).

Description

The ICS subscription URL for your feed.

It must be a subscription URL, not a URL that displays your calendar in a web view. (Loading the URL directly in your browser’s address bar should download an .ics file.) Enter multiple URLs, space- or pipe-delimited, to combine multiple feeds into one calendar display.

This is the only required parameter for the shortcode. (Exception: Calendar Builder-based saved calendars in Pro only need the id parameter.)

Example Usage

[ics_calendar url="https://example.com/calendar.ics" url="https://example.com/calendar.ics"]

Accepted Values

Value	Default	Pro	Description
month	Default		Month table view (default)
basic			A list of individual events with big dates, or a plain list if nostyle="true" is used
list			A simple day-by-day list
week			Single week table view
grid		Pro Only	Day columns with hourly grid
month-with-sidebar		Pro Only	Month view with day list in sidebar
widget		Pro Only	Mini month with day list below
widget-availability		Pro Only	Mini month optimized for rental bookings
year-with-sidebar		Pro Only	Year-at-a-glance with day list in sidebar
year-availability		Pro Only	Year view optimized for rental bookings

Note: If using the default option indicated above, this parameter can be omitted entirely.

Description

Determines which layout to use. View options included in the base plugin are "month", "week" and "list". Month view is the default, and this parameter can be omitted entirely. See Views for more details about each view.

Additional view options are available in the Pro version. While we generally recommend using the Calendar Builder to manage calendar settings in Pro, all Pro features can also be entered manually in a shortcode. The additional views currently available in Pro are: "grid", "month-with-sidebar", "widget", "year-availability" and "year-with-sidebar"

Example Usage

[ics_calendar url="https://example.com/calendar.ics" view="month"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Description

This option adds an extra column at the beginning of each row of the table, indicating the week number within the year.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" weeknumbers="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Applicable Views

month
week
month-with-sidebar

Calendar Builder (Pro) users: This input displays conditionally, based on the View setting(s).

Description

Include whitetext="true" in your shortcode to force all text within the calendar to be white. Useful on pages with dark backgrounds.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" whitetext="true"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Note: This parameter is available in ICS Calendar Pro only.

Accepted Values

Value	Default	Pro	Description
FLOAT		Pro Only	Decimal numeric value for scaling the grid relative to a base value

Description

Sets the relative size of hour blocks in grid view. 1.0 is approximately equal to 100 pixels. The default value is 0.6.

Example Usage

[ics_calendar url="https://example.com/calendar.ics" zoom="0.6"]

Note: Example only shows the relevant portion of the shortcode for this parameter. Your shortcode must include url plus any other desired parameters.

Applicable Views

grid

Calendar Builder (Pro) users: This input displays conditionally, based on the View setting(s).