Show issues on the calendar

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

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 the Start date and Due dates to your request types, and then fill them out for each issue.

1. Add the 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, go to Project settings, 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 the Start date and Due date fields.

5. Select Save changes.

2. 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 the navigation on the left, select Project settings () > 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.

3. 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 the Start date and Due date fields.

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

   2. If both the Start date and Due 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.

Issues appear on the calendar based on the data in two fields.

These fields may have different names depending on when you created your project, or if your Jira admin has renamed them. They refer to when you’ve ‘planned’ for your issue to start and end.

1. Planned start or Planned start date – when the issue is planned to start.

2. Planned end or Planned end date – when the issue is planned to finish.

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 in the calendar you’ll need to add the planned start date and planned end dates to your request types, and then fill them out for each issue.

1. Add the 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, go to Project settings , and then Request types.

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

3. Select Request form.

4. Add the planned start date and planned end date fields.

   1. You can also:

      1. change the display name of the field in the request form under Display name

      2. add a description to your field under Display description

      3. automatically fill out a field and hide it from customers in the request form (and portal) by checking the box next to Use preset value and hide from portal

      4. make it compulsory to fill out a field by checking the box next to Required (some fields are required by default)

5. Select Save changes.

2. Make sure the date fields have a search template

If any of the two date fields are missing the Date Time Range picker search template, you’ll need to go and add it.

You need to be a Jira admin to add a search template to a custom field. Learn how to add a search template to a custom field.

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

If any of the four 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 the navigation on the left, select Project settings () > 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 the issue that you want to show on the calendar.

2. Enter dates and times in the ‘planned’ fields. If the fields are filled out, the issue will show on the calendar.