Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

...

Table of contents

Table of Contents
minLevel1
maxLevel6
include
outlinefalse
indent
styledefault
exclude
typelist
class
printablefalse

Is this app free?

This app is free for Jira instances with up to 10 total licensed users. The paid app version 3.x was released . Please read the official announcement for further details.

In Outlook I get the error "Couldn't import calendar. Try again later." - How can I fix it?

Make sure you have the latest version of the app. The app should warn you internally if the subscription takes too long to generate and Outlook runs into a timeout.

  • Try to narrow down your Jira filter so it returns only relevant issues

  • Uncheck the option “show issues without due date as due today” if you don’t need it

  • Try to exclude resolved issues or older resolved issues (e.g. exclude all resolved issues with resolutiondate is empty or issues resolved 2 months in the past by adding this JQL (resolutiondate is empty OR resolutiondate >= startOfMonth(-2))

Can I change the due date to another field?

Yes, you can choose any date or datetime field. Both system and custom fields are supported.

  • Per default, the app

...

  • will use the standard

...

  • ‘due date’ and the

...

  • ‘start date’ field.

Can I set an additional time?

Yes, we added datetime field support. Thanks for your votes on this feature. Please reach out to us for any questions or feature requests.

My custom Jira filter is missing in the dropdown list. How can I add it?

You need to share the filter with the App.

  • Go to your filter,

  • click on “Details” → “Permissions”

  • and either share the filter with your organization, or add the user “Easy Calendar”.

  • Then refresh the configuration screen and your filter should be in the list.

What emoji statuses exist and how are they mapped?

The status of an issue is mapped according to this logic, using the associated status category. Note that this is not the actual status, but a category “todo”, “in progress”, or “done” associated with the status (Ask our support or your Admin for more info).

🔷 default

🚩 issue is flagged

🚧 in progress (status category)

done (status category) - if a resolution date is set, the issue date on the calendar = resolution date

🔔 due today

...

  • When creating meeting events from the issue side panel, you can also specify the date/time fields to use. Note that this setting is currently saved per-user. Let us know your feedback if you need more fine-granular control.

How long does it take to sync my tasks/issues/releases to Outlook, Apple or Google Calendar?

Most calendars allow you to set a refresh interval appropriate for your use case from 5 minutes to weekly refresh. However, ics is not designed to sync immediately. Reach out to us there are some open source libraries which can help you to turn ics into almost real-time sync, and we have the feature idea on our roadmapGoogle and Microsoft calendars can take up to several hours (see below for details). Check our roadmap and let us know if you need real-time sync.

On Apple Calendar right click the subscribed calendar, then Get Info → Refresh interval. And you can manually refresh by using the keyboard shortcut “command + r” (could take up to 30 seconds).

...

Expand
titleAdditional info for testing your feeds on Google Calendar

Please note that some users report that the calendar is not updating manually, even after adding removing it. Seems like Google is caching this data.

To work around this, try to add a random parameter at the end of the subscription URL like &nocache=1245.

For example: https://cc6e087a-85df-461e-b4ad-e2384c636ba4.hello.atlassian-dev.net/x1/LL_NgglPkYTmNr3RQ?sid=OxYveyTWx6TqafRR3BFuDW8ZFMOj4R3k&nocache=1234

Reach out to us, and vote for API integration, with push updates in real-time, maybe we can build that in the future.

My starred issues are missing on my calendar

Make sure your subscription includes the “my starred issues” filter. “All issues” does currently not include them. Go to Jira Top Menu “Apps” → Easy Calendar → Edit your Subscription

...

After you change the subscription, it could take some time to see the updates (see questions above)

Can I set an additional time?

Yes, we added datetime field support. Thanks for your votes on this feature. Please reach out to us for any questions or feature requests.

Can I share subscriptions with internal and external shareholders?

Yes, you can create both personal and global calendar subscriptions (docs). While personal subscriptions are intended to have one separate private link for every user, global subscriptions are designed with the intention to allow sharing the subscriptions with internal colleagues, external stakeholders and even public calendars.

My custom Jira filter is missing in the dropdown list. How can I add it?

You need to share the filter with the App.

  • Go to your filter,

  • click on “Details” → “Permissions”

  • and either share the filter with your organization, or add the user “Easy Calendar”.

  • Then refresh the configuration screen and your filter should be in the list.

How can I use Jira Dashboard Gadgets with Easy Calendar subscriptions?

We are currently evaluating if we build dedicated Jira Dashboard Gadgets to be included in the app. Please reach out to support for instructions on how to use existing 3rd party Gadgets.

What emoji statuses exist and how are they mapped?

The status of an issue is mapped according to this logic, using the associated status category. Note that this is not the actual status, but a category “todo”, “in progress”, or “done” associated with the status (Ask our support or your Admin for more info).

🔷 default

🚩 issue is flagged

🚧 in progress (status category)

done (status category) - if a resolution date is set, the issue date on the calendar = resolution date

🔔 due today

🚨 overdue

Not all of my releases are shown in my release/version subscription

If any release is missing, check that the release has a start date, this is currently required. Also note that new and changed releases might not immediately appear as outlined in the FAQ about “how long does it take to sync my tasks/releases”.

Why do my issues appear as due today?

Issues without any due date are treated as due today. If they are in the status category

Status
colourGreen
titledone
then the resolution date is used.

How much does Easy Calendar Integration cost?

This app is currently free! 🎉 We might add more features and charge for the app in the future. Existing users will need to confirm this upgrade explicitly, can stay on the free version, or will be eligible for discounts.

Can I add an alert/reminder?

You might be able to configure default reminders for all issues on your calendar. But custom alerts are not supported at the moment. During our tests, only Apple Calendar supports reminders and alerts via subscription URLs. Both Google and Microsoft do ignore the alerts. Reach out to us if you are interested in this feature.

I get an error subscribing to the calendar

Errors like “There was an error subscribing to the calendar.” are annoying. Sorry for that. “The data downloaded from … isn’t valid.”

...