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:

Jira	Leiga
Summary	Title
Issue Type	Work Type
creator	Created By
Assignee	Assignee
Reporter	Reporter
Description	Description of the issue
Due date	Due Date
Labels	Tags
status	Status
Priority	Priority
ProjectID	Project ID
Parent Tasks/Sub-tasks	Parent Work/Child Work
Epic Link	Epic Link
Sprint	Sprint: An issue can only have one sprint; Leiga will retrieve newest sprint for an issue.
Story Points	Story 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 Type	Text
Text	Simple Plain Text
Long Text	Long Text: Longer Text that shows more info
Rich Text	Rich Text that include formats
Integer	An Integer Number
Decimal	A Decimal Number
Date	Date
Date Time	Date Time
Drop-down Radio	Drop-down Radio: Drop-down Radio button that provides a single choice
Drop-down Multiple	Drop-down Multiple: Drop-down Multiple checkboxes that provides multiple choices
Link	Link
Progress Bar	Progress 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

Feature	Description
Enhanced Description Import	More complete import of Jira issue descriptions, including rich text, formatting, and nested content.
Member-Mapped Activity Log Import	Activity logs (e.g., status changes, assignments) are imported and mapped to the corresponding Leiga members based on the completed member matching.
Jira Comment Synchronization	Comments 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

Jira Cloud

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.

Jira Server V9.12

1. Click on Start Importing and select Jira Server V9.12.
2. Fill in your Jira information:

Including URL, Username, and Password.

• URL: Enter your Jira domain

• Username: Your Jira username
• Password: Password of your 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.