Flexible Calendar for Jira

Create New Calendar Back to top

• Click "Add Calendar" in the upper right corner of the screen, then choose create.
• Enter required information about your Calendar:
  • Name: The name of your calendar will be used when displayed in the list of calendars, when searching, and so on
  • Color: Events or Issues on the calendar will be painted in this color
  • Basic: In this mode, it is possible to display and create only custom events
  • Project: In this mode, you can select a specific project to display tasks
  • Filter: Creating a calendar via the Jira filter
  • JQL query: Creating a calendar via the JQL query
  • Issue Fields: JIRA fields that should be displayed on issue card
  • Start: Start day field of Jira task (can be Jira system or custom field)
  • End: End day field of Jira task (can be Jira system or custom field). If empty, any task will be displayed for a duration of one day
  Note: Select editable start and end date fields to enable drag and drop functionality for tasks. Depending on field types (date only or date time), events will be scheduled as All Day or not.
• Click Create to finalize your new calendar.

Add Existing Calendar Back to top

• Click "Add Calendar" in the upper right corner of the screen, then choose add existing.
• Select existing calendar from the list (all calendars to which you have permission are displayed).
• Click Add to add the calendar to your view.

Subscribe to External Calendar (Jira DC Only) Back to top

• Click "Add Calendar" in the upper right corner, then choose "Subscribe to external calendar".
• Enter required information:
  • Name: The name of your calendar for display purposes
  • ICS Feed URL: The URL to the external calendar
  • Color: Events from the external calendar will be painted in this color
  Note: Events will be pulled from the external calendar every 10 minutes automatically.
• Click Create to subscribe to the external calendar.

Create New Event Types Back to top

• Click the three dots to the right of the calendar name for which you want to create a new event type.
• Open "Event Types" tab in the calendar settings.
• Click "Add new Event" button to create a new event type.
• Enter required fields:
  • Name: The name of the Event Type
  • Icon: Icon to represent this Event Type
  • Reminder: Select a time before which event participants should be notified about event start (Jira DC Only)
• Click Create to save the new event type.

Create New Event Back to top

• Double-click on the calendar day block where you want to create an event.
• Select the calendar on which the event will be created.
• Type the name of your event that will be displayed in the calendar.
• Select the event type from the Type drop-down menu.
• Choose if it should be an All Day event or specify exact times.
• Specify start and end dates for your event.
• Select users who will participate in the event.
• Click Create to save the event.

Create Recurring Events Back to top

• Double-click on the calendar day block.
• Select the calendar on which the event will be created.
• Type the name of your event.
• Select the event type from the Type drop-down.
• Choose All Day option if applicable.
• Specify start and end dates for your event.
• Select participants for the event.
• Select recurrent mode from the "Repeat" dropdown.
• Specify recurrence rule (daily, weekly, monthly, etc.).
• Click Create to save the recurring event.

Timeline View Back to top

Timeline view allows you to visualize tasks in a horizontal timeline format with powerful grouping options.

Group Tasks by Project

Group Tasks by Issue Type

Group Tasks by Assignee

• Click on "Views" dropdown on the top right corner.
• Select Timeline from the available views.
• Select "Group By" field from the dropdown (custom events display in the "Without Group" section).

Agenda View Back to top

• Click on "Views" dropdown on the top right corner.
• Select Agenda to view your events in a chronological list grouped by day.

Calendar Permissions Back to top

• Click the three dots to the right of the calendar name you want to configure.
• Click Edit button to open calendar settings.
• Open "Permission" tab in the settings dialog.
• Choose users or groups and assign permission levels:
  • ADMIN: All possible actions are allowed
  • USE: All actions allowed except calendar edit and new event types creation
  • Read Only: Users can only view existing events/issues. No edit, delete, or move actions allowed
• Click Save to apply the permissions.

Create Quick Filters Back to top

• Click the three dots to the right of the calendar name.
• Click "Configure quick filters" from the menu.
• Enter required fields:
  • Name: The name of the Quick Filter
  • Condition: JQL condition to filter events
  • Share with other users: Select if other users can use this quick filter
• Click Save to create the filter.
• Enable the filter by clicking the checkbox near the filter name.
• Click Close to exit the configuration.
• Apply quick filter by clicking on it in the calendar view.

