Skip to main content

Import from External Sources

TestChimp can import User Stories and Test Scenarios from external issue trackers into your Test Planning workspace.

Where to find it​

In Test Planning, open the Import / Export menu and choose Import from… → Jira or Linear.

How imports work (common behavior)​

  • What gets created
    • User stories are imported as TestChimp user stories.
    • Test scenarios are imported as TestChimp test scenarios (linked to their parent story when applicable).
  • Credentials
    • Credentials are one-off for the import wizard and are not stored.
  • Preview before import
    • The wizard shows a preview of how many stories/scenarios will be imported before you start the import.
  • File & folder behavior
    • You can choose a file naming strategy (external ID, TestChimp entity ID, or AI deduce).
    • You can choose a folder structure strategy (group by a field/label, or AI deduce).
  • Undo
    • After an import, you can use Import / Export → Revert recent import… to delete everything created by the most recent import.
  • Free trial limits
    • Free trial orgs are limited to 25 imported user stories.

Jira​

The Jira import is a 5-step wizard.

Step 1: Configure Jira​

Provide:

  • Jira URL (e.g. https://yourcompany.atlassian.net)
  • Email
  • Jira personal access token (Atlassian API token)
  • Project Key (e.g. PROJ)
  • JQL (optional) to further narrow what is imported

Then click Next: Select issue types.

Step 2: Issue types​

Select the Jira issue type to treat as:

  • User story issue type
  • Test scenario issue type

Then click Next: Labels to preview counts and continue.

Step 3: Labels (optional)​

Choose which Jira fields should be imported as labels in TestChimp.

Step 4: File & folder​

Choose:

  • File naming
    • External ID (e.g. PROJ-123)
    • TestChimp entity ID (e.g. US-1, TS-1)
    • AI deduce
  • Folder structure
    • Use a specific field (pick the Jira field to group into folders)
    • AI deduce

Step 5: Import​

Click Start import and wait for the import to finish. When it completes, the wizard shows how many stories and scenarios were created.

Linear​

The Linear import is a 5-step wizard.

Step 1: Configure Linear​

Provide:

  • Linear API key (from Linear Settings → API)
  • Team Key (e.g. ENG)
  • Filter query (optional) to further narrow what is imported

Then click Next: Select labels.

Step 2: Labels (story/scenario)​

Pick the Linear label that identifies:

  • User story label
  • Test scenario label

Important: Linear test scenarios must be sub-issues (child issues) of their parent story issues for linking to work correctly.

Step 3: Tag labels (optional)​

Select additional Linear labels to import as tags in TestChimp.

Step 4: File & folder​

Choose:

  • File naming
    • External ID (e.g. ENG-123)
    • TestChimp entity ID (e.g. US-1, TS-1)
    • AI deduce
  • Folder structure
    • Use a specific label (pick the Linear label to group into folders)
    • AI deduce

Step 5: Import​

Click Start import and wait for the import to finish. When it completes, the wizard shows how many stories and scenarios were created.