Come for the products,
stay for the community

The Atlassian Community can help you and your team get more value out of Atlassian products and practices.

Atlassian Community about banner
Community Members
Community Events
Community Groups

How to get subtasks of an EPIC in a filter query?

Hi all,

I'm sort of new with JIRA and I am trying to get a board that shows me all work related to an Epic. We are using Epics, Stories and Subtasks of the stories.

My query looks something like 

  • project = CXT AND "Epic Link" = CXT-2120

This way I am not able to display the subtasks on my filter/board.

The alternative would be to use tasks and then manually link them to the Story and to the Epic, which is additional admin work.

Is there something I am missing or is there anyway I can get the subtasks to show in the filter/board?


Thanks in advance.


4 answers

2 accepted

8 votes
Answer accepted

HI @Paulo Costa 

Welcome to the community.

This works in JIRA Cloud. Try it on your system.

project = CXT AND (issuetype = Story AND "Epic Link" IN (CXT-2120)) OR (issuetype = sub-task AND "parentEpic" IN (CXT-2120))

If it works, credit goes to Mark Klein  for the answer in this post. 

@Trudy Claspill , 

Cool information, I didn't know until now that parentEpic existed!

parentEpic - Search for issues and sub-tasks that are linked to an epic.

Thanks @Trudy Claspill , I have tried and still does not work. I've read the post you shared and also @Italo Qualisoni [e-Core] shared link, and as we are using JIRA Server, looks like we have to buy some add-ins.

If by any chance you have any other ideas I would appreciate.

Adaptavist Scriptrunner is a powerful app that extends JQL search functionality, plus provides many other features. I used it at my previous employer and really liked it.

If that offers more than you want and you are looking for something less expensive, check the Similar Apps links at the bottom of its marketplace page to see if any of those can help with extensions for searching.

Like Chris Buzon likes this

This just saved me a HUGE amount of time.  Thanks, Trudy!

Says parentEpic doesnt exsist?

Like Shaun Smith likes this

@Aaron Valleroy 

Welcome to the community.

Are you using a Jira Cloud instance?

Can you provide a screen image of what you see?

2 votes
Answer accepted


Sadly you cannot achieve the desired search using standard features on Jira, you must go for a third-party app instead. Using i.e. JQL Booster Pack (if you are on Server / DataCenter) you can type the following:


0) The Epic itself

key = CXT-2120

1) Subtask created directly on Epic

issue IN subtasksOf(' key = CXT-2120 ')

2) Find all tasks (Tasks, Stories,...) under a given Epic (i.e. CXT-2120)

"Epic Link" = CXT-2120

3) Find all subtasks under returned issues above

issue IN subtasksOf(' "Epic Link" = CXT-2120 ')

4) All together (Epic, Tasks & Subtask)

key = CXT-2120 OR "Epic Link" = CXT-2120 OR issue IN subtasksOf(' key = CXT-2120 OR "Epic Link" = CXT-2120 ')

(*) Note that this is just an example, you must tune above query to fit your needs.


Using this app you can also query other issues relations, check:



@Paulo Costa 

I realise it's a year later, but there's a command called "epicParent" that does just this:

parentEpic = EPIC-1


parentEpic in (EPIC-1, EPIC-2)

I hope this helps.


Thank you Paul, it actually worked!

Alternative solution:

I was facing the same issue I was looking for an answer too!
But I found a solution without the need of any additional Jira add-ons.

So if you want to have all stories & the sub-tasks of these stories in one JQL filter, you have to refer in your JQL filter to a structure.

So first create your structure e.g. "STRUCTURE_X"
In your structure you use as JQL query to insert all stories linked to that epic:
issue in linkedIssues("epic-1234") or ("Epic Link" = epic-1234)

Now you have a structure with all the stories linked to the epic.
What is still missing are the "subtasks"
So in your structure, you add -> Extend > Subtasks...

Now you have a structure with all stories and all subtasks connected to these stories.
So the structure results in Epic > Story > Subtasks


Now you go back to your quick filter:
and add the following JQL query: issue in structure("STRUCTURE_X")

=> That's how I was able to solve it on my end.. Hope it helps..

Suggest an answer

Log in or Sign up to answer

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