Skip to main content
Skip table of contents

Date Mapping

Only users with Jira Admin and App Admin roles can access and manage Date Mapping.

What Is Date Mapping? Date Mapping in TimePlanner allows you to automatically sync the task’s start and end dates between Jira and TimePlanner. This ensures that when you plan the start and end dates of a task in TimePlanner, they are reflected in Jira, and vice versa, making it easier to manage project timelines across both platforms.

How it works:

  • Plan in TimePlanner: When you set the start and end dates in TimePlanner, they are automatically synced to the corresponding date fields in Jira.

  • Plan in Jira: When you set the start date or end date in Jira, those changes are reflected in TimePlanner.

TimePlanner supports mapping for fields in Jira with the field types Date Picker or Date & Time Picker.

What are Date Fields in Jira?

In Jira, Date Fields and Date & Time Fields are used to track dates related to issues and tasks. Jira date fields can vary depending on the project or issue type and may even be customized by users. As long as these fields are of the correct field type, either Date Picker or Date & Time Picker, they can be mapped to TimePlanner.

  • Date Picker: This field type captures only the date (e.g., Due Date, Start Date). They do not include a time component and are typically used for scheduling purposes.

  • Date Time Picker: This field type captures both the date and time (e.g., Actual Start, Actual End). These are useful when precise scheduling down to the hour and minute is required.

What Are Date Fields in TimePlanner?

In TimePlanner, the primary date fields you will interact with are:

  • Start Date: This is the date when the task is planned to begin.

  • End Date: This is the date when the task is planned to be completed.

image-20250709-110258.png

These date fields are used for scheduling and tracking task timelines within TimePlanner.

Before You Proceed:

  1. Mapping Date Fields will limit TimePlanner’s advanced features:
    When mapping date fields to Jira fields, TimePlanner follows Jira’s specifications. As a result, some advanced features are not supported, including:

    • Planning one task for multiple assignees

    • Assigning the same task multiple times

    • Creating recurring tasks

  2. Ensure Jira Field Availability:
    Before you map Jira date fields to TimePlanner, ensure that your desired Jira fields (e.g., Start Date or End Date) are already available in your Jira project or issue type.

How to Map Jira Date Fields in TimePlanner

To get started with mapping Jira date fields, go to the ⚙️ Settings in the left-side menu to find and click on image-20250710-073856.png.

image-20250710-073819.png
  1. Add Jira Projects and Enable the Mapping Dates Function

    • Click the image-20250710-073949.png button to open a dropdown menu that lists all available Jira projects you can configure. From the dropdown, select the Jira project you want to configure.

      image-20250710-093022.png
    • Toggle the image-20250710-082205.png button ON to activate the mapping feature.

      image-20250710-094909.png
  2. Choose the Jira date fields you wish to map to the Start Date and End Date fields in TimePlanner.

image-20250710-095237.png

Warning:

If a red cross (❌) appears next to any field, it means that the selected field does not exist for that issue type in your project configuration. As a result, TimePlanner cannot map the fields to your Jira fields.

image-20250710-101514.png

=> You will need to reconfigure your Jira project to make sure that your desired Jira fields are already available in your issue type.

For troubleshooting steps, read this: How to add date fields to your Jira Projects.

  1. Finish Mapping

There are 2 options to complete the mapping:

  • image-20250710-102340.png: Click Save Only to save the field mapping configuration without migrating any data. Once complete, all previously planned tasks within the project will be reset and aligned with the newly mapped dates. Use this when you want to map Jira fields for future tasks without transferring current data from TimePlanner to Jira.

  • image-20250710-102616.png: Click Save & Migrate to save the field mapping and migrate existing data (Start and End Dates) from TimePlanner to Jira. This is a one-way process, so ensure everything is backed up before proceeding. Use this when you want to align existing data with the newly mapped Jira fields.

image-20250710-102805.png

JavaScript errors detected

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

If this problem persists, please contact our support.