Is it possible to display epic and related stories in confluence using Jira Issue
Asked by Stephane Renou:

I would like to get an array with all my epics and in one column to get the stories that have that epic.

I am looking for the same kind of display that I can get with Link for example when I link 2 stories.

Epic Link is going the over way around, Link does not show the user stories.

Just to clarify, the output would be

on the line, the epic name and the columns would be the story status, like Opne, in progress, Done.

Then each column would contain the number of stories that are in that status.

Thanks for any help.


Answers:
author: Ryan Fauth
body: To display all the stories within an epic, you can use the Jira Issue/Filter add-in. Use the Epic Name in the filter, ie: "Epic Link" = EN-123.

comments: author: David Knapp
body: thanks [@Ryan Fauth](/t5/user/viewprofilepage/user-id/614948) that worked for me.


author: Luis Frias
body: Worked for me too, thanks [@Ryan Fauth](/t5/user/viewprofilepage/user-id/614948) .


author: Noah Hofmann
body: In my case this only displays the epic itself, but not its contents.Does anybody have a similar issue?


author: Anthony Coleman
body: [@Noah Hofmann](/t5/user/viewprofilepage/user-id/3917128) - please take a look at the following and my responses on this thread. It should help.

AC

1. Jira Issue/Filter add-in: Use the Epic Name in the filter, ie: "Epic Link" = EN-123.
2. JJira Issue/Filter add-in: "Insert JIRA Issue/Filter" tool in Confluence, use Search and type in: "key = ecom-167 OR parent = ecom-167".  
   NOTE: ecom-167 is the Epic and this will pull in the epic as well as all child tasks.
3. Jira Issue/Filter add-in: "Epic Link" = epic#### ORDER BY issuetype DESC
4. Jira Issue/Filter add-in: issueFunction in issuesInEpics ("issue = epic####")


author: Renee
body: Using this Jira Issue/Filter add-in and when displaying the child cases of the parent Epic, is there a way to SORT the order of those child cases to how they are listed in the Jira Epic?


author: Anthony Coleman
body: Ok, someone from Atlassian, PLEASE, try your best to either provide a yes or no answer, to the above thread or this response. Since we are all in IT, I have summarized the questions/requests below to make it easier. I have added a simple YES or NO option.  

Please respond with either because it can't be both.

1. Yes = Within Confluence it is possible to import an Epic with all related Story's ("Issues in Epic"), nested below an Epic page (see image below #1), with "ISSUES" located in their own Confluence page.
   1. IF YES, please included detailed steps, with screenshots, links to existing documentation, that answer only this thread.

OR

1. No = not possible, at this time.

So, is it YES or NO?

Thanks,

AC

**NOTE**: Attached is a visual representation because it seems that typed questions/requests are not being received very well. I even added a numbered list (1., 2., 3.) so you couldn't get lost.

