Add the calendar you already use to Any WordPress site! Google Calendar, Microsoft 365, iCloud, Airbnb and more\u2026 no API keys or complicated setup required.<\/p>\n\n
Using a simple shortcode, you can turn any iCalendar subscription (ICS) feed (Google Calendar, Microsoft Office 365, Apple iCloud, Airbnb, Vrbo, and many more) into a seamlessly integrated, auto-updating, zero-maintenance WordPress calendar.<\/p>\n\n
Continue to manage your events in the calendar software you're already using! You'll automatically have an up-to-date calendar in your WordPress website with no extra work.<\/p>\n\n
Display your calendar in month, list or week view. Many additional customization options are available. See our User Guide<\/a> for full details.<\/p>\n\n No API keys required!<\/strong><\/p>\n\n Works with ANY calendar software<\/strong> that generates a public iCalendar subscription link.<\/p>\n\n You can preview your own calendar in any ICS Calendar view at our website: icscalendar.com\/preview<\/a><\/p>\n\n We've made it easier than ever to get started using ICS Calendar with our new online shortcode builder: icscalendar.com\/shortcode-builder<\/a><\/p>\n\n All date strings (days of the week, months, etc.) are automatically translated into your site's configured language (under Settings > General > Language<\/strong>) and date\/time formats using core WordPress functionality. All text content for the calendar itself is displayed as-is from the feed.<\/p>\n\n ICS Calendar includes built-in translation files for the following languages: Chinese, Czech, Danish, Dutch, Estonian, Finnish, French, German, Greek, Hungarian, Icelandic, Italian, Japanese, Korean, Latvian, Lithuanian, Norwegian, Polish, Portuguese, Romanian, Russian, Serbian, Slovakian, Slovenian, Spanish, Swedish, Turkish, and Ukrainian.<\/p>\n\n Please contact us<\/a> if you would like us to add support for your language!<\/p>\n\n This plugin includes the PHP ICS Parser library by Jonathan Goode, John Grogg and Martin Thoma (MIT license).<\/em><\/p>\n\n\n Once the plugin is installed and activated, use the shortcode below (adding your own ICS feed URL between the quotation marks) to insert a calendar into your pages. Use our online Shortcode Builder<\/a> to easily create a customized shortcode, or consult the User Guide<\/a> for more information.<\/p>\n\n Be sure you are using the iCalendar subscription (ICS)<\/em> URL (i.e. for importing into a calendar program), not the URL for viewing a calendar in a web browser. To test if you have the correct URL, paste it directly into your browser address bar. It should download an Different calendar systems have different ways to obtain the feed URL. You may need to consult your calendar software's documentation for assistance. Find instructions for commonly used calendars below.<\/p>\n\n You will also need to make sure that your calendar is public. Private calendars cannot be accessed by this plugin.<\/p>\n\n Documentation quick links:<\/em><\/p>\n\n Use this shortcode, inserting your ICS feed URL between the quotation marks:<\/p>\n\n Be sure you are using the iCalendar subscription (ICS)<\/em> URL (i.e. for importing into a calendar program), not the URL for viewing a calendar in a web browser. To test if you have the correct URL, paste it directly into your browser address bar. It should download an Yes! You can combine multiple calendars by including more than one feed URL in the This may be due to your server's configuration. This plugin requires either the PHP cURL extensions, or the For performance, this plugin uses WordPress transients to store retrieved calendar data for one hour between requests to the calendar source server. If you have updated events that are not showing up in your page, visit the ICS Calendar<\/strong> page in your site admin and click the Clear Cached Calendar Data<\/strong> button.<\/p>\n\n Third-party caching plugins may interfere with ICS Calendar's feed syncing. ICS Calendar uses AJAX to work around most caching conflicts, but your caching plugin may require you to add the PHP has two different ways of defining timezones: as a number of hours offset from GMT\/UTC (e.g. \"UTC-5\"), or as a continent\/city combination (e.g. \"America\/Chicago\"). Timezones using UTC offsets do not handle Daylight Saving Time correctly (as noted in the PHP documentation<\/a>). Please check your WordPress timezone settings (Settings > General > Timezone<\/strong>). If it is set to a UTC offset, change it to the city closest to your location, in the same timezone. You can also set the timezone within the shortcode using the Our User Guide<\/a> includes extensive documentation of all features of the plugin, is frequently updated, and is translated into all languages supported by the plugin.<\/p><\/dd>\n The paid ICS Calendar Pro<\/a> add-on includes additional layout options, tools for customizing the calendar's appearance more easily than directly editing CSS, an improved insertion tool, and more. We are also constantly adding new features and refinements to both<\/em> the free and paid versions. If you have suggestions for features you'd like to see or any other additional input, please let us know by following the support link on the admin page or in the WordPress support forums<\/a>! The base plugin will always be free to use.<\/p><\/dd>\n\n<\/dl>\n\n\nLive Preview<\/h4>\n\n
Shortcode Builder<\/h4>\n\n
Language Support<\/h4>\n\n
[ics_calendar url=\"\"]\n<\/code><\/pre>\n\n.ics<\/code> file, not display the calendar in the browser.<\/p>\n\n\n\n
How do I find my calendar's ICS feed URL?<\/h3><\/dt>\n
\n
How do I insert a calendar into my page?<\/h3><\/dt>\n
[ics_calendar url=\"\"]\n<\/code><\/pre>\n\n.ics<\/code> file, not display the calendar in the browser.<\/p><\/dd>\nCan I combine multiple calendars?<\/h3><\/dt>\n
url<\/code> parameter. Separate the calendar URLs with one space or a pipe |<\/code> character.<\/strong> Do not include any other delimiter characters, as they will be interpreted as part of the URL.<\/p><\/dd>\nWhy isn't my calendar loading?<\/h3><\/dt>\n
allow_url_fopen<\/code> PHP setting to be turned on. Check your PHP configuration or your server administrator if you think this may be the issue. You can also use the ICS Feed URL Tester<\/strong> utility on the ICS Calendar admin page to check if your server is able to connect to the calendar source.<\/p><\/dd>\nWhy isn't my calendar updating?<\/h3><\/dt>\n
wp-admin\/admin-ajax.php<\/code> path to its list of exclusions in order for AJAX to function properly.<\/p><\/dd>\nWhy are event times an hour off after Daylight Saving Time begins?<\/h3><\/dt>\n
tz<\/code> parameter. (Again, be sure to use a named region\/city timezone, not a UTC offset.)<\/p><\/dd>\nAdditional documentation and support<\/h3><\/dt>\n
Feature requests<\/h3><\/dt>\n
12.0.6 - 2026.04.01<\/h4>\n\n
\n
\n
\n
nomobile<\/code> was set.<\/li>\n<\/ul><\/li>\n\n
\n
readme.txt<\/code> content.<\/li>\n<\/ul><\/li>\n\n
12.0.5.2 - 2026.03.23<\/h4>\n\n
\n
\n
\n
r34ics_init()<\/code> JavaScript function to address issues when multiple calendars are displayed on the same page. Some logic in this function must run for every<\/em> calendar, and some of it should only run once per page. The logic that should only run once per page is being moved to a separate r34ics_init_once()<\/code> function.<\/li>\n<\/ul><\/li>\n<\/ul>\n\n12.0.5.1 - 2026.03.11<\/h4>\n\n
\n
\n
12.0.5 - 2026.03.09<\/h4>\n\n
\n
\n
\n
r34ics_maybe_make_clickable()<\/code> to fix regression in converting raw image URLs into img<\/code> tags; added support for WebP image URLs.<\/li>\n<\/ul><\/li>\n\n
12.0.4.2 - 2026.02.27<\/h4>\n\n
\n
\n
R34ICS::_url_get_contents()<\/code> method to only check for specific text strings in the response when the response code is not<\/em> 200. This should resolve possible erroneous redirections that occur if the text strings being checked appear in the ICS feed response content itself.<\/li>\n<\/ul><\/li>\n\n
r34ics_i18n_symlinks()<\/code> to delete old translation files before copying or symlinking new file, to ensure changes are picked up.<\/li>\n12.0.4.1 - 2026.02.07<\/h4>\n\n
\n
\n
redirection<\/code> change introduced in 12.0.4, as it seems to be breaking the custom redirection logic ICS Calendar already included. In the rare cases where a feed does<\/em> need redirection<\/code> to be set to something other than 0, this can be done with custom PHP using the r34ics_url_get_contents_request_args<\/code> filter.<\/li>\n<\/ul><\/li>\n\n
symlink()<\/code> function is not available. The plugin now checks for symlink()<\/code>, falls back to copy()<\/code> if needed, and if both fail, it displays an admin notice addressing the conflict with Loco Translate.<\/li>\n12.0.4 - 2026.02.02<\/h4>\n\n
\n
\n
\n
redirection<\/code> value in R34ICS::_url_get_contents()<\/code> method from 0 to 5. May resolve some feed loading issues when the source returns an HTTP 302 redirect.<\/li>\n12.0.3.1 - 2026.01.21<\/h4>\n\n
\n
R34ICS::shortcode()<\/code>, changed in 12.0.3, to handle undefined $args['ajax']<\/code>. (Probably unnecessary since it's explicitly defined above, but best practice since there's a filter that can modify the contents of $args<\/code>.)<\/li>\nr34ics_is_html()<\/code> to resolve false negatives.<\/li>\nr34ics_maybe_make_clickable()<\/code> to only run if there is no detected HTML in the string. In some instances the code was converting images that were already in an img<\/code> tag. (The assumption here will be that if the string contains any HTML, the image will already<\/em> be in an img<\/code> tag if that's the intention.<\/li>\n<\/ul>\n\n12.0.3 - 2026.01.19<\/h4>\n\n
\n
\n
\n
r34ics_is_block_editor()<\/code> to more effectively limit the conditional check for REST_REQUEST<\/code> constant.<\/li>\n<\/ul><\/li>\n\n
\n
r34ics_display_calendar_force_reload<\/code> filter to allow bypassing the new rate limit related restrictions added in 12.0.0. Please do not use this filter unless you understand the performance impact it may have.<\/strong> By default, ICS Calendar intentionally throttles how frequently requests are made to the source calendar. This is done both to improve your site performance and to avoid hitting source calendar providers' rate limits, which can result in HTTP 429 errors and failure to load your calendar. (In some extreme cases, providers may rate limit entire networks.) If you have any questions about whether or not it is appropriate to use this filter with your site, please contact support<\/a> before proceeding.<\/li>\n<\/ul><\/li>\n\n
WP_LANG_DIR<\/code> path when Loco Translate is active. (Normally, the general language files self-contained within ICS Calendar load directly, but Loco Translate overrides this functionality.)<\/li>\n<\/ul><\/li>\n\n
active_plugins<\/code> core option to use the is_plugin_active()<\/code> function instead.<\/li>\n<\/ul><\/li>\n<\/ul>\n\n12.0.2 - 2026.01.16<\/h4>\n\n
\n
\n
r34ics_maybe_make_clickable()<\/code> function to convert raw image file URLs in event descriptions directly into HTML img<\/code> tags, instead of clickable links. May be a useful workaround for including images in event descriptions for sources like Google Calendar and Microsoft 365, which do not make files directly accessible. _Note: The URL must<\/strong> be a direct URL to a publicly accessible image file, with a standard image extension (supported extensions: .apng<\/code>, .avif<\/code>, .gif<\/code>, .jpg<\/code>, .jpeg<\/code>, .png<\/code>, .svg<\/code>). Using a URL that links to Google Drive, OneDrive, iCloud, Dropbox, etc. will not work, because those are permission-restricted \"wrapper\" page URLs, not the direct URLs of the files themselves.<\/li>\n<\/ul><\/li>\n\n
R34ICS::display_calendar_date_range()<\/code> method. (There is no evidence that this was actually an issue but it's best practice and may help with resolving a date range issue affecting certain users.)<\/li>\nr34ics_color_key_allowed()<\/code> function to allow SVG images to be included in the legend (color key). Mainly used by ICS Calendar Pro for the Subscribe button.<\/li>\n--r34ics--element--events--color<\/code> text color (the same as events).<\/li>\nphpcs:ignore WordPress.WP.I18n.MissingTranslatorsComment<\/code> to a translation string in admin page to pass Plugin Check test.<\/li>\n<\/ul><\/li>\n<\/ul>\n\n12.0.1 - 2026.01.06<\/h4>\n\n
\n
12.0.0.1 - 2026.01.05<\/h4>\n\n
\n
r34ics_scrub_duplicate_uids()<\/code> function. (This function runs only when the fixredundantuids<\/code> parameter is set.)<\/li>\n$force_reload<\/code> parameter to R34ICS::display_calendar()<\/code> method.<\/li>\n12.0.0 - 2025.12.29<\/h4>\n\n
\n
\n