How add anchors on pages across your site

Linking to an anchor takes a user directly to a specific place on a page. 

You must create the anchor (using the Confluence Anchor Macro), before you can link to it.

Adding an Anchor

  • Go to "Insert Macro" 
  • Select "Anchor Macro" 
  • Enter anchor name (For example, 'bottom' or 'important information')

Creating a Link to the Anchor

Link to an anchor on same Confluence site:

A. Same Page

  • Go to "Insert Link"
  • Choose "Advanced"
  • User "#" before the anchor name

B. Different Page

  • Go to "Insert Link"
  • Choose "Advanced" and enter the anchor name in the "Link" field
Anchor locationLink syntax for anchorExamples
Same page#anchor name

#bottom

#important information

Page in same spacepage name#anchor name

My page#bottom

My page#important information

Page in different spacespacekey:page name#anchor name

DOC:My page#bottom

DOC:My page#important information

  • Enter or modify the Link Text
  • Save

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

  • Go to "Insert Link"
  • Choose Web Link and add a full URL 

Special Characters

If the name of the page you are linking to contains special characters,  where the URL displays a page ID rather than a name, the link to an anchor will be a combination of the page ID and the page name, as follows:

For the page "Test - page 1!" containing a tab named "anchor" the URL will look like this: 

 

http://myconfluence.com/pages/viewpage.action?pageId=54689987#Test-page1!-anchor


UTF-16 Characters

If the page name contains UTF-16 characters (eg. Simplified Mandarin, Katakana) then it is necessary to add "id-" into the URL before the second instance of the page name, as follows:

For the page "ページ" containing a tab named "High Level Comparison", the URL will look like this:

Note: You can retrieve the page ID from the address bar when the characters are not ASCII.

  • Find out more about the specifics around creating different kinds of anchors on Anchors or Anchor Macro
  • Looking for the insert macro keyboard shortcut?
    • {

If using:

  1. Replace me with something to note about this how-to entry that falls outside the scope of all other sections; and
  2. Add the tight-bottom class to the next visible/non-collapsed block above this one to narrow the gap between the two blocks.

If using:

  1. Replace me with something to note about this how-to entry that falls outside the scope of all other sections; and
  2. Add the tight-bottom class to the next visible/non-collapsed block above this one to narrow the gap between the two blocks.