Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Content Layer
namePage Info
id278129461
classwatermark-layer
Content Column
namePage Body
width100.00001%
id278129463
Content Block
background-colortransparent
namePrompt
id494677873
classtight manual-prompt-flex

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

Content Block
nameOutcome
rich-link-hoverstrue
id1042866408
classtight manual-outcome-flex

Linking to Adding an anchor takes a user directly to a specific place on a page. You must create the anchor (using the is a two-step process: creating the anchor with the Confluence Anchor Macro), before you can link to it, and linking to it, from the same or a different page.

Content Block
nameSteps
rich-link-hoverstrue
id494842117
classsteps-block numbered manual-steps-flex tight-bottom

Insert the Anchor Macro at a chosen link destination.

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

Create

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.

  • Insert a link
  • Click Advanced in the Insert Link window
  • Add # followed by the anchor name from Step 1 into the link field

Depending on whether you are linking to an anchor on

same Confluence site:

A. Same Page

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

B. Different Page

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

  • Go to "Insert Link"
  • Choose "Advanced" and enter the anchor name in the "Link" field

    • Enter or modify the Link TextSave

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

    • Go to "Insert Link"
    • Choose Web Link and add a full URL 
    • field
      • This setting allows you to insert link text that differs from the linked page title
    • Select Insert

     

    Content Block
    nameNote
    rich-link-hoverstrue
    id495965127
    classmanual-note-flex tight-bottom
    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: 

     


    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.

    Content Block
    nameTip
    rich-link-hoverstrue
    id894522670
    classmanual-tip-flex tight-bottom
    Tip

    Learn More from Atlassian

    • HTML Link
      new-windowtrue
      textAnchors
      urlhttps://confluence.atlassian.com/doc/anchors-139442.html
    • HTML Link
      new-windowtrue
      textInsert Links and Anchors
      urlhttps://confluence.atlassian.com/confcloud/insert-links-and-anchors-724764900.html

    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
    nameWarning
    rich-link-hoverstrue
    id894530759
    classmanual-warning-flex
    collapsiblecollapse
    Warning

    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.
    Content Block
    nameInfo
    rich-link-hoverstrue
    id894537203
    classmanual-info-flex
    collapsiblecollapse
    Info

    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.
    Content Layer
    background-color$lightGrayColor
    nameRelated
    id888168050
    Content Column
    nameRelated
    width100%
    id888168051
    Content Block
    rich-links-hide-descriptiontrue
    rich-link-hoverstrue
    rich-links-columns4
    rich-links-verticaltrue
    rich-links-image-height100px
    rich-links-hide-site-icontrue
    rich-links-details-padding10px
    nameRelated
    rich-links-enabletrue
    border-width0
    rich-links-details-alignmentleft
    rich-links-margin20px 30px 0 0
    id496234544
    classrelated-block clean manual-related-flex