Description
Add the Calendar Feed block, paste your calendar’s address, and its events appear on the page in your theme’s fonts and colours: a list of what’s coming up, or a month grid. No iframe, no account, no API key.
- Works with the calendars people already keep: Google Calendar (its public iCal address or its share link), Outlook / Microsoft 365 published calendars, Apple iCloud public calendars, and any other iCal (.ics or webcal://) feed.
- Repeating events come out right: weekly classes on several days, “second Tuesday of the month”, “first and third Friday”, every weekday, yearly dates, skipped dates and single dates that were moved or cancelled. Each event keeps its own time zone, including Outlook’s Windows time zone names, and daylight saving doesn’t shift it.
- Several calendars in one block: up to five, each with its own colour and a name in a small key above the events (club events, holidays, matches…).
- Add to calendar and subscribe (optional): links on each event to add it to Google Calendar, Outlook.com or Microsoft 365, or download it as an .ics file for Apple Calendar and the Outlook app, and Subscribe links for the whole calendar in the same calendars.
- Visitors in other time zones (optional): for online events, times can be shown in each visitor’s own time zone, with the zone’s name.
- Fast pages: the calendar is read on your server at most once an hour and kept, so visitors never wait for Google. If the calendar host is down, the last good copy is shown (for up to 30 days).
- Looks like your site: plain HTML with a few layout rules, so it takes your theme’s typography, colours and links. Wide and full width are supported.
- List or month: choose how many events and how many days ahead for the list, whether to show the location and description. The month view has previous and next month links.
- Nothing to set up anywhere else: no settings page and no admin notices. Everything is in the block.
Problems with a calendar address (a private calendar, a typo) are shown to people who can edit the page, never to visitors.
If you’d rather manage events in WordPress itself, with recurring events, a calendar that syncs from Google, venues and RSVPs, have a look at Beacon Events, the full events calendar from the same author.
External services
The block downloads the calendar whose address you paste into it. Your web server makes that request, at most once an hour per calendar (a copy is kept for an hour, and the last good copy for up to 30 days in case the address stops answering). Nothing about your visitors is sent: their browsers never contact the calendar host. The request carries only a user agent naming this plugin and your site’s address.
Where the request goes depends on the address you paste:
- A Google Calendar address (including a share or embed link, which the block turns into the calendar’s public iCal address) goes to Google at calendar.google.com. Google Terms of Service, Google Privacy Policy.
- An Outlook or Microsoft 365 published calendar goes to Microsoft (outlook.office365.com or outlook.live.com). Microsoft Services Agreement, Microsoft Privacy Statement.
- An Apple iCloud public calendar goes to Apple (calendars.icloud.com or pXX-caldav.icloud.com). Apple Internet Services Terms, Apple Privacy Policy.
- Any other address goes to whoever hosts that calendar.
If you switch on the “Add to calendar” or “Subscribe” links, they point visitors to Google Calendar (calendar.google.com), Outlook.com (outlook.live.com) or Microsoft 365 (outlook.office.com) with that event’s title, time, place and description, or the calendar’s address and name, in the link; nothing is sent until a visitor clicks one. The “.ics” and “Apple Calendar / Outlook app” links are served by your own site or open the visitor’s calendar app.
Google Calendar is a trademark of Google LLC, Outlook and Microsoft 365 are trademarks of Microsoft, and iCloud is a trademark of Apple Inc. This plugin is not affiliated with or endorsed by them.
Installation
- In the block editor, add a block and search for “Calendar Feed” (or “Google Calendar”). Or install the plugin from Plugins → Add New.
- Paste your calendar’s public iCal address (see the FAQ for where to find it) and click Show calendar.
- In the block settings, choose a list or a month.
FAQ
Where do I find my Google Calendar’s address?
In Google Calendar on a computer, open Settings, click your calendar under “Settings for my calendars”, and under “Access permissions for events” tick “Make available to public”. Then copy “Public address in iCal format” under “Integrate calendar”. A share link (calendar.google.com/calendar/embed?src=…) works too: the block turns it into the iCal address. The secret address works as well, but anyone who can see the page’s settings could read it, so the public one is better.
And Outlook or Microsoft 365?
In Outlook on the web: Settings → Calendar → Shared calendars → Publish a calendar. Pick the calendar, choose “Can view all details”, publish, and copy the ICS link.
And Apple Calendar (iCloud)?
In Calendar, share the calendar and tick “Public Calendar”, then copy the link (it starts with webcal://). Paste it as it is.
How quickly do changes show up?
The block reads the calendar at most once an hour, so a change can take up to an hour to appear. Google itself can take a while to update its public feed after you edit an event.
Which repeating events are supported?
Daily, weekly (on one or several days), monthly on a date or on a weekday position (“second Tuesday”, “last Friday”, “first and third Friday”), yearly, every N days/weeks/months, a number of times or until a date, skipped dates, and moved or cancelled single dates. A rule outside that (for example several times a day by hour) shows its first date rather than guessing.
Which time zone are times shown in?
Your site’s time zone (Settings → General). An all-day event stays on its date wherever the site is.
If you switch on “Show times in the visitor’s time zone”, a visitor whose clock is in another zone sees each time converted, with the zone’s name, and a line saying so. The month grid keeps each event on its day in your site’s calendar; when the visitor’s time falls on another day, the cell says which (“Wed 10:30 AM”).
Can one block show more than one calendar?
Yes, up to five. In the block’s sidebar, click “Add another calendar”, paste its address, and pick a colour. Give each one a name and a key appears above the events. If one calendar can’t be read, the others still show (and people who can edit the page are told which one failed).
My host flushes its object cache a lot. Does the calendar still work when Google is down?
Yes. The hour-long copy is a transient, which a persistent object cache may drop early; that only means the calendar is read again a bit sooner. The last good copy is stored as a normal (not autoloaded) option, so a cache flush can’t remove it, and it is shown for up to 30 days while the calendar address doesn’t answer.
Does it contact Google when a visitor opens the page?
No. Your server reads the calendar address and keeps a copy for an hour. Visitors’ browsers load nothing from the calendar host.
Is there a settings page?
No. Everything is in the block’s sidebar, so each block can show a different calendar.
Screenshots
Changelog
0.3.0
- The “Add to calendar” links now include Outlook.com and Microsoft 365 (work or school accounts) next to Google Calendar and the .ics file, and the Subscribe links add the whole calendar to Outlook.com or Microsoft 365 too.
0.2.0
- Up to five calendars in one block, each with its own colour, and a key when they have names.
- Optional “Add to calendar” links on each event (Google Calendar, or an .ics file for Apple Calendar and Outlook) and Subscribe links for the whole calendar.
- Optional: show times in each visitor’s own time zone, for online events.
- The last good copy of a calendar is now kept as an option, so a flushed object cache can’t take it away while the calendar host is down. It is used for up to 30 days.
- Thanks to MartinWolf_ on Reddit, who asked for all four.
0.1.1
- The plugin’s name now says which calendars it shows (Google Calendar, Outlook, iCal). No code changes.
0.1.0
- First release: the Calendar Feed block with list and month views.