Export Calendar (Jira DC Only) Back to top

Click here for instructions on how to automatically sync/update your calendar to Google Calendar.

• Click Export button on the top right corner.
• Select calendars to export from the available list.
• Select period for the export (date range).
• Click "generate calendar" link to create the export URL.
• Copy the link and import it to Google Calendar, Apple Calendar, your phone, or other calendar applications.

Export Calendar to PDF & Excel (Cloud Only) Back to top

Export your calendar events to PDF or Excel format with customizable date ranges and column selections. This feature allows you to create professional reports of your calendar data including both Jira issues and custom events. The maximum export range is 1 year (365 days).

• Click the Export button in the calendar toolbar.
• Select Export Format: Choose either "PDF (.pdf)" or "Excel (.xlsx)" from the dropdown menu.
• Set Start Date: Select the beginning date for your export range.
• Set End Date: Select the ending date for your export range (maximum 365 days from start date).
• Configure Issue Columns: Select which Jira issue fields to include in the export:
  • Base columns (Type, Calendar, Title, Start, End) are always included
  • Add additional fields like Issue Type, Status, Priority, Assignee, Project, etc.
• Configure Event Columns: Select which custom event fields to include (e.g., Participants).
• Review Export Range: The dialog shows the calculated export range in days.
• Click "Export to PDF" or "Export to Excel" to generate and download your calendar report.

Configure Calendar Gadget Back to top

• Go to the Jira Dashboard where you want to add the gadget.
• Click "Add Gadget" button on the top right corner.
• Click "Load all gadgets" if the "More gadgets available" popup appears.
• Find "Flexible Calendar" gadget and click "Add Gadget" button.
• Configure the gadget:
  • Calendars: Select calendars that should be displayed
  • Scope: Choose the calendar scope (Month, Week, Day, etc.)
  • Weekends: Display weekends on the calendar or not
  • Refresh Interval: How often you would like this gadget to update
• Click Save to add the gadget to your dashboard.

Upcoming Events Gadget (Cloud Only) Back to top

View upcoming events directly on your Jira dashboard. This gadget displays events from selected calendars in a convenient list format, helping you stay on top of your schedule without navigating away from your dashboard.

• Go to the Jira Dashboard where you want to add the gadget.
• Click "Add Gadget" button on the top right corner.
• Find "Upcoming Events" gadget and click "Add it now" button.
• Configure the gadget:
  • Calendars: Select one or more calendars to display events from
  • Event Types: Filter by specific event types (optional)
  • Period Unit: Choose the time unit (Days, Weeks, Months)
  • Period Value: Set how far ahead to display events (e.g., 7 days, 1 week)
  • Show Events: Choose to show all events or only events where you are a participant
• Click Save to add the gadget to your dashboard.
• View your upcoming events:

  The gadget displays events in a table format showing the event type, name, date/time, and action buttons. You can click "View" to see event details or "Open" to access linked Jira issues.

Admin Configuration Back to top

Configure global settings for working days, business hours, and group visibility. These settings apply to all calendars and control access to the Flexible Calendar.

Group Visibility Configuration (Cloud Only)

Control which Jira groups can see the Flexible Calendar feature.

• Navigate to Flexible Calendar Configuration: Access the global configuration page from Jira settings.
• Configure Working Days: Select which days of the week are working days (Monday through Sunday).
• Set Business Hours: Define the start and end times for business hours (e.g., 9:00 AM to 5:00 PM).
• Configure Group Visibility: Select which Jira groups can see the Flexible Calendar:
  • If no groups are selected, the calendar is visible to all users
  • Add specific groups to restrict calendar visibility to only those group members
  • Multiple groups can be selected to grant access to users in any of the selected groups
• Review Warning: The system will display which groups have access to the calendar.
• Click "Save Configuration" to apply the global settings.

Configure Working Days and Hours (Cloud & Server)

Define which days are working days and set business hours for your organization. These settings affect how the calendar displays and calculates working time.

• Navigate to the configuration page: Go to {jiraUrl}/secure/CalendarWorkingDaysConfiguration.jspa
• Select working days by clicking on the days (saves automatically on click).
• Specify work day hours: Set the start and end hours for your work day, then click "Update working hours" to save changes.