Adding Calendars Back to top

Click Add calendars at the top of the page and choose:

  • Create calendar — set up a new calendar. See Creating a calendar.
  • Add existing — add a calendar that someone has shared with you. Nothing is copied; the calendar simply appears in your list. See Adding a shared calendar.

Creating a Calendar Back to top

The Create calendar dialog has four tabs. Only the name is required — you can change everything later with Edit in the calendar menu.

1. General

Create Calendar dialog — General tab with name, description, and color fields

Give the calendar a name, an optional description and a color. The color marks this calendar's events everywhere; the Preview shows how it will look in your list.

2. Events source

Create Calendar dialog — Events Source tab with source type, project selector, and date field mapping

Choose what the calendar shows:

  • Basic — only events you add yourself, no Jira issues. Good for team schedules, holidays or company events.
  • Project — Jira issues from one or more projects.
  • JQL — Jira issues matching a JQL query, for full control over which issues appear.
  • Filter — Jira issues from a saved Jira filter.

For Jira issues, pick which date places an issue on the calendar: the Start date field (required) and an optional End date field — for example the due date, sprint dates or a custom date field. Under Display options you can show each issue's status and assignee on the calendar.

3. Event types

Create Calendar dialog — Event Types tab with timezone setting and event type list

Event types are the categories people choose from when they add an event (for example Event, Meeting, Holiday, Travel). Click + Create to add one; each type can have its own reminder.

The timezone decides which timezone a time typed into a new event is in. Leave it empty to use each person's own Jira timezone.

4. Permissions

Decide who can see and use the calendar. As the creator you are always its Admin. Everything about this tab is explained in Sharing a calendar below.

Your Calendar List Back to top

Calendar sidebar showing list of calendars with color indicators, info and edit buttons

The list on the left shows the calendars you have added. For each one you can:

  • Show or hide it — click the colored box next to its name. A hidden calendar stays in your list; its events are just not shown.
  • Open its menu — click the pencil icon next to its name.

Use the ‹ button at the top of the list to collapse it and give the calendar more room.

The calendar menu

Calendar dropdown menu showing New event, Issues list, Configure quick filter, Edit, Delete, Remove from favorite, Copy calendar URL, and Export Settings options

Which items you see depends on your access level:

  • New event — add an event to this calendar.
  • Issues list — see the calendar's Jira issues as a list.
  • Quick filters — narrow what is shown, for example by assignee, status or priority.
  • Edit — change any of the calendar's settings (the same four tabs as when creating it).
  • Delete — delete the calendar and its events for everyone. Jira issues are not affected.
  • Remove from favorites — remove the calendar from your list only. It is not deleted, nobody else is affected, and you can add it back with Add existing.
  • Copy calendar URL — copy a link that opens this calendar.
  • Export settings — set up exports for this calendar. Shown only to its Admins, and only when exports are enabled by a Jira administrator.

Sharing a Calendar Back to top

Sharing takes two steps:

  1. A calendar Admin gives people access on the Permissions tab.
  2. Each person adds the calendar to their own list with Add calendars → Add existing.
Giving access does not put the calendar in anyone's list, and nobody is notified. After sharing, let people know they can add it with Add existing.

Access levels

Each person, group or project role on the list gets one of three levels:

Access level What they can do
Admin Everything:
  • Change the calendar's settings, event types and reminders
  • Decide who has access
  • Add, edit, move and delete events
  • Delete the calendar
Use Work with events, but not with settings:
  • Add, edit, move, resize and delete events
  • Cannot change settings or access, or delete the calendar
Read Only Look only:
  • See all events
  • Cannot add or change anything — New event is not offered
  • The creator is always an Admin, marked Owner in the list. This cannot be lowered or removed.
  • People who are not covered by any entry cannot see the calendar at all — it is not offered to them in Add existing.
  • If someone is covered by several entries (for example by name and through a group), the highest level applies.
Access levels apply to the events added in the calendar. Jira issues shown on a calendar always follow each person's own Jira permissions — a calendar never shows anyone an issue they could not open in Jira.

Step 1 — Give access (Admin)

Permissions tab showing the Users and groups field, the Project role selector and the access list with access lozenges
  1. Open the calendar menu (pencil icon) and choose Edit, then open the Permissions tab.
  2. Choose who gets access — either:
    • Users and groups — type a name, email or group name and select it, or
    • Project role — select a project, then one of its roles (for example Developers), and click Add role. Everyone with that role in that project gets access — see how project roles work.
  3. The new entry gets Use access. To change it, click the colored access label — see below. Repeat to add more people.
  4. Click Save.
Users, groups or project roles — which to use?
  • A group for a whole company or department (for example a "Company Holidays" calendar for all-staff).
  • A project role for a project team (for example the Developers of one project) — access follows people as they join or leave the role in Jira.
  • A single user for exceptions (for example Read Only for one stakeholder).

Changing or removing access

In the Permissions tab, each entry shows its level as a colored label (amber = Admin, green = Use, grey = Read Only).

  • Change the level — click the label. Each click moves to the next level: Admin → Use → Read Only → Admin.
  • Remove an entry — click the × at the end of its row.

Click Save to apply. Close the dialog without saving to discard your changes.

Step 2 — Adding a shared calendar

  1. Click Add calendars and choose Add existing.
  2. The list shows every calendar you have access to that is not in your list yet. Users shows how many people have added it. Use the search box to find one by name.
  3. Tick one or more calendars and click Add. They appear in your list right away, with the access level you were given.

When access is removed

If an Admin removes your access, the calendar stays in your list but is greyed out under No permission and its events are no longer shown. Use Remove from favorites in its menu to clear it from your list. You are not notified, so Admins should tell people directly.

A Jira administrator can limit the whole app to certain Jira groups in Admin Configuration. People outside those groups cannot open the app at all, whatever a calendar's permissions say.
Back to top

Need Help?

If you have questions about creating or managing calendars, contact our support team.

Contact Support