Table of Contents macro within an article displays in Confluence but not when viewed from an issue

I've created an article in confluence which includes the use of a table of contents macro, it appears to work fine when published and viewed from confluence but when I click on the article form within an issue, the table of content is not displaying, has anyone else had this issue and have information to solve?


view from confluence:

View Confluence.JPG

View from opening link within an issue:View Issue.JPG

1 answer

This widget could not be displayed.

Hi Karen

It does appear to be a known issue where the Table of Contents Macro is not displaying within the Service Desk Customer Portal:

Could you please place a vote on that bug? It helps us keep track of the users who have run into the issue. I would also recommend watching the issue so you can be updated of any changes.

Let me know if you have any questions.



I have voted and will watch.  Additional question, I read the work-around:

           Workaround - Open the page in a different tab to view the macro.

I tried searching in documentation on how to set this up within the article, I haven't found it - can someone provide a link or instructions?


Hi Karen,

It just means to open the Confluence page directly in another tab in your browser. Once you view the article via Confluence and not Service Desk you should be able to see the Table of Contents macro.



I think there is a misunderstanding.  Yes I am aware while I'm in Confluence the ToC macro does work.  My issue is that from any place else (ex. Portal, Service Desk) which is where the issue is, I want to enable the work around so that the when the person clicks on the link to open the article, it pops up in another tab (as you are suggesting).   I am not clear where to change that action.

Hi Karen,

To change the action would require programming knowledge, as you would need to go into the Jira Source Code and change the behavior of the knowledge base. I wouldn't recommend making such a change as a workaround to a bug.

The workaround in the bug only refers to the action of opening it in Confluence manually, and wasn't suggesting that the user modify the Jira source code to change the behavior.

I hope this is clear enough but do let us know if you have any questions.



This workaround doesn't address the problem that is identified in both  JSDSERVER-3565 or what I posted, so I'm confused regarding your response.  Your response is talking about "only refers to the action of opening it in Confluence manually" (I'm not clear on the "manually" part)  which isn't actually an issue - I see the ToC just fine in Confluence.  

So unless I'm missing something there is no work around (which is fine) but let's update this to reflect correctly. 

If I have understood this all correctly, I will go back and modify to have links vs. using the ToC Macro.

Hi Karen,

It is correct that if you only want to view the TOC via Service Desk, then there is no workaround. You will want to modify your links.

However, if you just need to have users view it, then it can be opened in Confluence.


Suggest an answer

Log in or Sign up to answer
Community showcase
Posted Monday in Confluence

Why start from scratch? Introducing four new templates for Confluence Cloud

Hi my Community friends!  For those who don't know me, I'm a product marketer on the Confluence Cloud team - nice to meet you! For those of you who do, you know that I've been all up in your Co...

291 views 2 4
Join discussion

Atlassian User Groups

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

Find a group

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

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you