Import Jira tickets into workflows

export const meta = { title: 'Import Jira tickets into workflows', description: 'Search for a Jira issue, turn it into a suggested testing goal and context, and launch the workflow builder from the import flow.', tags: ['guide', 'jira', 'workflows', 'imports'], };

Import a Jira ticket directly into a workflow to turn planned work into test automation faster. You search for an issue, review Canary’s suggested testing goal and context, and then open the workflow builder with that information prefilled.

01Before you start

Before you import a Jira ticket, make sure:

Your property has a Jira connection available.
You can access the Jira project and issue you want to import.
You have permission to create or edit workflows in Canary.
The Jira ticket includes enough detail for Canary to generate a useful testing goal and context.

If you need to continue building and organizing the workflow after import, use the workflow builder to refine the generated steps and assertions.

02Import a Jira ticket into a workflow

Start the import flow anywhere Canary offers workflow imports, then choose the Jira option to create a workflow from an existing issue.

Jira import dialog showing issue search and import options

Search for and select an issue

Open the workflow import flow.
Select Jira ticket as the import source.
Enter a ticket key, title, or other issue details in the search field.
Review the matching issues that Canary returns.
Select the Jira issue you want to import.

Use a specific ticket key when possible to find the exact issue faster. If the issue does not appear, confirm that the Jira connection is available and that you have access to the project in Jira.

Review the suggested testing goal and context

After you select an issue, Canary analyzes the ticket and suggests a testing goal and supporting context. Review both fields carefully before you continue.

Use the suggested testing goal to confirm what the workflow should validate.
Review the context to make sure important product details, user flows, or acceptance criteria are represented.
Edit the generated text if you need to clarify scope, remove irrelevant details, or add missing expectations.

This step helps you start with a clearer workflow definition before you enter the builder.

Launch the workflow builder

Confirm the selected Jira issue.
Review or update the suggested testing goal and context.
Click Launch workflow builder.

Canary opens the workflow builder with the imported Jira information carried forward. From there, continue shaping the workflow, add any missing checks, and save your work when the workflow is ready.

03Troubleshoot Jira import issues

If Jira import does not work as expected, use the following checks.

Issue	What to do
No issues appear in search results	Confirm the Jira connection is set up for your property and verify that you can access the project and issue in Jira. Try searching with the exact ticket key.
Imported content looks incomplete	Open the Jira ticket and add more detail, such as acceptance criteria, expected behavior, or user flow notes. Then run the import again.
The suggested testing goal or context is unclear	Edit the generated text before launching the workflow builder so the workflow starts with the right scope.
Import errors appear	Retry the import and check whether the Jira ticket contains unusually large or complex content. If the problem continues, contact your Canary admin or support team.

04Next steps

After you launch the workflow builder, continue turning the imported ticket into a reusable workflow.

Build and refine the generated workflow in the builder.
Add environment-specific credentials if your workflow needs authenticated access. See /docs/guides/using-credential-templates-for-test-users.
Review workflow behavior across environments before running at scale.
Import additional work items as needed to speed up test creation.