External calendars or ICS-subscriptions

A powerful feature of the Calendar for Jira app is its ability to integrate with external calendars through iCal (ICS) subscriptions. When you obtain an ICS link from platforms like Google Calendar or the Outlook on the Web and subscribe to it within our app, you're creating a live connection.

This means that any changes, additions, or deletions made to the original calendar (whether in Google or Outlook) will be automatically reflected in your calendars. This ensures your team always has the most up-to-date information on external events, such as industry conferences, public holidays, or shared team schedules, without manual intervention.

Instructions
  1. Open your browser and head to Google Calendar.

  2. Navigate to the Settings (usually found in the top-right corner of your screen).

ExC-1.gif
External calendars - Google calendar settings
  1. In the sidebar on the left side of the screen, navigate to the settings of the calendar you wish to export in the Settings for my calendars section.

ExC-2.png
Google Calendar - Settings
After we clicked the IT events demo in the settings, a list of sub-settings for the Google calendar opened. We go to Integrate calendar.
Google Calendar - Settings for my calendars
  1. From there, head to Integrate calendar section.

Integration settings of the Google calendar - various links to implement the calendar into web pages and applications are listed here.
Google Calendar - Integration settings
  1. Copy the link from Public address in iCal format.

Note: The calendar must be public for this address to work in our Calendar for Jira App (and anywhere else). To make it public, head to Access permissions for events section of the calendar’s settings and allow public access.

Access permissions for events settings of Google Calendar - a checkbox to make it public.
Google Calendar - Access permissions for events


Once you have your link, head back to our Calendar for Jira app!

Instructions
  1. Open your browser and head to Outlook.

  2. Navigate to Settings in the top right corner of your screen (usually in the blue ribbon, right next to your profile icon):

Clicking settings in the top right screen of Outlook in the Web window - gif.
External calendar - Outlook calendar settings
  1. In the opened window head over to Calendar settings, then Shared calendars.

In main settings a chosen option is Calendar, in the Calendar settings - Shared calendars.
Outlook calendar - Settings
  1. On the right side of the settings menu, locate Publish a calendar section.

In the shared calendar settings Publish a calendar section is highligh
Outlook calendar - Publishing a calendar
  1. From the first dropdown menu Select a calendar, choose the specific calendar you want to publish.

  2. From the second dropdown menu Select permissions, choose how much detail you want to share.

ExC-9.png
Outlook calendar - Publishing settings


  1. Click the Publish button.

  2. Upon publishing, two links will appear: HTML and ICS. Copy the ICS-link:

ExC-10.png
Outlook calendar - Obtaining a link

Once you have your link, head back to our Calendar for Jira app!

Let us know what other external sources you would like to receive the explanation on how to retrieve a calendar in iCal format!

How to attach an external calendar to our Calendar for Jira

Once you’ve obtained the iCal (ICS) subscription link of the calendar you’d like to display in your internal calendar, follow these steps:

  1. Open the internal calendar to which you would like to add the external information.

  2. Open the Settings of this calendar in the bottom of the sidebar.

ExC-11.gif
External calendar - Settings
  1. Navigate to External calendars tab in the settings.

ExC-12.png
External calendars - Settings

4. In External calendars, configure your future external calendar: pick a color, give it a name, and provide the ICS-subscription link you’ve obtained earlier.

ExC-13.png
External calendars - Attaching the obtained link
  1. Click + add buttonthe calendar then will be moved to the list of external calendars underneath.

ExC-14.png
External calendars - Multiple external calendars attached
  1. Click Save the tab settings.

After you follow these steps, the external calendar should appear in the Calendars menu of the sidebar, beneath your internal calendars.

ExC-15.png
External calendar - Accessing the external calendars on the sidebar

To activate it, check the box to the left of its name. To deactivate it—uncheck it.

How to delete an external calendar

If you would like to delete the external calendar, again head to the External calendars tab of the settings of your internal calendar.

In there, to the right of the calendar’s link is the delete button—click it, then confirm your changes by clicking the Save tab settings button.

ExC-16.png
External calendar - Deleting the calendar