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 |
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 |
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:
- 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
Please make sure you have admin permissions in Jira and Leiga organization.
- Click your avatar in the bottom left and select System Settings in the menu.
- Click Jira Sync on the left side.
- 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
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
- Jira Server V9.12
- Click on Start Importing and select Jira Cloud.
- 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.
- Click on Start Importing and select Jira Server V9.12.
- 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
- Select the project you want to import from the drop-down list.
- Click the Start Importing button.
Step3. Member Matching
- If some Jira members are not yet in Leiga, you can import them first.
- Once imported, select the corresponding Leiga member for each Jira user to complete the mapping.
- This ensures that tasks and issues are correctly assigned to the right users in Leiga.
- 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.