Calendar Integration

FlareBuilder can export any event content as a standards-compliant ICS calendar feed. This is platform-agnostic — it works the same way whether your site is on Webflow, WordPress, Google Sites, or nowhere at all (a subscription doesn’t require a website).

Note

ICS feeds must be enabled per-organization first: a tenant admin turns it on under Settings. Requests to ?format=ics return 403 until it’s enabled.

How It Works

Add ?format=ics to any Feed API URL to get an .ics file instead of JSON. Only content with an event start date populated (via the template’s _event_start index — see Filtering and Search Indexes) appears as a calendar event; everything else is silently excluded.

https://your-org.flarebuilder.com/feed?format=ics

All the normal Feed API filters apply — scope the calendar to a single template, tag, or date range:

# Only "Event" template content
https://your-org.flarebuilder.com/feed?format=ics&templates=event

# Only items tagged "public"
https://your-org.flarebuilder.com/feed?format=ics&tags=public

# A private, unlisted channel's events (token resolves the channel — no channel name in the URL)
https://your-org.flarebuilder.com/feed?format=ics&token=fb_ch_abcd1234efgh

Tip

ICS feeds are not paginated — a single request returns every matching event, since that’s what calendar apps expect from a subscription URL.

Subscribing

Sharing a live, always-up-to-date calendar is as simple as sharing the ICS URL — no embedding required.

Google Calendar

1. Open Google Calendar.
2. Next to Other calendars, click + → From URL.
3. Paste your ICS feed URL and click Add calendar.

Google Calendar polls subscribed URLs roughly every 12–24 hours — it isn’t instant, but the source stays FlareBuilder, so every viewer always sees the current schedule.

Outlook

1. In Outlook (web or desktop), go to Add calendar → Subscribe from web.
2. Paste your ICS feed URL.
3. Give it a name and click Import.

Apple Calendar

1. In Calendar, choose File → New Calendar Subscription.
2. Paste your ICS feed URL and click Subscribe.
3. Set the auto-refresh frequency (Apple defaults to every hour).

Embedding a Live Calendar on Your Site

The most reliable way to show a visual calendar grid on a webpage — rather than a list of events — is to subscribe a Google Calendar to your ICS feed (above), then embed that Google Calendar. Google’s embed code works on virtually every site builder, including ones that don’t allow arbitrary JavaScript.

1. Subscribe a Google Calendar to your FlareBuilder ICS feed (see the Google Calendar tab above). Consider using a dedicated Google account or a secondary calendar so it doesn’t mix with personal events.
2. In Google Calendar, open that calendar’s Settings and sharing.
3. Make sure Access permissions includes “Make available to public” if you want it visible to anonymous visitors.
4. Scroll to Integrate calendar and copy the Embed code.
5. Paste the <iframe> snippet into your site — a Custom HTML / Embed block on most site builders, or directly in a template on framework-based sites.

<iframe
  src="https://calendar.google.com/calendar/embed?src=your-calendar-id%40group.calendar.google.com"
  style="border: 0" width="800" height="600" frameborder="0" scrolling="no">
</iframe>

Caution

This path has an inherent lag from two hops: FlareBuilder → Google Calendar’s polling interval (up to ~24h) → the embedded iframe. For a calendar that reflects publishes within minutes, use the embed widget or a direct Feed API fetch (filtered to your event template) instead of the Google Calendar round-trip — those read /feed directly, with the same caching as the rest of the Feed API (edge cache up to 15 minutes).

A List of Upcoming Events Instead

If you want a list rather than a calendar grid, skip ICS entirely and use the embed widget filtered to your event template and sorted by date:

<script type="module" src="https://flarebuilder.com/widget/v1/flare-feed.min.js"></script>

<flare-feed
  src="https://your-org.flarebuilder.com/feed?templates=event&event_start=2026-01-01T00:00:00"
  show-date
  show-image
></flare-feed>

See Template Field Mapping to map the event’s start/end date and location fields onto the widget’s built-in event slots.