Add Jira Events

Jira events enable you to visualize versions, issues or sprint dates from Jira applications. To use this feature, Confluence and Jira need to be connected by an application link. If, after connecting Confluence to Jira you're still not able to add Jira events to a Team Calendar, make sure the Jira iCalendar Plugin is enabled in your JIRA site.  This is bundled with Jira, but may have been disabled by an administrator.

Add JIRA events

When you create an event, there are multiple JIRA event types you can choose from. These are:

  • JIRA Issue Dates – Embed a single JIRA issue date or the duration between any two issue dates. For example, embed due dates for JIRA issues, or, if you have custom fields, embed a scheduled deployment date.
    What if you want to see the duration for a particular issue? You may have fields like 'Deployment Start Date' and 'Deployment End Date' or 'Issue Start' and 'Issue End Date'. Team Calendars allows you to visualize the duration between any two dates.

On this page:

Related pages:

  • JIRA Software Sprints – If your team is using JIRA Software to plan their work, you can also embed your Sprints inside your Team Calendar. This helps you see the duration of your sprint and how your team's availability or other team events could impact the sprint.
  • JIRA Project Releases – JIRA versions help you define a release for your projects. You can embed and visualize your JIRA project versions to see how your releases are progressing.

Update JIRA events in Team Calendars 

From Team Calendars, you can:

  • Update JIRA project version dates
  • Update Issue dates 

Drag-and-drop the event or update its date, and it will automatically update in your JIRA application. Currently, you can't update your JIRA Software sprint dates.

Add JIRA issue dates

You can embed virtually any issue date in Team Calendars from your JIRA application. Embed JIRA issue dates as:

  • A single date 
  • A duration between two specified dates

When adding JIRA issue dates, you'll be presented with the following display options:

  • Project – A quick and easy way to map out project issues on a calendar
  • Saved filter – For more advanced filtering as well as support for multiple projects.
  • JQL – Power users can use JQL to create a JIRA calendar.

If you select Saved filter or JQL, Team Calendars will render all available date fields that are available for all projects selected in your filter. If there are dates that are only available to one project, and not another in the filter, they will not render in the list of possible fields to show.


Upon selecting a Project, Saved Filter or JQL, you'll be presented with all possible dates that can be rendered in Team Calendars. For those of you with Jira Software, Team Calendars can also embed your JIRA Software sprint durations right on your JIRA Calendars.

Once you've entered a JQL query, choose the dates you'd like to display in Team Calendars. 

Once the calendar is created, depending on what you've selected, you can see:

  • Issue dates
  • JIRA project version due dates
  • JIRA Software sprint durations 

Examples:

Issue dates

Project release  (shows release date)

Software sprint (shows start and end dates)

Notes

  • You can't add content to JIRA calendars as they source all of their date information from the JIRA system. To add issues and version deadlines, add them in the JIRA application's interface.
  • You can drag-and-drop your JIRA issue dates and project versions to re-schedule them right from Team Calendars.
  • When you create a JIRA calendar, all users in your system can see the calendar name in Confluence. The actual calendar events (issues, versions, sprints), however, automatically respect your JIRA application permissions, so it's possible for users to be subscribed to a JIRA calendar and not see all events.
  • In order to make sure calendars load quickly, JIRA events are cached. You can configure the cache expiry (time to live) in Team Calendars > Global settings - decrease the cache expiry time for more accuracy.

Team Calendars for Confluence is now part of Confluence Data Center
To get access to the features described on this page upgrade to Confluence Data Center 7.11 or later. Can’t upgrade yet? Depending on your current Data Center version, you can access these features by installing the latest version of the app (
at no cost). See our FAQ for all the details

Last modified on Dec 7, 2023

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.