Get started with Jira Service Management for admins
Your first stop for learning how to get started with Jira Service Management.
Show issues on the calendar
This feature is currently rolling out and may not be available on your site. Check the features page in your project settings to see if you can enable it for your project.
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.
Start date
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. Choose your date fields
From your service project select Calendar.
Select Configure calendar from the more menu ().
Go to Date fields.
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.
Select Save.
2. Add your date fields to your request type
You need to be a Jira admin to customize fields for a request type:
From your service project, select Project settings, then Request types.
Select the request type you want to add the fields to.
Select the Request form or issue view tab.
Add your selected start date and end date fields.
Select Save changes.
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.
From your service project, select Project settings, then 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 and open the issue that you want to show on the calendar.
Enter dates and times in your chosen date-time fields.
If only the end date field is filled out, the issue will show on the calendar on the selected end date
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.
If only the start date is filled out, the issue won’t appear on the calendar.
You can also fill these fields by opening the unscheduled issues panel () and dragging the issue onto the calendar. Dropping the issue onto a day will fill in the end date field, and extending the field by dragging the issue will add a start date and change the end date as needed.
The features described in the section below 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, select Project settings, 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 your service project, select Project settings, then 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.
Was this helpful?
Still need help?
The Atlassian Community is here for you.