With the Backbone Xray Connector you can enable Backbone Issue Sync to synchronize certain issue types and issue fields of the Xray Test Management app. Our connector is an extension using Backbone's public Java API and it must be installed as a separate add-on in your Jira. After installation of the Backbone Xray Connector, you'll be able to configure and synchronize Xray fields using the configuration of Backbone Issue Sync.

The Backbone Xray Connector is not a standalone app for Jira. It only works if you install it together with the apps Backbone Issue Sync and Xray Test Management.

Supported Xray Components

Supported Xray issue types

  • Test
  • Pre-Condition
  • Test Set
  • Test Plan
  • Test Execution *

* Only a limited set of data is supported for this issue type. Please see details below for supported issue fields.

Supported Xray issue fields

You can configure field mappings for the following Xray custom fields:

  • For issue type Test
    • Test Type
    • Cucumber Type
    • Cucumber Scenario
    • Generic Test Definition
    • Manual Test Steps *
    • Link to requirements (you have to map Linked Issues for this field)
    • Test Sets association with a Test (Link to test sets *)
    • Test Plans associated with a Test (Link to test plans *)
    • Pre-Conditions association with a Test (Link to pre-conditions *)
  • For issue type Pre-Condition
    • Conditions
    • Pre-Condition Type
    • Tests association with a Pre-Condition (Link to tests *)
  • For issue type Test Set
    • Tests association with a Test Set (Link to tests *)
  • For issue type Test Plan
    • Begin Date
    • End Date
    • Tests associated with a Test Plan (Link to tests *)
  • For issue type Test Execution
    • Only standard Jira fields are synchronized and bugs found during a test execution (and therefore linked to a Test Case) are synced including their links

* Changes to these issue fields are not detected automatically. Hence these fields can only be synchronized by changing another field in the test issue (like updating the description or adding a comment) or by performing a resync.

Unsupported Xray issue types and/or fields:

  • Test Repository

Supported Versions

We support the following combinations of different app versions:

  • Backbone Xray Connector 1.0.0 or higher
  • Backbone Issue Sync 4.0.0 or higher
  • Xray Test Management 3.3.6 or higher

For the Backbone Xray Connector all Jira versions are supported which are also supported by Backbone Issue Sync and Xray Test Management. Jira 7.0 up to 8.2 versions are tested and verified. Additional or newer versions will be tested on demand.

How to Synchronize Xray Fields

In order to synchronize these issue types and fields, you have to add them to your regular Backbone synchronization configuration. This works as usual and most of the provided Xray field mappings can be added as a simple field mapping. However, a few field mappings require some further configuration. The following shows an example for the Manual Test Steps:

(Click on Configure)

(Select Use Backbone's Connection, click on Next and Save)

A certain number of field mappings requires that you explicitly give permission to the field mapping that it can use Backbone's connection. This is necessary so that the Backbone Xray Connector can perform requests to Jira on the behalf of the synchronization user. If you do not give consent to this configuration option, you can't use the field mapping.


Do you have questions or something is not working as expected? Please let us know and create a ticket in our support system or write an email to support@k15t.com.

If you're also interested in the Backbone Xray Connector, please contact us via sales@k15t.com.