Syncing Roadmaps with Jira date fields
This guide explains how date syncing works in Easy Agile Roadmaps and how to configure it.
Date syncing is optional. If you don’t set up date syncing, you can schedule issues on the roadmap without changing dates on the issues in Jira.
What does date syncing do?
Date syncing keeps the plans you make in Easy Agile Roadmaps in sync with your Jira data. It uses the date fields on the Jira issues to read and write the schedule of each issue.
When you schedule an issue on the Roadmap, the dates will be updated on the issue in Jira.
If your issues already have dates set, they’ll automatically appear on the Roadmap (in the “Issues without themes” swimlane at the bottom).
How can I tell if date syncing is enabled?
If date syncing is not yet fully configured, a blue “bell” button will show in the app header.
This includes if date syncing is configured for some but not all issue types.
If the button is missing, that means date syncing is working correctly.

Configuring date syncing with Jira
You’ll need Jira Administrator permission to configure this.
There are 2 steps to set up date syncing:
Select start and end date fields to use with Easy Agile Roadmaps.
Add the date fields to the Issue screens for relevant Jira projects.
Select date fields
Select a pair of date fields in the global Configuration page for Easy Agile Roadmaps.
This page can be found in Jira’s “Manage apps” settings.
Find the “Easy Agile Roadmaps” section in the sidebar to open the “Configuration” page.

Existing date fields will be available to select from the dropdown. This includes:
Custom fields with type “Date picker” (Custom field types in Jira Cloud or Jira Data Center)
“Target start” and “Target end” fields used by Plans for Jira Cloud Premium or Advanced Roadmaps for Jira Data Center
If there is no existing “Start date” field, the app can create it once. If you delete the field, the app will not create any further fields.
If you choose “Disable synchronizing this field”, date syncing will be disabled for Roadmaps on all boards on this Jira site.
Add date fields to Issue screens
Use the “Click Here” link under each dropdown to go directly to the “Associate field to screens” page. This lets you select existing Issue screens to quickly add the field to.

Jira Cloud only: in team-managed projects, you’ll find issue field configuration in Project settings instead.
Tips:
By default, Issue screens are named with the Project key.
Easy Agile Roadmaps can be used on multi-project boards. In this case, you’ll need to add the custom fields to the Issue screens for all the projects.
On Data Center, there are different issue screens for Create, Edit, and View operations by default. The date fields need to be on both Create and Edit screens.
Troubleshooting date syncing
On multi-project kanban boards
Date syncing can fail on kanban boards if there are more than 10 Jira projects in the board and the Kanban backlog is disabled.
When a board includes issues from more than 10 Jira projects, Jira doesn’t show the projects in the “Projects in board” list.

When Easy Agile Roadmaps fetches data about this board from Jira, Jira fails to return the full list of projects/issues. This stops the app from fetching all the issues from the board for date syncing.
To resolve this, enable the Kanban backlog on your Jira board in Jira Cloud or Jira Data Center.