# Use Qualflare alongside Zephyr or Xray

Source: https://docs.qualflare.com/docs/migrate/zephyr-xray · Last updated: 2026-10-29

Qualflare can't import Zephyr or Xray test cases. Keep your manual tests there, and upload automated results from your pipeline to Qualflare with the qf CLI.

Qualflare imports test cases only from TestRail, Qase, Testmo and Allure TestOps, so a team on Zephyr or Xray keeps its manual tests there and runs Qualflare alongside: `qf <identifier> collect` uploads your pipeline's test results, and each upload becomes a launch.

## What you can move from Zephyr or Xray

Qualflare has no importer for Zephyr or Xray, and no integration with either.

| Zephyr or Xray                     | In Qualflare                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| ---------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Test cases and their folders       | Not imported. Keep them where they are, or create cases in Qualflare by hand: [Create and edit test cases](https://docs.qualflare.com/docs/test-management/create-test-cases)                                                                                                                                                                                                                                                                                  |
| Automated test results             | Uploaded with `qf <identifier> collect`; Qualflare finds each suite and case by name and creates the ones it doesn't have ([Manual and uploaded cases side by side](https://docs.qualflare.com/docs/runs/automated-results#manual-and-automated)). A result that includes steps replaces the steps of the case it matches, including steps you wrote by hand ([Steps on matched cases](https://docs.qualflare.com/docs/runs/automated-results#reported-steps)) |
| Manual runs, cycles and executions | Not imported. Run manual tests in Qualflare with the [Test Wizard](https://docs.qualflare.com/docs/runs/manual-testing)                                                                                                                                                                                                                                                                                                                                        |
| Jira issues                        | The Qualflare app for Jira files new issues from Qualflare defects ([Connect Jira](https://docs.qualflare.com/docs/migrate/zephyr-xray#jira))                                                                                                                                                                                                                                                                                                            |

Qualflare doesn't import generic CSV or spreadsheet files, or its own export.

## Before you begin

* A Qualflare project ([Create and manage projects](https://docs.qualflare.com/docs/administration/projects)).
* A project access token with **Allow writes** off, which you create in **Project Settings** > **Access Tokens** (requires the Editor role or higher in the project). See [Access Tokens](https://docs.qualflare.com/docs/api/access-tokens).
* qf on the machine that runs your tests ([Install Qualflare CLI](https://docs.qualflare.com/docs/cli/installation)).
* A result file your test runner writes, such as JUnit XML ([Supported formats](https://docs.qualflare.com/docs/cli/formats)).

## Upload automated results

### Step 1: Log in with qf

Save the token under a local identifier, such as `myapp`; qf asks for the token:

```bash
qf login myapp
```

### Step 2: Upload a result file

```bash
qf myapp collect results.xml
```

The upload becomes a launch in **Launches**.

### Step 3: Add the upload to your pipeline

In CI, run `qf login <identifier> --force` with the token in `QF_TOKEN`, then the same `collect` command in a step that also runs when the tests fail. See [CI/CD integration](https://docs.qualflare.com/docs/cli/ci-cd).

## Connect Jira

The Qualflare app for Jira files Jira issues from Qualflare defects and test failures. It works with Jira Cloud only, and it isn't public on the Atlassian Marketplace yet: to try it, message Qualflare in the in-app chat or email [support@qualflare.com](mailto:support@qualflare.com). See [Jira Integration](https://docs.qualflare.com/docs/integrations/jira).

## Run Zephyr or Xray and Qualflare in parallel

Your Zephyr or Xray test cases and their runs stay where they are. Qualflare holds the launches of your uploads, with [failure clusters](https://docs.qualflare.com/docs/ai/failure-clusters) and [flaky test detection](https://docs.qualflare.com/docs/analytics/flaky-tests). Qualflare sends no results back to Zephyr or Xray.

## Limitations

* No import from Zephyr or Xray: **Import** takes only TestRail, Qase, Testmo and Allure TestOps exports.
* No result sync to either tool.
* The Jira app files issues; it doesn't read or update Zephyr or Xray tests.

## Related

* **Guides:** [Migrate to Qualflare](https://docs.qualflare.com/docs/migrate) · [CI/CD integration](https://docs.qualflare.com/docs/cli/ci-cd) · [Jira Integration](https://docs.qualflare.com/docs/integrations/jira)
* **Reference:** [Supported formats](https://docs.qualflare.com/docs/cli/formats) · [Launches](https://docs.qualflare.com/docs/runs/launches)
* **CLI/API:** [Upload results with qf collect](https://docs.qualflare.com/docs/cli/collect) · [Authenticate with qf login](https://docs.qualflare.com/docs/cli/authentication)