Thunders supports importing tests, creating new ones, and pushing execution results back to Xray.
Thunders integrates natively with Xray, replacing the need for third-party connectors. The integration works through Thunders AI and the test run sync surface.
Supported deployments
Deployment | Authentication | Notes |
Xray Cloud | API key pair (Client ID + Client Secret) | Auto-detects your regional endpoint (Global, US, EU, AU). |
Xray Data Center | Auto-detected from connecting Jira Data Center | Requires Jira DC to be connected first. |
On the Connectors page, the Xray Cloud and Xray Data Center rows read "Knowledge source and test result sync": Thunders AI imports and exports Test Cases, and Thunders syncs Test Run results to Xray.
Xray connections are personal: each user connects with their own credentials, per project. Teammates set up their own access from the same Connectors page. |
Connect Xray Cloud
Open your test project, click Configure, then Connectors.
Find Xray Cloud in the list and click Connect.
Enter your Xray Cloud Client ID and Client Secret.
Click Connect Xray Cloud. Thunders validates your credentials and automatically detects your regional endpoint.
Once connected, Xray Cloud appears as available in the Thunders AI source selector across test cases, test plans, and test case chat.
Where to find your Xray API credentials In your Xray Cloud instance, go to Settings > API Keys and generate a new API key pair. Copy the Client ID and Client Secret. |
Connect Xray Data Center
Xray Data Center does not require a separate connection. It is auto-detected from your existing Jira Data Center connection.
Connect Jira Data Center first (Base URL + Personal Access Token).
When connecting Jira DC, Thunders probes for the Xray add-on. If Xray is detected, you will see a prompt to Enable Xray DC directly in the Jira DC connection dialog.
Click Enable Xray DC to activate the integration, or click Skip to connect Jira DC only.
You can also connect Xray DC later from the Connectors page by clicking the Xray Data Center tile.
The Xray Data Center tile is disabled until Jira Data Center is connected. If you disconnect Jira DC, Xray DC is automatically removed. |
Connect a Jira Data Center server on a private network
If your Jira Data Center server is reachable only inside your company network, Thunders reaches it through your organization's relay. When you connect Jira Data Center, Thunders finds whether it can reach the server directly or through one of the relays of your organization, and keeps the path that works. Xray Data Center then uses the same path to connect, to sync Test Run results and to work with Thunders AI.
The relay must be running each time Thunders connects to Xray Data Center, reads from it or syncs a result. When the relay is not running, connecting and Sync to Xray show "Your relay is offline. Start it and try again." An automatic sync that fails for this reason shows "Last sync failed. Please try again" on the Test Run. Start the relay, then click Sync to Xray on the Test Run. If your organization has no relay yet, contact [email protected].
Use Xray with Thunders AI
Once Xray is connected, enable it from the source selector in any Thunders AI surface (test case, test plan, or test case chat). Thunders AI can then interact with your Xray data.
Import existing Xray tests
Bring your existing Xray test cases into Thunders. Provide a test key or search for tests, and Thunders AI reads the steps, structure, and metadata.
Example User: Read XSP-1 and create a Thunders test case from it |
Thunders AI reads the Xray test (step-based on both deployments; Gherkin on Xray Cloud) and generates a Thunders test case that preserves the original structure. Each request imports one test. The Xray issue key is stored as a source mapping on the Thunders test case. The link shows in the Source part of the Test Case properties panel, with the sync state. You can detach the link from the test if needed.
Import a whole Test Plan (batch)
Point Thunders AI at an Xray Test Plan and it imports the plan's tests in one go: it reads the plan, fetches every test in it, and creates the corresponding Thunders test cases in a single session, each with its own Xray source link. You can then run them in Thunders and sync each result back to Xray.
Example User: Read test plan XSP-10 and create Thunders test cases for all its tests |
Create new tests in Xray from Thunders
You can create new Xray test issues directly from Thunders through Thunders AI. When you generate a test case and Xray is enabled, Thunders AI can write the test back to your Xray project.
Example User: Create the corresponding test of this test case in XRAY project [project name]. |
Search Xray content
Thunders AI can search your Xray workspace for tests, test plans, test sets, test executions, and preconditions. Use this to find existing coverage before writing new tests.
Example You: Search Xray [project name] for all tests related to the login flow |
Use Xray tests as context
When creating tests, you can reference Xray tickets as context. Provide either:
A test key (e.g.
XSP-42), orA ticket URL.
Thunders AI fetches the test details and uses them as context for generating new test cases.
Start from a ticket
In a new Thunders AI conversation, under "Not sure where to start?", click Test a ticket and choose a suggestion, for example "Create a test case from one of my tickets". When your project has no ticket source connected yet, Thunders AI first asks "Where do your tickets or specs live?". Click Xray to connect Xray Cloud. When the connection completes, Thunders AI turns on Xray for the conversation and sends your request. Click Somewhere else to send the request without a source. This list does not offer Xray Data Center.
Sync test results to Xray
After running a test in Thunders, you can push the execution results back to Xray. This keeps your Xray test management layer up to date with AI-powered execution results. You can sync a run by hand from a given run, or turn on automatic sync so that Thunders pushes each finished run for you.
How to sync manually
Navigate to the test run detail page for a completed run.
If the test case has an Xray source mapping, a Sync to Xray button appears in the run properties panel.
Click Sync to Xray. The results are pushed to Xray as a test execution.
Once synced, the button is replaced with a confirmation line showing the Xray execution key and sync date.
You find all the details of the run in the comment of the test run, in the Xray ticket. See "What gets synced" below.
Sync automatically
Turn on automatic sync so that Thunders pushes each finished run to Xray without a click.
Open your test project, click Configure, then Connectors.
On the connected Xray tile, click Manage.
In the Settings section, turn on Auto-sync test Results.
Click Save. Thunders confirms with a "Settings saved" message.
How automatic sync works
|
What gets synced
Overall status: Pass or Fail (interrupted runs are reported as Aborted).
Per-step status: Each test step is mapped with its own pass/fail result.
Screenshots: Pre-run and final action screenshots are attached to each step.
Actual results: For failing steps, the actual result description is included.
Timestamps: Start and finish times of the execution.
Run conditions: A comment on the Xray test run shows the conditions of the run on one line: Environment, Persona, Device and Resolution. Only the values that the run has appear. The Persona appears as its role, such as QA Engineer, not as its name.
Thunders steps: The same comment lists each Thunders step with its status (Passed, Failed, Not run or Blocked) and, for a failed step, the bug that Thunders found. You see the steps even when the Xray test has no steps of its own.
Link to the run: The comment ends with an "Open the run in Thunders" link to the Test Run.
The sync button is only visible when the test case has a source mapping to an Xray issue. This mapping is created automatically when you import a test from Xray or create a test in Xray through Thunders AI. |
What Thunders AI can do with Xray
When Xray is connected and enabled, Thunders AI can work with the following Xray content:
Xray content | What Thunders AI can do |
Tests | Fetch a test by key, search across your test library, and read step definitions — step-based on both deployments, Gherkin on Xray Cloud. |
Test Plans | Retrieve a test plan and its associated tests or search for plans by name or criteria. |
Test Sets | Look up a test set or search across sets to understand how tests are grouped. |
Test Executions | Search past executions to review history and results. |
Test Runs | Retrieve run details and update run status. |
Preconditions | Fetch or search preconditions linked to your tests. |
These capabilities are available for both Xray Cloud and Xray Data Center, unless noted otherwise.
Disconnect Xray
Xray Cloud
To disconnect Xray Cloud, go to Configure > Connectors, open the ⋮ menu on the Xray Cloud row, and click Disconnect. You can also click Disconnect on its Manage page. This removes the credentials and disables Xray tools in Thunders AI.
Xray Data Center
Xray Data Center is automatically disconnected when you disconnect Jira Data Center. There is no separate disconnect action for Xray DC.