Showing results for 
Search instead for 
Did you mean: 
Sign up Log in

Next challenges

Recent achievements

  • Global
  • Personal


  • Give kudos
  • Received
  • Given


  • Global

Trophy case

Kudos (beta program)

Kudos logo

You've been invited into the Kudos (beta program) private group. Chat with others in the program, or give feedback to Atlassian.

View group

It's not the same without you

Join the community to find out what other Atlassian users are discussing, debating and creating.

Atlassian Community Hero Image Collage

Finding updated documents for Cloud

I just convinced my company to use confluence but I'm also a new user. I'm having a very hard time as most of the documents are old, nothing I read on the guidelines works. To be honest, I'm very disappointed as Confluence is for documentation, and Atlassian documentations are just terrible for their own product. So here's the issues I'm having, making a simple page:

1. Table of content does not show anything on the preview page. On edit macro, it only shows Heading 1 title, while the max is set to 7.

2. Anchors are removed, I managed to find that in another question, but the workarounds do not work either.

3. Typing curly brackets do not bring up any macros at all!

1 answer

Hello there, @mahdi_hosseinali!

Thanks for sharing your concerns here with the Community. For starters, I want to take-off my reply with the fact that I can replicate the Table of Contents behaviour in preview mode. Here is the report I raised for our teams:

Second, here is the central hub for Cloud documentation from Atlassian:

Macro Browser and Macro shortcuts

Now, let us take care of the other points you brought up. The macro browser and macro shortcuts got some changes with our new experience. For example, the curly brackets ({) shortcut has been replaced with the slash shortcut (/). To quickly search for macros in our new editing experience, we can type / and the quick search will come up. Here, we have an article about it:



You mentioned that anchors have been removed, and you are right about it. The Links and Anchors documentation we currently have is applicable only to the Legacy Editor (old experience). Here is an excerpt of the document:

This content applies to the legacy editor

For more information about using anchors in the new editor, review the documentation.

Here we can check the document from where this excerpt was taken:

In our document about the editing improvements that we are rolling out for Confluence, we have a section dedicated to the use of anchors. Here it is:


Anchors workaround

And the last one! The anchors workaround. I have tested the following workaround for the use of anchors:

Add a table of contents macro to your page, as this automatically generates anchor links for each page header.
To find those links, right-click (or on mobile, long-press) any of the headers in the table of contents, and copy the link address. 

After testing, I can tell that I was able to use the header links as anchors within my page.

Let us know if there is anything else we could assist you with, Mahdi. I would love to help with the discovery and learning curve of Confluence!

Looking forward to your reply.




Now, to look into the reported issue of the headings not being correctly shown within the Table of Contents macro. I was unable to replicate this issue locally, on my Confluence instance.

Since we have only six levels of heading, ranging from 1 to 6, we should be seeing all of them if the maximum indent level is set to 7:



Here is what I see when I try to replicate the issue:



Since I was unable to replicate it, could you clarify how was this behaviour triggered in your page? What steps have been taken for this to happen?



Suggest an answer

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

What do you think is the most *delightful* Confluence feature? Comment for a prize!

- Create your own custom emoji 🔥 - "Shake for Feedback" on mobile 📱 - An endless supply of GIFs via GIPHY 🤩 Is there anything quite as nice as a pleasant surprise? Comment below with what...

342 views 23 8
Join discussion

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