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 to link to headings on the same page (new editor)

I have been unable to determine how to link to a heading on the same page using the new editor. Any help is greatly appreciated! Thank you!

5 answers

2 votes

Hi @Charisma Riley 

I've found a solution, but this didn't work for me...

Try this out, which is explained here

Linkable headings
Over the next couple of weeks, we're rolling out the ability to copy the link to a heading so that you can connect your users to the most important sections of a page.  

To get the heading link

  1. Hover over the section title when viewing the page.
  2. Click the link icon to copy the heading.
  3. Share the link, or insert a link to it when editing a page.

Edit: This behaviour works in view mode. so you have to copy the link in view mode and paste it in edit mode...

Regards, Dominic

It does work for me, but you must exit the editor, go to the published page, grab the heading url, go back into the editor, and then plug it in where it goes — for each and every link! This is *not* a viable alternative to using anchors.

Like # people like this
Dominic Lagger Community Leader Dec 14, 2019

I totally agree with you... There are a lot of users complaining this. Check out some other posts about anchors. 

Like # people like this

This is ridiculous and will take an enormous amount of time to undertake on some of our pages.  Have Atlassian responded with any suggested changes to improve this view / edit mode.

Like Franko I likes this

I might be crazy, but those "link icons" don't appear on any of our Confluence Cloud pages like the documentation says.  This makes it tough to copy the link...

Copy link works for me. The copy link appears only published pages.

1. Add all your heading.

2. Save the page.

3. Hower over the heading.

4. click on the copy link floating icon.

5 Go to edit mode, select the text to be a link, pres command + K and paste the link.

The way I have been doing it is, include a Table of Contents at the top, view the document in published/view mode and copy the link to the appropriate heading from the ToC and paste into the link.


Its clunky, but it works :|

Like # people like this

Was this fixed?

According to links to headers are supposed to be natively supported.

But they sure don't show up in any link interface we have in the new editor.

1 vote

Hi @Charisma Riley and all the Atlassian Community!

Just do the following:::

  1. Write down the section name you want the link.
    1. Example:
      Screen Shot 2021-02-19 at 22.35.11.png
  2. Write down the words that you want link your heading, let's assume that is "this section";
  3. Modify the phrase "this section" with the Link Tool, located in the Confluence editing toolbar;Screen Shot 2021-02-19 at 22.36.43.png
  4. The address must be #<header name> :
    • Example:
      Screen Shot 2021-02-19 at 22.37.14.png
  5. DONE!
    Screen Shot 2021-02-19 at 22.37.50.png

Thanks, yay, I was able to make that work.

My interface didn't quite match the last screenshot - I had to select "Advanced" in the link tool modal that popped up.

Like # people like this

Wondering that it is working for you with spaces in the link - if the header is just a single word it worked.

However when the headers had space within - "computer says no" :D 

@felix_weber if you look at the URL from the published page to a heading with spaces, it has hyphens replacing the spaces.

So "#computer says no" would not link to the heading "computer says no", but "#computer-says-no" will!

Like felix_weber likes this

I'm able to link it but when I clicked on it, it doesn't bring me to that particular section/heading that I've linked it to. Anyone else facing that issue?

Me too, tried several ways and sources for the link (copied it from the header in view mode, from the table of contents, created the link manually as documented, but nothing works.

The legacy editor was way better, and even after more than a year of releasing this new editor, Atlassian doesn't seem to fix very simple issues.

If you have your Headings created and want to add the links, you can publish the page and have it in View on one browser tab and in Edit on another browser tab.

Then you can grab the links from the View and paste them into the Edit tab using the link tool. This saves you having to jump in and out of Edit mode.

in general you are right - that is also how I did in the past - but as also discussed above its way to complicated;

the feature with the # as explained by @Beatriz Cruz  above is better - at least if it works ;) 

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

343 views 14 10
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