Linking to an Anchor

Content Layer

name	Page Info
id	278129461
class	watermark-layer

Content Column

name	Page Body
width	100.00001%
id	278129463

Content Block

background-color	transparent
name	Prompt
id	494677873
class	tight manual-prompt-flex

How add anchors on pages across your siteAdding links to specific page areas.

Content Block

name	Outcome
rich-link-hovers	true
id	1042866408
class	tight manual-outcome-flex

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

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

Adding an Anchor

http://examplesite.com/display/DOCS/My+page#Mypage-bottom

http://examplesite.com/display/DOCS/My+page#Mypage-importantinformation

Enter or modify the "Link Text" field

3. Select "Insert"

- This setting allows you to insert link text that differs from the linked page title
Select Insert

Content Block

name	Steps
rich-link-hovers	true
id	494842117
class	steps-block numbered manual-steps-flex tight-bottom

Go to Insert Macro

Select

Insert the Anchor Macro at a chosen link destination.

Enter a name for the anchor

name (For example, 'top' or 'specific section)

. (e.g. step-two)

Create

Select Insert

Creating

a Link to the Anchor

Link to an anchor on same Confluence site:

Go to Insert Link

Choose Advanced

Type

.

Insert a link
Click Advanced in the Insert Link window
Add # followed by the anchor name

in Link field

from Step 1 into the link field

Depending on whether you are

adding

linking to an anchor on: the same page

,

; a different page in the same space

,

; or a page in a 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

b.

Enter or modify the Link Text field
c. Select Insert
Link to an anchor from another web page or another Confluence site:
1. Go to Insert Link
2. Choose Web Link and add a full URL using syntax below:

Link syntax

Examples

http://examplesite.com/display/spacekey/pagename#pagename-anchorname

Content Block

name	Note
rich-link-hovers	true
id	495965127
class	manual-note-flex tight-bottom

Naming Anchors

Note

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:

http://myconfluence.com/pages/viewpage.action?pageId=7700510#id-ページ-HighLevelComparison

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

Content Block

name	Tip
rich-link-hovers	true
id	894522670
class	manual-tip-flex tight-bottom

Tip

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?
- {

Learn More from Atlassian

HTML Link
new-window true
text Anchors
url https://confluence.atlassian.com/doc/anchors-139442.html
HTML Link
new-window true
text Insert Links and Anchors
url https://confluence.atlassian.com/confcloud/insert-links-and-anchors-724764900.html

Content Block

name	Warning
rich-link-hovers	true
id	894530759
class	manual-warning-flex
collapsible	collapse

Warning

If using:

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

Content Block

name	Info
rich-link-hovers	true
id	894537203
class	manual-info-flex
collapsible	collapse

Info

If using:

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

Content Layer

background-color	$lightGrayColor
name	Related
id	888168050

Content Column

name	Related
width	100%
id	888168051

Content Block

rich-links-hide-description	true
rich-link-hovers	true
rich-links-columns	4
rich-links-vertical	true
rich-links-image-height	100px
rich-links-hide-site-icon	true
rich-links-details-padding	10px
name	Related
rich-links-enable	true
border-width	0
rich-links-details-alignment	left
rich-links-margin	20px 30px 0 0
id	496234544
class	related-block clean manual-related-flex

Page tree

Transform Your Digital Workplace

Industry Expertise

Inform Your Strategic Direction

Redefining Work

Documentation and Support

Versions Compared

Old Version 36

New Version Current

Key

Insert the Anchor Macro at a chosen link destination.

Create

a Link to the Anchor

.

Platform

Company

Support

Brikit Services