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.
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
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
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
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.
Sharing takes two steps:
- A calendar Admin gives people access on the Permissions tab.
- 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)
-
Open the calendar menu (pencil icon) and choose Edit, then open the Permissions tab.
-
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.
-
The new entry gets Use access. To change it, click the colored access label — see below. Repeat to add more people.
-
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
-
Click Add calendars and choose Add existing.
-
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.
-
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
Next Steps
- Custom Events — create and manage custom events with types, recurrence, and reminders
- Permissions — permission levels and how project roles work
- Export & Import — download calendar events as PDF or Excel reports
Need Help?
If you have questions about creating or managing calendars, contact our support team.
Contact Support