Uploaded image for project: 'Confluence Cloud'
  1. Confluence Cloud
  2. CONFCLOUD-72469

Table of Contents macro is not working with the excerpt and excerpt include macros

XMLWordPrintable

    • 16
    • 8

    • Our product teams collect and evaluate feedback from a number of different sources. To learn more about how we use customer feedback in the planning process, check out our new feature policy.

      PM's response

      Hi everyone,

      I’m Tiffany and I’m a product manager on the Confluence team. We would like to thank you for your comments about the way the Table of Contents macro works within the Excerpt and Excerpt Include macros.

      We designed the Table of Contents macro to only work within the page, blog or macro it has been inserted. It cannot reference or be referenced across multiple pages or blogs, meaning that when it is added to an Excerpt macro, it will only display headings located inside the excerpt. Those heading links won't navigate to the source page.

      Based on that, the functionality reported for Table of Contents Macro is actually not a bug, it is working as expected, which we also updated the documentation to reflect it:

      https://support.atlassian.com/confluence-cloud/docs/insert-the-table-of-contents-macro/

      I have thus made note of this expected behavior in the Table of Contents documentation and converted this bug to a feature request so that you can track our progress.

      Best,
      Tiffany

      Issue Summary

      If you add a Table of Contents inside an Excerpt macro, the TOC won't load on the page. If you add the Excerpt include macro on another page to display this TOC, it won't display in there as well. 

      Steps to Reproduce

      1. Create a page (Page A).
      2. Add headings to it.
      3. Add an Excerpt macro.
      4. Place a TOC macro inside the Excerpt macro.
      5. Publish the page.
      6. Create a new page (Page B).
      7. Add an Excerpt Include macro, configured to display the Excerpt created on Page A.

      Expected Results

      Since the Excerpt is not configured to hide the content, the TOC should load on both pages:

      • Page A.
      • Page B.

      Actual Results

      The macro doesn't load on any of the pages.

      Workaround

      Currently there is no known workaround for this behavior. A workaround will be added here when available

        1. image-2021-12-07-13-58-21-234.png
          image-2021-12-07-13-58-21-234.png
          29 kB

              smalkireddy@atlassian.com Siddharth Reddy Malkireddy
              edc026a7b429 Vitor A (Inactive)
              Votes:
              210 Vote for this issue
              Watchers:
              118 Start watching this issue

                Created:
                Updated: