Adding links to specific page areas.

Adding an anchor is a two-step process: creating the anchor with the Confluence Anchor Macro, and linking to it, from the same or a different page.

Insert the Anchor Macro at a chosen link location.

Enter a name for the anchor. (e.g. step-two)

Creating a Link to the Anchor.

  • Insert a link
  • Choose Advanced
  • Add # followed by the anchor name from Step 1 into the link field

Depending on whether you are adding an anchor on the same page, different page in same space, or page in different space you'll want to choose the related syntax:

Anchor locationLink syntax for anchorExamples
Same page#anchor name

#top

#specific section

Page in same spacepage name#anchor name

My page#top

My page#specific section

Page in a different spacespacekey:page name#anchor name

DOC:My page#top

DOC:My page#specific section

  • Enter or modify the Link Text field
    • This setting allows you to insert link text that differs from the linked page title
  • Select Insert

 

Naming Anchors

Anchor names:

  • are case sensitive
  • must match the link you use when creating the Anchor macro


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.

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