Showing results for 
Search instead for 
Did you mean: 
Sign up Log in

Next challenges

Recent achievements

  • Global
  • Personal


  • Give kudos
  • Received
  • Given


  • Global

Trophy case

Kudos (beta program)

Kudos logo

You've been invited into the Kudos (beta program) private group. Chat with others in the program, or give feedback to Atlassian.

View group

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

Display Sub-Tasks linked to an epic

This question is in reference to Atlassian Documentation: Why do subtasks disappear when I filter my board using Epic Links

Is there any JQL workaround to allow the display of all the sub-tasks of an epic, and not only the issues? I don't have any add-on. 

4 answers

The issues that display on a board are determined by 1) the saved filter and 2) the mapped statuses.  If you are querying by epic-link, only parent issues will be displayed since sub-tasks are not linked to epics.

You will need to tweak your filter to include sub-tasks.  Easiest way is to have the filter query all issues in a project.  If that is not the case, you will need to get creative - use the built-in JQL functions with Scriptrunner (if you have JIRA Server) to query sub-tasks linked to parents.


Hi Andrea, 

Thanks a lot for your answer. 

We indeed have an item workflow that works as follow : Epic --> Issues (Tasks) --> Sub-Tasks 

There is unfortunately no way for us to use only the Issues items and to reflect the relationship between our items in a satisfying way. 

Would you know free add-on that would open the same functionality than Scriptrunner? I would like to test out if JQL functions would fit what we are trying to achieve before starting to add costs. 


Thanks a lot for your help. 

Jack Community Leader Aug 11, 2016

the only way i have found to do this (cloud version) is using labels. so my filter looks something like this....

"Epic Link" = proj-111 OR labels = proj111


proj-111 is the JIRA issue # for the epic and proj111 is a label i place on all sub tasks. obviously this is flawed if and sub-tasks are missing the label. 

it continues to frustrate me that i can't have something like...

"Epic Link" in (proj-111) OR parent in (Epic Link = proj-111)

or maybe adding a new operator to JIRA like...

"Epic Link" in (proj-111) INCLUDE Sub-Tasks


Like # people like this

Yep, I still have the same Problem. Is there no solution yet?

Jack Community Leader Jun 20, 2018

not natively. you can use an addon like Scriptrunner or maybe EazyBI or others.

You can use parentEpic() function to show the sub-tasks that link to an epic.

See Advanced searching - functions reference - parentEpic().

Like # people like this

@Ting (Chiou Ting Teh), thanks for the tip, I'be been looking for a while for this solution!

Hi @Ting (Chiou Ting Teh).

Is the parentEpic() function only available for Cloud?  We're on 7.12.3 and I do not see that function available anywhere.  Any reason why that is? 

I wish parentEpic was usable on the gadgets. Any grids that have sub-tasks can only show their direct parent, but not their epic.

Like Chris Burgess likes this

In my case I use AM Utils (free add-on) to search all issues and subtasks on it:

A simple example:

issuekey in (issuesSubtasks("'Epic Link' = XXX-99")) ORDER BY Rank ASC

With this I can make boards that swinlanes with stories or projects besides the Epic Link. 

Works great. Also just adding the AM Utils add on, you can use the basic JQL (epic link in (CC) AND project = Myproject ORDER BY RANK ASC) 

Both solutions work but only after adding AM Utils.

Now AM utils are not free . This addon needs to be purchased . (just a 1 month free trial)

You can download and install version 1.3.21. I freezed it at that latest free version. There's no need to upgrade to a new paid version.

No need to upgrade to a paid version? There's always a dedicated support and development team behind an app that have to maintain docs, version compatibilities and do bug-fixes. Of course you need to update to a paid version if you want to keep using this. 

Atlassian has a costful update program for a worse support system that makes you wait years for a pratical solution. Same to apps that after a year you have to buy a new expesive license if you need updates. Even jira source owner can't compile it to make customizations, because atlassian wants you to pay for that. Then, no complain, pay for that. I prefer use the free version that works and atends.

Hi Guys, 

You can vote on this issue A subtask cannot be assigned to an epic




Hey @Benoit MARIE - PLease try the following macro. Please note that for this to work you have to LABEL with the EPIC LINK ID and assign a COMPONENT to the SUB TASK. 

project = CC AND labels = CC-1 AND component = ComponentName OR issueFunction in subtasksOf("component = ComponentName ")

This will pull only Subtasks assigned to the specific Component and Label.




Jack Community Leader Dec 17, 2020

FWIW, i caution against such an approach as it invariably will be unreliable in time as individuals forget to add the label or misspell the label, etc. If someone does wish to go this approach I highly recommend using Automation to control the environment a bit. e.g. Trigger - issue created, Conditions: issue type, has epic link, etc., Action - add label using smartvalue to borrow from epic name or such. 

p.s. to be clear the suggested solution is a JQL query not a macro.

Like Gabriel Carlos likes this

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