Your first stop for learning how to get started with Jira Service Management.
The features described in this article are available for service projects using the early access calendar only. Learn how to access the calendar early access program (EAP).
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.
Planned start or Planned start date – when the issue is planned to start.
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:
From your service project, go to Project settings , and then Request types.
Select the request type you want to add the fields to.
Select Request form.
Add the planned start date and planned end date fields.
You can also:
change the display name of the field in the request form under Display name
add a description to your field under Display description
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
make it compulsory to fill out a field by checking the box next to Required (some fields are required by default)
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.
From the navigation on the left, select Project settings () > Issue types.
Next to the issue type name, select the link named Jira Service Desk Field Configuration for Project [Your project key].
Select Show next both fields to show them on all associated screens in this field configuration.
Repeat for each issue type as needed.
4. Fill out the date fields on each issue
From your service project, find the issue that you want to show on the calendar.
Enter dates and times in the ‘planned’ fields. If the fields are filled out, the issue will show on the calendar.