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
- How to scope a feed to a category or organizer
Enabling the Calendar Feed
Go to Eventonomy → Settings → Integrations → Calendar feed and:
- Toggle Calendar feed on.
- Enable calendar downloads and the subscribable feed.
- Enable Show "Add to calendar" on single events to show the download buttons.
Save changes.
Per-Event Download
On any single event page, the "Add to calendar" button offers a dropdown with links for popular calendar apps. Clicking a link downloads a .ics file (or opens the app's web-based add flow).
For recurring events, the download includes one VEVENT component per occurrence or a single VEVENT with an RRULE, depending on the evnm_ics_use_rrule filter (default: use RRULE).
Direct ICS URL
Each event has a direct ICS download URL:
GET /wp-json/eventonomy/v1/events/{id}.ics
To download only a specific occurrence of a recurring event:
GET /wp-json/eventonomy/v1/events/{id}.ics?occurrence_id=9921
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
Filtering the Feed
| Parameter | Example | Effect |
|---|---|---|
from |
from=2026-07-01 |
Only events starting on or after this date |
to |
to=2026-12-31 |
Only events starting on or before this date |
category |
category=meetup |
Only events in this category (slug or ID) |
organizer |
organizer=5 |
Only events by this organizer ID |
venue |
venue=downtown-hub |
Only events at this venue |
Example - a category-scoped feed for meetups:
/wp-json/eventonomy/v1/calendar.ics?category=meetup&from=2026-01-01
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.
Personal Feed (RSVPs)
Note: A personal feed scoped to a user's RSVP'd events can be generated with a
?token=parameter via the magic-link/session mechanism. This is primarily a developer-facing feature. See the REST API Reference for details.
What's Next?
Learn about maps and the Pro Week/Day calendar views.