Calendar Sync for Jira on Forge
Overview
Calendar Sync for Jira generates iCalendar feeds from Jira work items.
It is easy to use and flexible to configure, with access control that follows the groups and project roles you already have in Jira. The feeds it produces can be imported into any application that supports iCalendar, and they keep pace with your Jira data - as work items change, the calendars change with them.
Calendar Sync for Jira never modifies anything in Jira. It only reads.
How does it work?
You create one or more feeds. A feed is a query plus a set of rules that together decide:
which work items appear in the calendar - a JQL query, or a saved Jira filter
when each event happens - which date fields on the work item become the event's start and end, whether it is an all-day event, and in which timezone it should be read
what each event says - which fields and static text make up the event summary and description
who can see the calendar - everyone, named groups, or people holding named project roles.
Each feed produces one calendar with its own unique address, a URL, and that address is where calendar applications collect their data.
The URL does not require a sign-in, because most calendar applications cannot sign in. It is impossible to guess, and it always travels over HTTPS. This is the same approach used to share calendars across the web, generally. See Security for the details, and treat a calendar URL as you would a password.
How often the data refreshes
What | How often |
|---|---|
The app checks for feeds that are due to be rebuilt | Every hour |
Each feed is rebuilt | Every 12 hours |
When you create a new feed or save a change to an existing one, it is queued for rebuilding straight away - so in practice, a new feed becomes available within about an hour. The app states this on the feeds page itself:
Your calendar application then collects the data on its own schedule, which is usually slower still and is not something Calendar Sync for Jira can influence. See Calendar updates.
Next steps
Installation and licensing
Configuration - build your first feed
Using the Calendars - subscribe to a calendar