Linking to an Anchor
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 location | Link syntax for anchor | Examples |
---|---|---|
Same page | #anchor name | #top #specific section |
Page in same space | page name#anchor name | My page#top My page#specific section |
Page in a different space | spacekey: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:
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 Insert Links and Anchors
- Looking for the insert macro keyboard shortcut?
- {