Sync Jira issues to your calendar

This app will help you to sync Jira issues directly to your any calendar.

Screenshot 2024-10-10 at 13.11.27.png
Create Personal and Shared Subscriptions to generate user-tailored Calendars. Use Global Subscriptions for internal and external stakeholders.

 

Screenshot 2024-10-10 at 13.13.51.png
ICS Calendar subscriptions are supported by all major Calendar providers such as Google Workspace / Google Calendar / Microsoft Outlook / Microsoft 365 and many more.

 

Table of Contents

Install the App from the Atlassian Marketplace

You can install the App from the Atlassian Marketplace → Easy Calendar Integration for Jira

Create the first calendar subscription

After installing the App you can find it in these locations:

In the Jira Top Menu.

When creating a subscription you can choose between personal, shared and global subscriptions.

  • Personal subscriptions can use use-tailored functions and filters and are great to sync your own Jira issues to any calendar. These could be issues assigned to you, created by you, your starred issues, or any advanced JQL filter such as watcher = currentUser().

  • Shared subscription are like personal subscriptions, but they can be shared with other users, and will generate a user-tailored calendar view for each users. For example, each subscriber can see issues assigned to them.

  • Global subscriptions are intended for calendars which will look the same for every users. Intended for both team members and external shareholders. You could share Planned Maintenances, Upcoming Releases, Recently Completed Epics.

 

Personal Subscription

Shared Subscription new

Global Subscription

Personal Subscription

Shared Subscription new

Global Subscription

  • Great for syncing relevant Jira issues to your personal calendar

  • Can use user-tailored functions such as “my starred issues”, “issues created by me”, or assignee = currentUser().

  • 🔓 Automatically deactivated when the user is deactivated

  • Great for Admins to make one configuration and share a user-tailored subscription with each user, or directly distribute the link to each user

  • Avoids that each user needs to create their personal own subscription

  • 🔓 Can be manually deactivated per user by Owner and Admins

  • Great for calendar subscriptions which do not contain any personal data or confident information

  • Can be shared inside and outside your organisation

  • Cannot use user-tailored functions such as assignee = currentUser()

  • 🔓 Can be manually deactivated globally by Owner and Admins

Subscribe to Jira issues


From the Easy Calendar for Jira overview page, you can see all your calendar subscriptions and find the subscription URL.

You can edit your subscriptions and also create completely new subscriptions.


 

How to add the Calendar Subscription to your Calendar

The app uses ICS Links to sync issues and releases to your calendar. This Standard Format is not as good and real time as API integration but it will work for many uses cases. Stay tuned for the future and let us know your needs.

  1. Click on View/Subscribe

  1. Copy the Subscription URL

 

  1. Paste the URL into your Calendar (to Google Calendar, Microsoft 365, Apple Calendar or any other Calendar supporting iCal/ICS subscriptions)

Example with Google Calendar:

That’s it!

Configuration options and custom fields

On what date do you want the issue to show up? You can choose any system date, datetime field such as “due date”, “start date”, or any customer field of type date or type datetime.

 

Configuration options

  • Subscription name: Used to easily indentify the subscription, and default calendar name

  • Subscribe to: Filter(s) to use. Filters are combined in OR. If you add multiple filters, then all issues from all filters are considered.

  • Projects: Additional project filter. Regardless of the filters defined, only issues from the selected projects are included in the subscription. Leave empty for “All Projects”

  • Start date field: The field to use as start date, or start date time. Optional, use “Do not use a start date” if you don’t want to use a start date.

  • End date / Due date field: The field to use as end date. If the issue only has an end date then the issue will be a full day event on the end date. If the issue only has an end date time, it will be added as 15 minute event on the calendar, ending on the time defined.

  • Note that if you want to use time fields, then both fields should be datetime, otherwise only the date portion of the field will be used, and the events will be all day events.

  • Options

    • Include issue description: Wheter or not to include the issue description. The description will be added as text, and with basic html formatting. Not all calendar support html formatting.

    • Show issues without due date as due today: If any issue returned from the defined filter, does not have a due date, then this option will allow you to show the issue as due today. Useful for reminders.

    • Show done issues on their resolution date: Check this option if you want that done issues should be shown on the resolution date as full day events (if they are in the status category ‘done’, and have a resolution date).

  • Visibility: Define if your subscription should be global, shared, or personal (see comparison above).

 

Using Jira Filters

You can choose from built-in Jira filters or use/create your own Jira filters.

If your filter is not in the list make sure the filter is shared with your organisation, or if your filter is private, you need to add the user “Easy Calendar for Jira” explicitly. Here’s how to share the filter:

The subscribe issues have an emoji status: 🚧 = in progress, ✅ = done, 🔹= to do, 🚩= flagged issue

If new issues are added to your calendar subscriptions, they won’t show up immediately. Some calendars allow to configure the refresh-interval like 15 minutes, others can take up to 24hours or more. Check our FAQs for details.

Subscribe to project releases/versions

See Sync Jira releases to your calendar

Deep Dive

Bring it all together

Subscribe to hand-picked issues, all your assigned issues, and releases

You can also sync Confluence Tasks to your Calendar: Check out the App Task Reports for Jira

Need Support? Reach out to us https://meetical.io/support