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 best to link to headings

Robert Mark Bram Apr 01, 2012

In Confluence 4, I can type [ and it lets me search for pages in my Confluence to link to, which is great. But how then do I link to headings on that page? So far, the only way I have found is to manually copy the entire URL and link to that. I was hoping the fancy search function could root out headings within a page too.

4 answers

6 votes

This can be done by going through the 'Advanced' tab in the 'Insert Link' dialog as described in this page:

Ciro Santilli Jun 13, 2018

Confluence, please allow every heading to have its own anchor as part of the heading feature itself. Like Asciidoc. Adding anchors manually is annoying.

Like # people like this
Michael Coburn Sep 20, 2018

If you include a TOC always on your pages, then you can get a free anchor to the headings (right click elements in TOC on a rendered page)

Like # people like this
Marisha Parker Oct 19, 2018

Thank you Michael! This simplifies things for me.

Serhiy Kalinets Nov 23, 2018

here now links to headers work out of the box

3 votes
Tobias Anstett (K15t) Community Leader Sep 03, 2018


Best practice to use the anchor macro. This creates an anchor inside the page, which can be hyperlinked as documented at

I referred to this as best practise as you will have to specify a key for your anchor which will not break if you adopt the heading in the future - links will still work.

Best, Tobias

0 votes
Dan Mergens Jun 01, 2016

My version of Confluence (3.4.7) does not include an 'Advanced' tab in the 'Insert Link' dialog.

I can insert the link to a heading using the heading name in the 'Web Link' -> 'URL' field.

Alain Moran Aug 01, 2017

Each heading item has an id attribute that you can append to the url of the page to link directly to a heading.

However you don't need to use the page url, you can do it with the page name and wiki-markup, eg:

[My Page Name#MyHeadingId]

Like # people like this
George Mogilevsky Jan 17, 2019 • edited

i have a table with multiple rows. some of these rows are set with h4 tag. When the heading tags inside the table have inline comments, they don't have the id attribute or the heading id. Is it possible to link directly to these headings?

Tobias Anstett (K15t) Community Leader Jan 17, 2019

Hi @George Mogilevsky,

please refer to my answer above. Using the anchor macro solves all issues :)

Best, Tobias

George Mogilevsky Jan 18, 2019

Hi Tobias,

Thanks for that. It is indeed a workaround! I read it before posting. It requires me editing pages. Not ideal in my situation though. I'd prefer if the inline comment wrapped the heading, not substituted it. As it breaks existing links and doesn't allow linking into headings.




0 votes
Jesse Todd Apr 26, 2019

Screen Shot 2019-04-26 at 2.23.57 PM.png

Suggest an answer

Log in or Sign up to answer
This widget could not be displayed.
This widget could not be displayed.
Community showcase
Published in Confluence

6 Awesome Ways to Apply Trello, JIRA and Confluence to your Project

I attended  Atlassian Summit 2019  and learned a lot from the presenters, attendees and knowledgeable Atlassian product managers. The presentations I attended focused on applying Agile, pla...

2,322 views 11 27
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