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

Earn badges and make progress

You're on your way to the next level! Join the Kudos program to earn points and save your progress.

Deleted user Avatar
Deleted user

Level 1: Seed

25 / 150 points

Next: Root


1 badge earned


Participate in fun challenges

Challenges come and go, but your rewards stay with you. Do more to earn more!


Gift kudos to your peers

What goes around comes around! Share the love by gifting kudos to your peers.


Rise up in the ranks

Keep earning points to reach the top of the leaderboard. It resets every quarter so you always have a chance!


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

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!



3 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?

I think this is what you're looking for.  It causes each heading to have a paperclip icon when you hover over it.  You can then click that icon to get a link, which allows you to point your colleagues to a specific location.  IMO, essential functionality that you shouldn't have to install a plugin for.

Clickable Anchors | Atlassian Marketplace

Suggest an answer

Log in or Sign up to answer

Atlassian Community Events