Connect issue start and end date with Jira fields

Owned by Nikki Zavadska
Last updated: May 16, 2024 by Michelle Ruoff
2 min read

You can connect issue start and end dates in Swanly with date fields in Jira and keep them in sync.

Once the connection with Jira fields is set, then when the field changes in Jira, it automatically updates in Swanly and vice versa. This connection is quite useful when you wish to keep using both, Jira project roadmaps, and Swanly, so you can keep the roadmaps in sync.

When you install Swanly, the issue start date gets mapped to the Start date field in Jira by default, and the End date in Swanly gets mapped to the Due date field in Jira. You can change the mapping to a different date field in Jira or disconnect the field altogether in Swanly settings.

If you installed Swanly before July 2021, you’ll need to manually select what Jira fields you’d like to map in Swanly.

👇 Use the following steps:

Change the Jira fields connected to Swanly’s start and end dates

  1. In Jira, navigate to Apps > Swanly roadmaps > Issue view > Issue settings > Settings.

  2. Click Change fields in the Connect Swanly dates with Jira fields section.

  3. From the drop-down, select fields for the Swanly start and end dates.

  4. Click Save.

Saving these changes might take a few minutes depending on the number of issues you have in your projects. Once you save, you’ll notice that the issues in Swanly have updated their start and end dates based on the fields you selected. Now, if the selected field gets updated in Jira, then the issue start and end dates in Swanly update as well; it goes both ways.

What fields are available?

You can select any Jira field with a date format.

You won’t be able to select fields that store both, dates and hours, or other Jira fields like text, number, drop-down select, and so on.

All dates set in Swanly for start and end date get updated with values that are in selected Jira fields. If there are no dates set in Jira fields, there will also be no dates set in Swanly.

If you would like to keep Swanly dates that were set prior to the mapping, read the following documentation.

Disconnect synchronization between Jira fields and Swanly issue start and end date

  1. In Jira, navigate to Apps > Swanly roadmaps > Issue view > Issue settings > Settings.

  2. Click on Change fields in the Connect Swanly dates with Jira fields section.

  3. From the drop-down, select None for the Swanly start and end date.

  4. Click Save.

Once you save, all dates in Swanly will go back to how they were before the changes. Now, if you update the start date in Swanly, the change will not be reflected in any of the Jira fields and vice versa.

Â