Skip to main content
Already have tests in your repository? Import them into Paragon to track results, run automatically on PRs, and enable evolving tests.

​
Why Import Tests?

When you import existing tests:
  • Track Results: See pass/fail status in the Paragon dashboard
  • Automate Runs: Tests run automatically on PRs and pushes
  • Enable Evolving: Paragon can propose updates when code changes
  • Unified View: See all test results in one place
Importing tests doesn’t copy code into Paragon. Tests remain in your repository and run using your existing framework.

​
How to Import

1

Go to Testing > Tests

Navigate to the Tests page
2

Click New Test

Click “New Test” button
3

Select Repository

Choose the repository containing your tests
4

Choose Code Test

Select “Unit” or “Integration” test type
5

Click Import Tab

Switch to the “Import Existing” tab
6

Browse Tests

Paragon scans your repo and lists all detected tests
7

Select Tests

Check the tests you want to import (supports multi-select)
8

Import

Click “Import Selected” to add tests to your dashboard

​
Supported Frameworks

Paragon detects tests based on your project configuration:

​
JavaScript/TypeScript

​
Python

​
Other Languages

​
Organizing Imported Tests

​
Suites

Tests are organized into suites (folders). When importing:
  • Add to an existing suite
  • Create a new suite

​
Test Types

​
After Importing

Once imported, your tests appear in the Tests list with:
  • File Path: Location in your repository
  • Framework: Detected test framework
  • Test Names: Individual test cases extracted from the file
  • Status: Pass/fail from last run

​
Run Imported Tests

Click the play button next to any test to run it immediately, or:
  • Run All: Execute all tests in a suite
  • Run on PR: Tests run automatically when PRs are opened
  • Schedule: Set up recurring test runs

​
Edit Test Settings

Click any test to:
  • Move to a different suite
  • Update the framework if needed
  • Configure which triggers run this test

​
Troubleshooting

​
Tests Not Detected

If your tests aren’t found:
  1. Check framework config: Ensure your config file is in the repo root
  2. Check test patterns: Tests must follow framework conventions
  3. Check file location: Tests should be in expected directories

​
Wrong Framework Detected

You can manually override the detected framework:
  1. Click on the imported test
  2. Change the framework in settings
  3. Save changes

​
Missing Test Cases

If individual test cases aren’t listed:
  • Paragon extracts test names from describe/it blocks
  • Deeply nested tests may show as a single entry
  • Run the test to see full breakdown

​
Next Steps

Generate Tests

Create new tests with AI