How can I link to a heading within a page in Confluence?
Asked by Ross LeMere:

Hi,

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!

Thanks


Answers:
author: Heth Siemer
body: 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:**

![anchormacro.png](https://community.atlassian.com/t5/image/serverpage/image-id/71013i3B37CE94B7975563/image-dimensions/244x189?v=v2 "anchormacro.png")  

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](https://community.atlassian.com/t5/image/serverpage/image-id/71014i2D1001946339863D/image-dimensions/634x207?v=v2 "linkdialog.png")

**To link to an anchor on another** page use the page's URL and add #anchorname to the end (i.e. example.atlassian.com/display/CUSTCARE/Customer+Care+Home#top)  

**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.

comments: author: Ross LeMere
body: 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?


author: Ross LeMere
body: 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...


author: Heth Siemer
body: Anchors are being removed?!?!?!

![](https://media0.giphy.com/media/gOHxskuYRcg3m/source.gif)

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


author: Ross LeMere
body: 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.


author: Ian Thompson
body: Gave this a try and it works great. Thanks for the info.


author: Stephan Georgiev-Ashkenazy
body: Of course it works wonderful at my side.


author: Will Clegg
body: Thanks [@Heth Siemer](/t5/user/viewprofilepage/user-id/1178715) this worked a treat.  

The only thing to note is that it**doesn't** seem to work for the shortened Confluence URLs (e.g. <https://abcco.atlassian.net/l/cp/abc123bbv>) which can be generated through Share-\>Share Page-\>Copy Link  

![Screenshot 2024-08-28 at 11.49.39.png](https://community.atlassian.com/t5/image/serverpage/image-id/344236iA0314BD243CF0EDB/image-size/large?v=v2&px=999 "Screenshot 2024-08-28 at 11.49.39.png")


author: Jill Armitage
body: Thanks [@Ross LeMere](/t5/user/viewprofilepage/user-id/1951370) ! Brilliant. Just what I needed. I searched for "deep links" and luckily this thread came up. Thanks again!


author: Herve Frydlender
body: Hi,

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 :)

Regards

comments: author: Patrick O_Connell
body: [@Herve Frydlender](/t5/user/viewprofilepage/user-id/1208680), in that replay, don't you kind of have those steps backwards?


author: Stephan Georgiev-Ashkenazy
body: Hi Friends,

The point is that I am looking for a solution to take me from the bottom of the page to the top, but displaying as well the page summary/title. And here the problem is that the anchor macro starts only in the body of the document - it couldn't be located in the title row.![image.png](https://community.atlassian.com/t5/image/serverpage/image-id/276957i65B7DBB7FAAC08DD/image-size/large?v=v2&px=999 "image.png")

The solution that I found at least is to have the link to this specific page and to use it in the link at the bottom of the page, which should take you to the top. But the problem with this solution is that each time you click on this link, the page is fully reloaded and it takes some time. Instead of jumping fast and easily within the HTML content of the page.  

![image.png](https://community.atlassian.com/t5/image/serverpage/image-id/276963i509CA51A1663E0A6/image-size/large?v=v2&px=999 "image.png")

Hope that you will find my reply useful.

KR,

Stephan


author: Kyle Andringa
body: 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](https://marketplace.atlassian.com/apps/1219658/clickable-anchors?hosting=server&tab=reviews)


Tags: atl-gruland

cloud

confluence-cloud