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

Why do I get a blank bullet point as the first item of the TOC?

Deleted user Mar 10, 2017

This question is in reference to Atlassian Documentation: Table of Contents Macro

Every time I use this macro, it shows an empty/blank entry as the first item of the list.

I don't know why this appears!

5 answers

1 accepted

14 votes
Answer accepted

Make sure that there isn't an empty line above your first header, or make sure that everything (macros, tables, etc.) are set to the Paragraph style.

Deleted user Mar 12, 2017

The first line in the article, the one with the TOC macro on it, was set to Heading 2.

Changing it to Paragraph got rid of the blank bullet point item within the rendered TOC.

Like # people like this

To be more specific, my issues was that the Table of Contents as being formatted as a Heading 1, which was not immediately obvious. This caused the TOC to count as the first entry.

Like # people like this

This is what I needed! I ensured the fix by deleting my table of contents macro and then inserting it again.

Like Gaj Umapathy likes this

Actually, the correct answer is rather simple: 

Set the level to 1 instead of 0, this level 0 does not exist and is AFAIK a bug that has been reported but is still unresolved.

Thus, no bothering about spaces before or any strange stuff, just set the header level to 1. 

You can see that BTW in the preview, thus just play around with that, nothing will break :)

I had this same problem, even after making sure I wasn't typing anything extra and after already setting the TOC line of the document to be "Paragraph" style.  What finally worked for me was the following. Go to the "Edit 'Table of Contents' Macro" pop-up window (this pops up when you insert a new TOC, or when you double-click the icon for one you've already added), scroll down to the "Exclude Headings" field and enter the two characters w* here.  This essentially tells Confluence to leave out any bullet points that appear blank.

Yes! this helped me.

Make sure the TOC macro is set to paragraph level. By default it is set to H2 and this causes an empty bullet in the list.

Make sure the TOC macro is set to paragraph level. By default it is set to H2 and this causes an empty bullet in the list.

Screen Shot 2021-01-25 at 2.13.18 PM.png

This helped to understand the fix and actually fix it in no time. Thank you!

Great! That's the root cause.

Yes.. This worked for me.

Atlassian, why not make the TOC automatically set it's own heading to "Table of Contents" so you can avoid people setting it to paragraph level in the first place to fix a problem with a default behavior?

Why? Because the MVP/excuse-to-leave-applications half-***ed development mentality pervades even relatively pricey commercial products. As always, thanks Atlassian. Oh, unless there's a good reason a user would want a blank bullet to head their TOC? ¯\_(ツ)_/¯ 

Like EMCC Atlassian likes this
0 votes

In the 'Exclude Heading' option, give  this regular expression ^$ (to exclude empty item in the list)

Sorry guys, its working only in preview, not after publishing!

Suggest an answer

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

Confluence: Where work and wellness meet

Feeling overwhelmed by the demands of work and life? With a 25% increase in the prevalence of anxiety and depression worldwide during the pandemic, for most of us, it’s a resounding yes . 🙋‍♀️ ...

924 views 13 27
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