How to use bookmark with anchor to link to specific section of confluence page?

We are interested in using anchors in Confluence with bookmark to link to a specific section of a Confluence page.  So far, the syntax of "anchor\bookmark" or "anchor:bookmark" has produced a syntax error?

What is the proper way to set up an anchor with a bookmark?


2 answers

In the Advanced tab of the "Edit link" dialog use the hashmark and then the name of the section.

Eg. if the section has a heading "Assets" use "#Assets". If you refer to another page, add the page title in front of the hashmark.

For details please refer to, Link to an anchor on a page: spacekey:page name#anchor name

For instance: The key of the space you want to link to is "DOC", the page title is "My Page" and the heading of the section is "Important Information". The link in the advanced tap input field would be:

DOC:My Page#Important Information

Note that you use the heading as is, not the generated ID on the HTML element.

Here is more information on anchors:


Thank you for the assistance. This works at the space level very well.

We are also trying to anchor to a specific page in a space and then to a specific section of that page (with a heading)?  Is that possible?

Hierarchy is:



3–Heading (not at top of page, but within body of page)


I don't know if I understand your question correctly. So I tried to add an example to explain the linking to a section in another space. Hope this helps.

Robert, I now have the link working. Thank you so much for your help. Debbie

Thank you for your feedback!

@Debbie Buswell I am trying to do something similar ie  link from an external website to a particular section of a confluence page (particular question in a FAQ confluence page).

Could you tell me what you did? I tried going over the articles @Robert Reiner [smartics] mentioned and it says to use this format:

But it did not work.

Maybe your page or anchor name contains special characters or a space? In case of a space you need to remove them.

The easiest thing would be to inspect the heading you would like to point to in your browser. Check the id attribute of the heading.

<h2 id="BreadcrumbMacro-TemplateforLabel" ...>Template for Label</h2>

Suggest an answer

Log in or Sign up to answer
Community showcase
Published Mar 12, 2019 in Confluence

Confluence Admin Certification now $150 for Community Members

More and more people are building their careers with Atlassian, and we want you to be at the front of this wave! Important Dates Start the Certification Prep Course by 2 April 2019 Take your e...

300 views 2 13
Read article

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