Hosting: Jira Cloud
A calendar of type Board shows three things from one Jira Software board: its issues, its sprints and the versions of its projects. You do not write JQL for it, because the calendar takes the issues from the saved filter of the board.
Create a Board calendar
-
On the calendar page click "Add Calendar" and choose "Create".
-
Enter a name and select "Board" under "Calendar type".
-
Choose the board in the "Board" field. Type a part of its name to search.
-
In "Event start" choose the date field that puts an issue on the calendar, for example Due date. "Event end" is optional.
-
Click "Create".
The "Board" type is shown only to users who have access to Jira Software. If it is missing from the list, ask your Jira admin to check your access.
What you see on the calendar
The issues are those of the board's saved filter that have a value in the "Event start" field.
The calendar shows the active, future and closed sprints of the board, and there is no setting for it: a Board calendar always has them. A sprint is an all-day bar with a sprint icon and the sprint name, from its start date to its planned end date. A sprint without a start date is not shown, so a future sprint appears after you give it dates in Jira.
The versions come from every project of the board, and only versions with a release date are shown. A version with a start date is a bar from the start date to the release date, and a version without one sits on its release day. A new calendar has "Display project versions" selected, so clear it in the calendar settings when you do not need the versions.
Sprints and versions take the color of the calendar. The active sprint has the full color, and future and closed sprints are paler.
Sprint details
Click a sprint to open its details: the name, the state, "Event start", "Event end" and, for a completed sprint, "Complete date". The sprint goal is not shown.
A closed sprint stays on the calendar with its planned end date. If the team completed it on another day, that day is the "Complete date" in the details.
Moving sprints and versions
Sprints and versions are read only on the calendar. You cannot drag them or change their length. To move a sprint or a release, change its dates in Jira.
The Board calendar on the project page
A Board calendar is also listed on the "Calendar" page of every project of its board, next to the Project calendars of that project.