Calendar Feed (ICS)

Eventonomy generates ICS calendar files that visitors can download or subscribe to. This lets people add individual events (or a live, auto-updating feed of all events) to Apple Calendar, Google Calendar, Outlook, and any other calendar app that supports the ICS format.

What You Will Learn

• How to enable the calendar feed
• How the per-event download works
• How the subscribable live feed works
• Which URL formats Eventonomy provides

Enabling the Calendar Feed

Go to Eventonomy → Settings → Connections → Calendar feed and:

1. Toggle Calendar feed on.
2. Enable calendar downloads and the subscribable feed.
3. Enable Show “Add to calendar” on single events to show the download buttons.

Save changes.

Per-Event Download

On any single event page, an Add to calendar row gives visitors three one-tap options:

• Google - opens Google Calendar’s add-event page, pre-filled.
• Outlook - the same for Outlook on the web.
• Apple / .ics - downloads the .ics file, which Apple Calendar and any other desktop calendar app will open.

For a recurring event the file carries a single event with a repeat rule, rather than one entry per date, so the visitor’s calendar shows the series the way their own app draws series.

Direct ICS URL

Each event has a direct ICS download URL:

GET /wp-json/eventonomy/v1/events/{id}.ics

It returns the event with its active occurrences; dates you have cancelled are left out.

Subscribable Live Feed

The subscribable feed is a live URL that calendar apps poll to stay up to date. As you add or update events, subscribed calendars see the changes automatically.

Feed URL

/wp-json/eventonomy/v1/calendar.ics

What the Feed Contains

One feed, covering the whole site: published, public events that still have an upcoming date. Cancelled dates are excluded, and an event whose dates have all passed drops out on its own, so subscribers never accumulate finished events.

The feed takes no parameters - there is no category-scoped or organizer-scoped variant, and no per-member feed. If you need one, the /calendar.ics endpoint is a good starting point to build from; see the REST API Reference.

Every upcoming public event is included, not only the first 100. A repeating event lists every upcoming date at its exact local time, including across daylight-saving changes, and cancelled dates drop out.

Very large sites have a ceiling. To stop a calendar app pulling an unbounded export, the feed stops after 5,000 upcoming dates, nearest first, so the farthest dates drop off rather than a whole near-term event. Developers can change the limit with the evnm_calendar_feed_max_occurrences filter.

Subscribing in Calendar Apps

Use the webcal:// URL scheme to subscribe:

webcal://yoursite.com/wp-json/eventonomy/v1/calendar.ics

In Google Calendar, use Other calendars → From URL and paste the https:// version of the feed URL.

What’s Next?

Learn about maps and the Pro Week/Day calendar views.

Maps & Week/Day →