Skip to main content
Skip table of contents

Date Field Mapping with Jira

  • This feature is only available to Jira Admins or App Admins

  • When mapping to Jira date fields is enabled, the app follows Jira's rules. This means advanced features like assigning to multiple users or recurring tasks are not supported.

TimePlanner allows mapping the Start and End Dates to Jira fields. Each project in Jira has a different Screen Scheme with different Fields; therefore, you need to configure the field mapping at the project scope.

Mapping Dates

To get started with the mapping, go to the Settings tab → navigate to the Date Mapping section

Screenshot 2025-04-25 at 17.42.58.png
  1. Locate and click the Screenshot 2025-04-24 at 23.23.13.png + Map new project button → This will open a dropdown menu listing all available Jira projects that you can configure.

  2. Select the project you want to configure in the dropdown list.

Screenshot 2025-04-25 at 18.02.58.png
  1. Toggle ON the Screenshot 2025-04-25 at 18.14.42.pngMap dates” button

  2. Select the Jira fields you want to map to the Start date and End date.

Screenshot 2025-04-25 at 18.12.56.png

Case 1: Valid Configuration

If you have a valid configuration, the issue types should be marked with Screenshot 2025-04-25 at 18.16.13.png green check icons in both the Start date and End date columns.

Screenshot 2025-04-25 at 18.16.02.png

→ Next Step:

  • Click on the Screenshot 2025-04-25 at 18.31.30.png Save & migrate button to finish the mapping.

  • Or click on the Screenshot 2025-04-25 at 18.32.19.png Save only button to save your field selection without applying it yet.

Case 2 – Invalid Configuration:

If your setup is incorrect, red icons will appear in one or both date columns for some issue types. This means the selected fields are not available for those issue types.

Why?

Depending on your project's Screen Scheme, the selected date fields may not be included in the screen for those issue types.

Screenshot 2025-04-25 at 18.43.03.png

How to Fix it?

Go to your Jira project settings and add the missing fields to the screen of each affected issue type. 👉 Learn how to add the fields to the Screen.

✅ Once the fields are correctly configured in the screen settings, proceed with the field mapping from the app’s data to Jira fields.

(lightbulb) Watch the guide video for more details:


Learn more:

→ Adding Fields to the Issue Screen

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.