Eventonomy

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.

Single event page showing the "Add to calendar" dropdown with Apple, Google, and Outlook options

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 → Integrations → 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.

The feed carries up to 100 events. That is a deliberate ceiling so a calendar app polling your site cannot pull an unbounded export. Sites running more than 100 upcoming events at once should point subscribers at the events page rather than the feed.

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 →