Skip to main content

Global Calendar Feed

Learn how to get a calendar feed (a.k.a. iCalendar, iCal, ICS) of all upcoming events on your PlusPlus instance

Chris Ramlow avatar
Written by Chris Ramlow
Updated over 2 weeks ago

Problem

You are an admin of PlusPlus and you want to get a global feed of your upcoming events.

Solution

You can download an iCalendar-based feed (a.k.a. iCal or ICS) of all upcoming events on your PlusPlus instance, or you could subscribe to it via your calendar application.

Step 1: Head over to Menu > Settings > Integrations > Calendar

Step 2: Scroll to iCalendar > Download ICS File

Step 3: Subscribe to or one-time download the contents of this URL.

Discussion

iCalendar (also known as iCal and ICS) is a calendar interchange format designed for interoperability between various calendaring systems. You can download .ics files, upload them to nearly every calendar service, or directly subscribe to them. The last option causes your calendar client to periodically refresh the calendar events so they are always kept up-to-date.

The ICal feed URL is a global feed that contains all events your PlusPlus instance has, apart from group-restricted and hidden events. This feed may be useful to help drive discoverability of your events in other places (e.g. to embed in your corporate Wiki).

Keep in mind that this URL does not require authentication (it already embeds a secret) so be careful not to leak it outside of your organization. In case you need to change the secret key please contact support.

Filter the Global Calendar Feed by Topic

You can customize your global iCal URL to include only events associated with a specific tag by adding a topics parameter to the feed URL. This is useful if you want to create calendar views for particular teams, departments, or themes.

Example URL format:

https://yourdomain.plusplus.app/events/public.ics?secret=YOUR_SECRET&topics=engineering

How it works:

  • Replace engineering with the lowercase name of your desired tag.

  • This filter only applies to public events.

  • The secret parameter is automatically included when you retrieve the iCal URL from Settings > Integrations > Calendar.

  • You can filter to multiple topics by repeating the topics parameter
    ​topics=engineering&topics=bootcamp

This feature allows you to create focused calendar subscriptions for specific groups without exposing unrelated events.

See Also

Did this answer your question?