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. No separate credentials needed. |
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 and go to the Connectors page.
Find the Xray for Jira tile and click Connect.
Enter your Xray Cloud Client ID and Client Secret.
Click Connect. 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.
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
You: 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 is visible as in the source part in the test case properties panel, showing the synced-to-Xray state. You can detach the link from the test if needed.
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
You: 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.
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.
Result sync is currently available for Xray Cloud. For Xray Data Center, Thunders AI can update the status of individual test runs on request, but the one-click execution push is not yet available.
How to sync
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.
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.
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 the Connectors page, find the Xray for Jira tile, and click Disconnect. 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.