Recent chats
ASKGEEZ Q&A GUIDETechnology & devices

How can I migrate issue-tracking projects without losing their workflow?

Quick answer

Make a source-to-destination map for issue types, statuses, priorities, and workflow rules before moving data. Match behavior, not just labels: record who can make each transition, what information it requests or validates, and what happens afterward. Confirm which items the migration route supports, rebuild or document anything it does not, and test representative work items in the destination before relying on the migrated project.

LET’S WORK THROUGH IT

The question, the details, the next step.

Question

We’re moving a project to another issue tracker. How do I avoid ending up with the right-looking statuses but the wrong workflow?

Geez

Start with an inventory of behavior, not a list of status names. For each issue type, record its workflow, the statuses it can occupy, and the allowed transitions between them. Then document each transition’s conditions: who may use it, what information it asks for or checks, and what actions it performs afterward.

For example, a project might have “Open,” “In review,” and “Done.” That label match is not enough if only certain people can move an item to review, a review requires a decision field, or completing the work triggers another action. Jira Cloud describes workflows as defining movement between statuses, with transitions specifying the next statuses; its transition-rule categories include restrictions, input requests, validation, and post-transition actions. [S2] Use these categories as a comparison prompt, not as proof another product supports the same features.

Follow-up question

What should my mapping document look like, especially if the two apps name things differently?

Geez

Use one row per source issue type and workflow path, and keep the original and proposed destination names side by side. Add a separate entry for each transition so differences remain visible. A compact template is:

Issue type | Source workflow | Source status/transition | Rule or required input | Destination equivalent | Gap/action | Test case

Example, with hypothetical names: Bug | Defect flow | In review → Done | Reviewer decision required | Review → Complete | Rebuild decision check; verify supported mechanism | Try without decision, then with decision.

Include priorities and how they are associated with issue types or projects, too. If a destination uses different labels, write down the intended meaning rather than treating similar words as equivalent. Mark each item as “mapped,” “rebuild,” “manual workaround,” or “not needed,” and assign someone to resolve every gap before cutover.

Follow-up question

Can I assume the migration tool will carry all of this over?

Geez

No. Verify the exact migration route and its current supported-item list. For the specific Jira Server or Data Center to Jira Cloud route documented for Jira Cloud Migration Assistant, the listed items include issue types and schemes, workflows and workflow schemes, statuses and transitions, priorities and priority schemes, and issue data such as issue type and status. The same documentation lists workflow triggers and properties among items that are not migrated. [S1]

That is evidence about that Jira route only; it does not establish what another app, migration tool, or later version will transfer. Nor does a listed workflow mean every rule behaves identically in the destination. Compare the documented exclusions with your inventory, confirm current rule support for your route, and plan explicit rebuilds or alternatives for anything not covered.

Follow-up question

How should we test it before we switch everyone over?

Geez

Agree on expected outcomes first, then test in the destination with representative items for each important issue type and path. Include ordinary transitions and edge cases: a user who should be allowed, one who should not; required information omitted and supplied; validation that should block a transition; and any expected follow-up action. Record expected and actual results, the test item, and the person who checked it.

For instance, if a hypothetical “Ready for review” transition requires a reviewer decision, test both an attempt without the decision and one with it. Confirm the first is blocked if that is the intended behavior, and the second reaches the intended status. Repeat for priorities and issue types, and check that migrated issues land in appropriate statuses. Treat failures as mapping or rebuild work, not as harmless label differences. Do not cut over until each high-impact gap has an owner and a verified disposition.

A practical checklist

  • List issue types, schemes, statuses, priorities, and their associations in the source project.

  • Record each transition’s allowed next status, restrictions, requested inputs, validations, and follow-up actions.

  • Map each source item to a destination equivalent and mark gaps for rebuilding, workaround, or removal.

  • Check the current supported-item documentation for the exact migration route; do not generalize from a different product or route.

  • Test representative paths and edge cases in the destination; record expected results, actual results, and unresolved gaps.

A few more useful answers

Is matching status names enough to preserve a workflow?

No. Also compare which transitions are available and their restrictions, inputs, validations, and follow-up actions. Similar labels can conceal different behavior.

Does the Jira migration documentation apply to every tracking app?

No. The cited migration list concerns Jira Server or Data Center to Jira Cloud using Jira Cloud Migration Assistant. Check documentation for your specific products and route.

What should I do with a workflow rule that is not supported?

Record the missing behavior, decide whether to rebuild it or use an agreed alternative, and test that choice before cutover. The cited documentation does not establish what replacement features other products provide.

Sources

References used for this guide.

  1. [S1] What gets migrated with the Jira Cloud Migration Assistant
    support.atlassian.com · Checked
  2. [S2] Edit a workflow's rules
    support.atlassian.com · Checked

YOUR QUESTION. YOUR DETAILS.

Let’s work through your situation.

Get a tailored answer or help with your next task. Starts at $1, with a quote before you pay.

Ask your own question
← Back to Geez at Work