Show issues on the calendar

By default, issues appear on the calendar based on the data in two fields. These fields may have different names if your Jira admin has renamed them.

1. Start date

2. Due date

However, you can also choose your own date fields instead. Depending on your organisation and the type of work you do, these dates could show when the work on an issue is due to start or end - for example the kick-off of a project and it’s due date. Or, it could be tied to an SLA - for example the date the customer’s request was submitted and when it needs to be completed by.

To make sure your issues appear on the calendar you’ll need to add your chosen date fields to your request types, and then fill them out for each issue.

1. Add your date fields to your request type

You need to be a Jira admin to customize fields for a request type:

1. From your service project, select Project settings, then Request management, then Request types.

2. Select the request type you want to add the fields to.

3. Select the Request form or issue view tab.

4. Add your selected start date and end date fields to the request type.

5. Select Save changes.

2. Choose your date fields

1. From your service project select Calendar.

2. Select Configure views from the more menu ().

3. Go to Date fields.

4. Select a field for the Start date and a field for the End date. We recommend using two date-time fields, rather than date-only fields.

5. Select Save.

3. Make sure the date fields are showing on your issue screens

If any of the date fields have been hidden from any screens, you’ll need to show them.

You need to be a Jira admin to show the date fields.

1. From your service project, select Project settings, then Request management, then Issue types.

2. Next to the issue type name, select the link named Jira Service Desk Field Configuration for Project [Your project key].

3. Select Show next both fields to show them on all associated screens in this field configuration.

4. Repeat for each issue type as needed.

4. Fill out the date fields on each issue

1. From your service project, find and open the issue that you want to show on the calendar.

2. Enter dates and times in your chosen date-time fields.

   1. If only the end date field is filled out, the issue will show on the calendar on the selected end date

   2. If both the start date field and end date fields are filled out, the issue will show stretched across all days between the start and due date.

   3. If only the start date is filled out, the issue won’t appear on the calendar.