Adding a link in Jira to a Confluence Anchor

I'm currently trying to add a link in Jira that's pointing to an anchor in Confluence. It doesn't seem to work since it's simply going to the page without scrolling to the anchor.

I've added the anchor using the macro in Confluence and the syntaxe used for the url in Jira is the following

Do you have any idea why it's not pointing to the anchor?

1 answer

1 accepted

1 vote
Answer accepted
Ann Worley Atlassian Team Oct 13, 2017

I understand you are new to the forum. Welcome. :)

When you link to a Confluence anchor from another Confluence instance or from Jira you have to repeat the page name in the URL - it is not particularly intuitive, I am afraid.

Please see: 

Link to an anchor from another web page or another Confluence site:

Use a full URL in the following format:

Notes about the full URL:

  • The page name is repeated in the URL, after the # sign. The second occurrence of the page name is concatenated into a single word, with all spaces removed.
  • There is a single dash (hyphen) between the concatenated page name and the anchor name.
  • The anchor name in the full URL is concatenated into a single word, with all spaces removed.
  • The anchor name is case sensitive.
  • If the page name contains special characters, where the URL displays a page ID rather than a name, the link to an anchor will look more like this!-anchor In this example the page title is Test - Page 1! and the anchor name is anchor.

Hey Ann, this horrible!!!
Did nobody file for a bug or an enhancement request yet regarding this Confluence-issue ?

Ann Worley Atlassian Team Jul 18, 2018

Thanks for asking! Yes, there is an issue open: Anchor syntax is so difficult to use, our users cannot use anchors

Here is the article on how we implement suggestions: Implementation of New Features Policy

I have no idea why, but when I use the anchor links (described in this article), it only works in Edge. In Chrome, it doesn't go to the anchor, just the top of the page.

It works for me in Chrome

Doesn't work for me in Chrome

Another problem with this is that even when the anchor link works, it doesn't go to the correct location -- it ends up scrolling a few lines below the anchor.  For example, if you place the anchor just above a heading, it scrolls to the line below the heading (so you can't see that you have linked to the correct location).  Or if you place the anchor just above a paragraph, it links to the third of fourth line of the paragraph (and the reader has to scroll up a couple of lines to start reading).

Oddly, this does not happen when you link to an anchor on the same page.  Then it works perfectly.

I filed another question on this topic:

Like 1 person likes this

Suggest an answer

Log in or Sign up to answer
Community showcase
Published Mar 12, 2019 in Confluence

Confluence Admin Certification now $150 for Community Members

More and more people are building their careers with Atlassian, and we want you to be at the front of this wave! Important Dates Start the Certification Prep Course by 2 April 2019 Take your e...

1,353 views 2 13
Read article

Atlassian User Groups

Connect with like-minded Atlassian users at free events near you!

Find a group

Connect with like-minded Atlassian users at free events near you!

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you