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

Using jump links in Table of Contents macro to navigate Children Display macro


I have a space containing several hundred pages, and I'm attempting to create a catalog of these pages and some of their content excerpted using a the Children Display macro, Excerpt Include macro and the Table of Contents macro.

When rendering the Children Display macro for a parent page I get the following structure:

<Parent 1 title>

  • Child 1
    <Child 1 excerpt>
  • Child 2
    <Child 2 excerpt>
  • Child 3
    <Child 3 excerpt>
  • .....

<Parent 2 title>

  • Child 1
  • ....

where all children consist of <h3> elements linking to the specific page, along with a pre-defined excerpt. In addition, I have a header denoting which parent page these children belong to.

Now, with hundreds of pages, I want to be able to navigate the catalog using the Table of Contents macro. The macro renders fine, but I am only able to use the jump links for my parent titles. This seems to be because the child links do not get assigned an id:

<a href="#" class="toc-link">Child jump link</a>

Whereas the parent titles do:

<a href="#Parent-title" class="toc-link">Parent title</a>

 Is there any way of forcing the Children Display macro to assign IDs to its children links? If not, are there any other workarounds for achieving a catalog such as this?

Any help is greatly appreciated.

0 answers

Suggest an answer

Log in or Sign up to answer
Community showcase
Published in Confluence Cloud

Presenter Mode for Confluence is here 🖥 👩‍💻

👋  Hello Community!  My name is Stephanie Zhang, and I’m a product manager on the Confluence cloud team. Today, I’m excited to announce the rollout of  Presenter Mode : a ...

80,429 views 126 304
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