It's not the same without you

Join the community to find out what other Atlassian users are discussing, debating and creating.

Atlassian Community Hero Image Collage

Can I roll a Story test coverage status up to its parent Epic?


Considering an example where I create two Stories under an Epic. Now, I create some Xray tests under each Story so that the Story requirements are covered.

When I go back to the Story's parent Epic, is there a way to determine the requirement coverage at the Epic level (I have not created any Xray tests directly under Epic though)?



1 answer

Hi Avimanyu,

Yes, Xray supports the notion of parent and sub-requirements as long as they are both configured to be handled as requirements.

Please have a look at this blog post which details this in full detail:


Best regards,

Xray Team

Hi Xray Team,

Thank you for your response. The documentation you have shared does clarify my query for Epic-Story relation.

I have an additional related query.

I have created a new custom issue type (or a third-party add-on issue type) which sits above Epic issue so that multiple Epics can be grouped together.

In this case, how would I map my custom issue type to Epics as Xray requirement sub-requirement coverage?

Hi Avimanyu,

Officially, Xray currently provides two levels of hierarchy for "requirements"; that hierarchy may be configured in multiple ways as detailed in the blog post or in our documentation page: .

There is a small caveat though; you may enable the Epic/Story relation and an additional parent/sub-requirement relation, based on a specific issue link that you define.

image-2018-07-05-18-52-19-446.pngThis will allow you to evaluate the coverage on the upper entity (taking into account all the coverage for all the descendant requirement), although the reports won't show the complete hierarchical relation. Again, this is something possible but it's not really an official feature since it's not fully implemented in a consistent manner.


Best regards,

Xray Team

Like Tim Schächterle likes this

Hi, in our case we also may use more than 2 levels.

What are the current restrictions?

Will it be an official feature in future?

Regards, Tim

Hi Tim

As of v3.3, Xray officially supports two levels of requirements using one of the relations mentioned here: 

We do have multi-level support for coverage analysis, including for our Traceability Report, in our backlog: 

Please review and vote on it, so that we are able to track your interest on it.

Best regards,

Xray Team

Suggest an answer

Log in or Sign up to answer
Community showcase
Published in Marketplace Apps & Integrations

Join our Webinar: 5 use cases to supercharge Jira with apps

G’day Atlassian Community! We’re excited to announce that we’ll be doing a new webinar on 5 use cases to supercharge Jira Cloud. The Atlassian Marketplace offers customers thousands of apps and int...

130 views 1 4
Read article

Community Events

Connect with like-minded Atlassian users at free events near you!

Find an event

Connect with like-minded Atlassian users at free events near you!

Unfortunately there are no Community Events near you at the moment.

Host an event

You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events

Events near you