Skip to main content
LoopIQ provides Jira migration readiness analysis and planning artifacts. The current workflow does not execute a live Jira-to-LoopIQ synchronization or directly copy issues from Jira.

What the readiness workflow provides

Use the workflow to:
  • assess migration readiness
  • identify source projects, issue types, fields, users, statuses, and dependencies
  • review risks or unsupported mappings
  • prepare CSV templates for a governed import
  • prepare communication and cutover guidance
A readiness result is a plan, not proof that records were imported.

Before you begin

Make sure:
  • your organization has permission to plan or manage imports
  • you are in the correct organization and team context
  • you know the Jira sites and projects in scope
  • an authorized Jira administrator can provide approved metadata or exports
  • sensitive Jira data is removed from planning attachments unless required

Run a readiness assessment

  1. Open Import / Export and choose the Jira migration readiness workflow when it is available.
  2. Enter the source scope requested by the page.
  3. Review detected project, field, issue-type, workflow, user, and dependency information.
  4. Resolve blockers and unsupported mappings before preparing data.
  5. Download or generate the approved CSV templates.
  6. Review the communication and cutover checklist with Jira and LoopIQ administrators.
  7. Use the normal LoopIQ import workflow for the prepared files.
  8. Validate record counts, organization and team ownership, assignees, statuses, links, and a sample of migrated records.

Handle users and mappings safely

  • Map assignees only to members available in the target LoopIQ team.
  • Decide how inactive or unknown Jira users should be represented.
  • Preserve Jira keys and source URLs in approved source-reference fields where supported.
  • Treat proposed status or field mappings as review items until an administrator approves them.
  • Never use a successful readiness score as authorization to import another organization’s data.

Troubleshooting

The page does not connect to Jira

The readiness workflow may use provided metadata or export files rather than a live Jira connection. Confirm the input method shown in your deployment.

The assessment reports unsupported fields

Map the field to an existing LoopIQ field, create an approved custom field, or exclude it deliberately. Record the decision before import.

No records appear after readiness completes

Readiness does not create records. Prepare the CSV files and continue with Import and export data.