Skip to main content

Import Work from Jira

Import your works from Jira and quickly start your projects on Leiga. We support the bi-directional synchronization of works in Jira and Leiga, allowing you to use Leiga without worries.

Data Included

Data included in the import

Leiga can import following data from Jira that matches Leiga's concepts. Leiga will automatically match fields for your convenience. Some adapations are made for fields as well.

These properties are automatically matched:

JiraLeiga
SummaryTitle
Issue TypeWork Type
creatorCreated By
AssigneeAssignee
ReporterReporter
DescriptionDescription of the issue
Due dateDue Date
LabelsTags
statusStatus
PriorityPriority
ProjectIDProject ID
Parent Tasks/Sub-tasksParent Work/Child Work
Epic LinkEpic Link
SprintSprint: An issue can only have one sprint; Leiga will retrieve newest sprint for an issue.
Story PointsStory Points
note

Please note that data not included in the table above like attachments or original story points will not be imported to Leiga.

For failed matched data such as custom fields, Leiga enables the importer to:

a. either manually matched to a similar standard field.

b. or manually create a new field; following table shows the field types Leiga support:

Field TypeText
TextSimple Plain Text
Long TextLong Text: Longer Text that shows more info
Rich TextRich Text that include formats
IntegerAn Integer Number
DecimalA Decimal Number
DateDate
Date TimeDate Time
Drop-down RadioDrop-down Radio: Drop-down Radio button that provides a single choice
Drop-down MultipleDrop-down Multiple: Drop-down Multiple checkboxes that provides multiple choices
LinkLink
Progress BarProgress Bar
note

Please note that field type not included in the table above like labels or cascading select list are not supported.

Overview of New Enhancements

FeatureDescription
Enhanced Description ImportMore complete import of Jira issue descriptions, including rich text, formatting, and nested content.
Member-Mapped Activity Log ImportActivity logs (e.g., status changes, assignments) are imported and mapped to the corresponding Leiga members based on the completed member matching.
Jira Comment SynchronizationComments from Jira are imported into Leiga, preserving author info.

Data included in the Synchronization

Beside the data that cannot be imported in the previous section cannot be synced, due to the difference in concept, some data have limitations in synchronization. Here is a list:

  1. From Task/Subtask in Jira to Parent work/Child work: This can be imported for the first time. Leiga will automatically create the Parent works and child works when you first import. However, synchronizations afterwards can only be done from Jira to Leiga; but not the other way around.

Import Instruction

Enter Importing Page

note

Please make sure you have admin permissions in Jira and Leiga organization.

  1. Click your avatar in the bottom left and select System Settings in the menu.
  2. Click Jira Sync on the left side.
  3. Find Jira and click the Start Import button to enter the importing page.

Start Importing

We support the following Jira versions:

  • Jira Server V9.12
  • Jira Cloud
note

Please make sure that your Jira account has administrator rights before proceeding to the next step.

Step1. Connect Leiga with your Jira account

  1. Click on Start Importing and select Jira Cloud.
  2. Fill in your Jira information:

Including URL, API Token, and Email.

  • URL: Enter your Jira domain

  • API Token: Create and enter the API token for the associated Jira account

How to generate an API Token? Atlassian Account Settings - Securit - API Token - Create and Manage API Token - Create API token - Copy

  • Email: The email address associated with this Jira account

3. Click the Next button with all the required information filled in.

Step2. Select the project to import

  1. Select the project you want to import from the drop-down list.
  2. Click the Start Importing button.

Step3. Member Matching

  1. If some Jira members are not yet in Leiga, you can import them first.
  2. Once imported, select the corresponding Leiga member for each Jira user to complete the mapping.
  3. This ensures that tasks and issues are correctly assigned to the right users in Leiga.
  4. You can also skip this step and return to match members later if needed.

Step4. Choose whether to sync work between Jira and Leiga

Tick the box to synchronize work with their summary, description, and status.

Import again

You can continue to import more projects after you connect Leiga with your Jira account.

Import History

View all the project importing records from Project Import History tab. You can easily find the project name, number of imported work, and importing results here.

Manage Synchronization

You can toggle the switch to turn on/off the work synced in the project between Jira and Leiga.