1. (We want this below!)
2. ![Epic Structure.png](https://community.atlassian.com/t5/image/serverpage/image-id/129199i59AD589184D7A994/image-size/large?v=v2&px=999 "Epic Structure.png")
3. BUT WE ARE GETTING THIS!!

![JireFilter.PNG](https://community.atlassian.com/t5/image/serverpage/image-id/129196i8744CA8D5F339C98/image-size/large?v=v2&px=999 "JireFilter.PNG")  


author: Katerina Rudkovskaya [Stiltsoft]
body: Hello,  

We can recommend you our [Table Filter and Charts for Confluence](https://marketplace.atlassian.com/apps/27447/table-filter-and-charts-for-confluence?hosting=cloud&tab=overview) app to work with Jira Issues macro in your cases.

You'll be able [make pivots](https://docs.stiltsoft.com/display/public/TFAC/How+to+use+Pivot+Table+macro) to count, for e?ample, the numbers of issue types and display issues per assignee (or user stories per epics), also [sort](https://docs.stiltsoft.com/display/public/TFAC/Sorting%2C+freezing+and+other+table+viewing+options) your issues on the fly like in Excel, save the required [filters](https://docs.stiltsoft.com/display/public/TFAC/How+to+use+Table+Filter+macro) for other users and even [transform](https://docs.stiltsoft.com/display/public/TFAC/How+to+use+Table+Transformer+macro) and [visualize](https://docs.stiltsoft.com/display/public/TFAC/How+to+use+Chart+from+Table+macro) data.  

<br />

![2020-07-20_15h33_47.png](https://community.atlassian.com/t5/image/serverpage/image-id/103660i63574567CA0E210E/image-size/large?v=v2&px=999 "2020-07-20_15h33_47.png")

Here are some examples of [dashboards](https://docs.stiltsoft.com/display/public/TFAC/Using+Table+Filter+and+Charts+in+Combination+with+the+Jira+Issues+Macro) created using the Jira Issues macro and the Table Filter and Charts for Confluence app.  

If your Confluence instance is Cloud, you'll need the [Table Toolbox](https://docs.stiltsoft.com/display/public/TFAC/How+to+use+Table+Toolbox+macro) macro to nest other macros. Other steps are the same.  

Best regards,  
Katerina  
Stiltsoft


author: Peter Tresenreiter
body: 1. Go to the advanced search in your JIRA Project with the epic

2. click on "+ more"

3. check the entry "Epic Link"

4. search for the epic(s) you want to have in your conlunce table

5. once you configured the filter as you want, copy the link of the address bar

6. go to your confluence page

7. Insert Jira issue/filter

8. paste the link in the box

9. display options: configure the the table as you want

[@Kyle Lubieniecki](/t5/user/viewprofilepage/user-id/3560483) [@Aleksandr_Makarov](/t5/user/viewprofilepage/user-id/1412212) @

comments: author: Aleksandr_Makarov
body: Hi [@Peter Tresenreiter](/t5/user/viewprofilepage/user-id/3621886) thanks for your answer, however, it seems like you didn't get what we are looking for.

I'm looking to build the table which will show me all my epics for the project with the breakdown to user stories that belong to each epic and ideally their status.

I can't put the table to this comment, so something like that:

1. Epic 1 - Open
   * User Story 1 - Open
   * User Story 2 - Open
2. Epic 2 - In Progress
   * User Story 3 - Open
   * User Story 4 - In Progress
3. Epic 3 - Done
   * User Story 5 - Done
   * User Story 6 - Done

Epic is the first column, linked user stories are in the second column.


author: Christoph Purnomo
body: I figured out a work-around that may work for you. It works for me and I was looking for a similar setup.

When using the "Insert JIRA Issue/Filter" tool in Confluence, use Search and type in: "key = ecom-167 OR parent = ecom-167".

NOTE: ecom-167 is the Epic and this will pull in the epic as well as all child tasks.

![Screen Shot 2020-07-17 at 5.53.16 PM.png](https://community.atlassian.com/t5/image/serverpage/image-id/103535i7C3E06EFA16CB4CC/image-size/large?v=v2&px=999 "Screen Shot 2020-07-17 at 5.53.16 PM.png")

comments: author: Christoph Purnomo
body: the proposed one did not work for me, but this filter did:

"Epic Link" = \[insert JIRA Epic number here\]

it seems it depends on the individual jira configuration, so just check with your admin, which parameter could be used. the filter basically just uses the filter that is used for issue search in order to create lists matching a certain criteria.


author: Christoph Purnomo
body: btw, I don't really understand, how atlassian fails to give proper support to this issue, which seems to be a pretty common request. They misunderstand the question, give standard answers via links or simply don't reply (?)


author: Borja Fdez_
body: +1


author: Tony Karalis
body: parent = parentid is the only thing that works for us \\o/.


author: Manuel Gass
body: thanks [@Christoph Purnomo](/t5/user/viewprofilepage/user-id/4033603) your solution worked fine for me:

I now have a list of tickets linked to the epic. There is no visible mention of the actual epic (which would be nice for a dashboard with various epics). But it does the job for one epic.


author: Amurafa
body: Our company Jira Admin just provided me with this solution and it worked great!

Use a Jira filter with the following query

issueFunction in issuesInEpics("issue = xxxxxx")

comments: author: Anthony Coleman
body: Hi [@Amurafa](/t5/user/viewprofilepage/user-id/4268548) - would you mind posting a screenshot of the final results as they appear in Confluence? Remember we are all looking for the solution to get ALL related stories nested under an epic, within Confluence.

Also, is xxxxx = epic #?

Thanks!

AC


author: Amurafa
body: [@acoleman](/t5/user/viewprofilepage/user-id/4186360) sorry can't share a screenshot as the issues contain proprietary company info, but yes, the query results in all issues created under the epic displaying in a table format.

yes, xxxx is the epic # (issue key in Jira)


author: Michael Ludvigson
body: if you're mentioning like this, doesnt seem to be working, unless I'm missing something?

issueFunction in issuesInEpics("issue = XYZ-1234")


author: Amurafa
body: It may be dependent on the Confluence version as well. I am on the server version 7.4.5

![2021-02-17_11-23-26.png](https://community.atlassian.com/t5/image/serverpage/image-id/130909iF683FB257A45E27F/image-size/large?v=v2&px=999 "2021-02-17_11-23-26.png")


author: Anthony Coleman
body: [@Amurafa](/t5/user/viewprofilepage/user-id/4268548) - yes, so I can pull all related "issues" within an epic using a similar query ("Epic Link" = xxxxx ORDER BY issuetype DESC).

But everyone on the thread is looking for a solution that will nest stories within their ++**own** ***confluence page***++ ++**under parent epic page**++. Something similar to the attached snapshot. A query that pulls an epic's related "issues" is simple \& elementary but we are all looking for a next level solution.

Also, when querying an epic which lists issue on the same page, users are unable to edit those stories directly in confluence, if you try to edit a story within confluence, you are redirected to JIRA but this is probably a separate topic.

![Epic Structure.png](https://community.atlassian.com/t5/image/serverpage/image-id/129199i59AD589184D7A994/image-size/large?v=v2&px=999 "Epic Structure.png")


author: Michael Ludvigson
body: there's the issue. i'm not using server version, therefore it wont work.


author: Anthony Coleman
body: [@Michael Ludvigson](/t5/user/viewprofilepage/user-id/4238174) - you may want to try some of the queries listed in this thread, I went thru the thread and found a few that may work, included my own. Hope this helps!

1. Jira Issue/Filter add-in: Use the Epic Name in the filter, ie: "Epic Link" = EN-123.
2. JJira Issue/Filter add-in: "Insert JIRA Issue/Filter" tool in Confluence, use Search and type in: "key = ecom-167 OR parent = ecom-167".  
   NOTE: ecom-167 is the Epic and this will pull in the epic as well as all child tasks.
3. Jira Issue/Filter add-in: "Epic Link" = \[insert JIRA Epic number here\]
4. Jira Issue/Filter add-in: "Epic Link" = epic#### ORDER BY issuetype DESC
5. Jira Issue/Filter add-in: issueFunction in issuesInEpics ("issue = epic####")


author: Michael Ludvigson
body: [@Anthony Coleman](/t5/user/viewprofilepage/user-id/4253644) thank you very much for the assistance. tried all of those and its just not pulling the info like we need. we're using cloud version, not server, and I'm wondering if that might be part of the issue. looks like you nailed it when you said you wanted them nested, that's what we're looking for too.


author: Anthony Coleman
body: [@Michael Ludvigson](/t5/user/viewprofilepage/user-id/4238174) - unfortunately it does not seem possible unless Atlassian provides custom code \& query in a new macro.

But as I mentioned above, this only solves half the problem because even if it was possible nest stories on their own pages in confluence within an epic hierarchy, it most likely would just be a link to the story "issue" and the fields within the story "issue" would not be editable. The ability to edit an epic or stories fields within confluence and have the changes sync'ed to JIRA, would truly be a next level solution, . It's surprising the Atlassian hasn't made this ability native to their products because both confluence \& JIRA are complimentary of each other. I will keep searching for a solution and will post here if I ever discover the magic key. Thanks!


author: Michael Ludvigson
body: [@Anthony Coleman](/t5/user/viewprofilepage/user-id/4253644) i would even take the nesting for now! thanks for your help.


author: Anthony Coleman
body: [@Michael Ludvigson](/t5/user/viewprofilepage/user-id/4238174) - I might have found a work-around for the 2nd problem, editing stories "issues" in confluence. Check out this plug-in on the marketplace: [Issue Manager for Confluence \| Atlassian Marketplace](https://marketplace.atlassian.com/apps/1216691/issue-manager-for-confluence?hosting=server&tab=overview) ([https://marketplace.atlassian.com/apps/1216691/issue-manager-for-confluence?hosting=server\&tab=overview](https://marketplace.atlassian.com/apps/1216691/issue-manager-for-confluence?hosting=server&tab=overview))

It allows for creating \& editing 'issues' within confluence and sync'ing to JIRA. It looks pretty nice but it only supports editing the following list of fields:

[Issue Manager User Guide 1.3 (seibert-media.net)](https://info.seibert-media.net/display/DOC/Issue+Manager+User+Guide+1.3#IssueManagerUserGuide1.3-fieldtypes) (<https://info.seibert-media.net/display/DOC/Issue+Manager+User+Guide+1.3#IssueManagerUserGuide1.3-fieldtypes>)

[Confluence apps \| Atlassian Marketplace](https://marketplace.atlassian.com/search?hosting=server&product=confluence&query=jira%20issues) ([https://marketplace.atlassian.com/search?hosting=server\&product=confluence\&query=jira%20issues](https://marketplace.atlassian.com/search?hosting=server&product=confluence&query=jira%20issues))

Good luck!

A

![List_of_fields.PNG](https://community.atlassian.com/t5/image/serverpage/image-id/131096iB160B55DDD564371/image-size/large?v=v2&px=999 "List_of_fields.PNG")


author: Ryzwan Taheraly
body: Same thing, waiting for solution


author: keessun.fokeerah
body: Also looking for this possibility


author: Chris Gado
body: Also looking for this same functionality. Seems it is still outstanding


author: Guest User
body: I am also looking for this. If anyone has any feedback on this please provide. Thank you!


author: audrey.brown
body: This question was asked back in 2014. Has anyone in Atlassian looked into this? If the functionality is not available please let me know. I also looked into exporting our backlog data to then copy and paste into a Confluence report so that I can display Epic Name and Story together, no joy here either. Without the Epic name our sprint/issues are meaningless to Senior Management.


author: Kyle Lubieniecki
body: Anything here? I'm also looking for it.


author: Jason A Delmarr
body: 1. Create advanced filter in Jira

```
"Epic Link" = Name of Epic
```

\* Name of Epic will probably change to an ID automatically, nothing to worry about.

2. Insert Jira issue/filter macro to a confluence page using

```
filter = "Name of Epic" ? ???
```

2.b Set display option to Table.

![Screen Shot 2018-08-17 at 2.31.57 PM.png](https://community.atlassian.com/t5/image/serverpage/image-id/29878i786DDB3C75FF63BB/image-size/large?v=v2&px=999 "Screen Shot 2018-08-17 at 2.31.57 PM.png")


author: rrudnicki
body: Hello Stephane,

Maybe this link below have additional information which you are looking for:  

[](https://confluence.atlassian.com/display/AGILE/Linking+a+Confluence+Page+to+an+Epic)<https://confluence.atlassian.com/display/AGILE/Linking+a+Confluence+Page+to+an+Epic>

If you need more information, please let me know.

All the best,

Renato Rudnicki

comments: author: Stephane Renou
body: Thanks, I also reviewed that page and it is describing how to create a link between an epic and a confluence page. What I am looking for is how to add to a confluence page a Jira report that would contains all the epics and in each epic row the list of user stories that are connected to the epic, the same way you can list jira stories and their linked stories.


author: Yulia Alexandrova
body: +


author: rclakmal
body: Need this feature badly!


author: Denis Mamontov
body: I was trying to solve the same issue today. Jira doesn't provide an out-of-box solution.

It can be achieved with [Structure](https://marketplace.atlassian.com/apps/34717/structure-project-management-at-scale?hosting=cloud&tab=overview) addon.

1. Select a top-level of your structure
2. Click the "Automation" button
3. Click the "Plus" icon and select an "Extend" option
4. Click "Stories under epics..."

It will show you all of the issues under an epic, which you can further filter out by JQL.

The plugin provides several views. One of them is Tracking. It shows a percentage of completion for each epic, based on the issues that are linked to that epic.

Quite brilliant!

![Structure - Jira.png](https://community.atlassian.com/t5/image/serverpage/image-id/94005iCECE21FB62A6B4F9/image-size/large?v=v2&px=999 "Structure - Jira.png")

comments: author: Michael Ludvigson
body: are you using this with the cloud or server version?


author: Denis Mamontov
body: This was on the Server version.


author: Deb Laurendeau
body: I am also looking for this in the cloud version. I successfully created a Structure in the hosted version that listed all Features with Stories nested underneath but can't create in cloud.

comments: author: Arianna SunBear
body: dLaurendeau, I also am trying to do this in Confluence server.

When you refer to "structure", do you mean you were able do incorporate the output of multiple epics with nested stories/features in one go, or did you have to do it per epic? If the former, I would love to lean how you did it!


author: Deb Laurendeau
body: Yes, in the hosted version I could create a list of all Features (or a subset if I didn't want to see all - in the hosted version we have Features that are equivalent to cloud epics). A structure is a container that could hold Features. There was a down arrow available and I could expand one or more Features and see all the stories underneath them. I could choose the columns that would show across the screen. I am now on Jira Cloud at my current gig and there are no Structures available.

I can use a query in Confluence with "parentepic" and I can get multiple epics and all of their associated stories but the stories don't nest under the epics. The alternative is to create multiple "parentepic" queries on a single Confluence page. It works, you can get an epic with all the associated stories nested under it but each query will have a different width for the same column and the Confluence page looks messy. That said, it does work.


author: Aleksandr_Makarov
body: Looking to do the same, seems like there is no such ability


author: Ganesan Srinivasan
body: Hello would love to ask if there a solution for this too? I used linkedIssues() function but it is only for a specific user story issue.

I hope anything from here have an idea. Thank you!

comments: author: Ganesan Srinivasan
body: I have the same need, display the epic name, issue name in a single list. Only thing that seem to be appearing is the issue link and it is just displaying the epic key. I would like to pull the epic name on to the report. I find JQL working while executing from JIRA, it is just that confluence is not displaying it.


author: Anthony Wijnen
body: Have you found the answer [@Stephane Renou](/t5/user/viewprofilepage/user-id/716647)? Looking to do the same here.

<br />

Thanks in advance!

Gr,

Anthony

comments: author: David Knapp
body: I am looking for the same on my project overview page I want to put in one link/Jql/etc in Confluence that will list the EPIC \> and auto feed in all of the Stories within [@Stephane Renou](/t5/user/viewprofilepage/user-id/716647) [@Anthony Wijnen](/t5/user/viewprofilepage/user-id/1146044)


author: Dean Wheatley
body: I'm also looking for the same feature. This is one of the first things you look for after creating Epics and assigning stories to them (i.e. a unified view)


author: Septa Cahyadiputra
body: Hi Stephane,

Please review our documentation below regarding JIRA agile and Confluence integration:

[](https://confluence.atlassian.com/display/DOC/Working+with+JIRA+Agile+in+Confluence)<https://confluence.atlassian.com/display/DOC/Working+with+JIRA+Agile+in+Confluence>

I hope the mentioned feature above fulfill your requirement on this.

Cheers.

comments: author: Stephane Renou
body: Thanks, I initially identified that page as well but could not find a way for me to display in a confluence page all the active epics and in one column of the array, all the user stories related to those.


author: David Knapp
body: I am looking for the same on my project overview page I want to put in one link/Jql/etc in Confluence that will list the EPIC \> and auto feed in all of the Stories within [@Anthony Wijnen](/t5/user/viewprofilepage/user-id/1146044) [@Stephane Renou](/t5/user/viewprofilepage/user-id/716647)


Tags: jira-software