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

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

How can I link to a heading within a page in Confluence?



My team recently started using Confluence and one of our programmers was looking to link to a heading within a page they have created. 

For example, there is a heading within the page called "Specifications" and in the body of a section "specifications" was mentioned.  We want to be able to link "specifications" to the "Specifications" header for easy maneuverability on the page. 

After looking through countless resources regarding macros and anchors we have not been able to figure out how to do this.


Any help is greatly appreciated!



2 answers

1 accepted

0 votes
Answer accepted

Anchors is the easiest way to do this, so maybe I can provide some clarity on how?

Place the anchor macro on the line ABOVE where you want to link to. Give the anchor an ID easily remembered (caplitalization matters). I would use specifications for this. In this example I used top:


When you add a link to a word using the Insert Link function, you can put in #specifications (or in this case #top) as the anchor link. When you save the page you should see the functionality you are looking for.linkdialog.png


To link to an anchor on another page use the page's URL and add #anchorname to the end (i.e.

Anchors don't play nice with AUI Tabs, and this is to be expected as the tabs use anchorlinks to navigate. Anchors will not work past the first tab.

Hi Heth,

Thanks for the detailed response.

My only issue is that I don't see the Anchor Macro anywhere.  Is this something I need to add manually?

Sorry for the double reply, but after looking at some other Community posts about Anchors it seems like they aren't working or have been removed.

The linkable headers feature is apparently "replacing" anchors, but I don't see the option to do linkable headers in our Confluence...

Anchors are being removed?!?!?!


After doing research... this is a cloud "feature"

Yeah it appears so...I got the Linkable Headers thing figured out.

Not sure if this is a bug or not, but you can't actually get the link for a header unless you are viewing the page...doesn't make a lot of sense because if you are trying to create links within the page then this requires to Publish the page, get the header link, go back into editing the page, and create the link.


All headings are by default "tagged" without a need to insert an ancor.

To know what shall be the link to refer to, you can 

  • inspect the html code with your browser (select, right click, "Inspect" in Chrome)
  • insert a "Table of Content" macro in your document. The table is a set of links to your headers.

Once you have the tag, insert the link as Heth explained :)


@Herve Frydlender, in that replay, don't you kind of have those steps backwards?

Suggest an answer

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

🏑 Atlympic Event: Confluence

Hello Community!  Quick disclaimer: We are running a contest on Community (The Atlympics!) from July 23rd - August 8th of 2021. If you are interested in participating in this contest (prizes! ...

588 views 19 17
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