How best to link to headings

[Robert Mark Bram]

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.

[HuseinA]

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

http://confluence.atlassian.com/display/DOC/Linking+to+Pages#LinkingtoPages-LinkingtoanAnchororHeading

[cirosantilli]

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

[Michael Coburn]

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)

[m_parker2]

Thank you Michael! This simplifies things for me.

[serhiyk]

here now links to headers work out of the box

[Mathias Groppler]

The approach with the TOC doesn't work when the heading is changed. The link copied from the TOC is not updated. I would prefer that you could search for #My heading and the link would be updated when the heading changes similar to page links

[pavelpigalov]

The desired approach with "Page#Heading" still doesn't work for me in 2020 which is very annoying.

For some reason when I copy this from TOC, it creates "red link" instead of expected documented behavior.

Had to use Anchor Macro to make it work, finally :(

[Tobias Anstett _K15t_]

Hi,

Best practice to use the anchor macro. This creates an anchor inside the page, which can be hyperlinked as documented at https://confluence.atlassian.com/conf68/anchors-947170225.html

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

[Beatriz Cruz]

Hi!
I just posted the solution in another Question on this community:::

https://community.atlassian.com/t5/Confluence-questions/How-to-link-to-headings-on-the-same-page-new-editor/qaq-p/1250592#U1618755

[skube]

Just throwing out another potential solution to this annoying problem.

https://github.com/grantwinney/generate-links-for-headers

[Deleted user]

[Dan Mergens]

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]

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]

https://confluence.atlassian.com/doc/confluence-wiki-markup-251003035.html#ConfluenceWikiMarkup-Links

[George Mogilevsky]

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_]

Hi @George Mogilevsky,

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

Best, Tobias

[George Mogilevsky]

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.

Best,

G

[Carla Woodgate]

Hello Tobias

Since there is no Anchor macro in the cloud version of Confluence, this is not a viable response for those of us using the cloud version.