This documentation relates to the latest version of Confluence.
If you are using an earlier version, please go to the documentation home page and select the relevant version.

Working with Anchors

All Versions
Click for all versions
Confluence 2.9 Documentation

Index

You need to edit in 'Wiki Markup' mode to create anchor links.


Anchors allow you to link to specific places within a page. Anchor links can be especially useful when navigating between sections of a long page or when you want to link to a segment of a page and not to the page as a whole.

Anchors are made up of two parts:

  • The link
  • The content to which you are linking.

In Confluence, you can place an anchor in a page using the anchor macro. This creates an anchor called "here", but you can substitute this with whatever name you like.

Anchor Macro

{anchor:here}

Once an anchor is in the page, you can link to it by putting #here (or whatever anchor name you choose) at the end of a link pointing to that page.

For example, there are two anchors in this page called "top" and "bottom", which you can link to like so:

[#top]
[#bottom]

These links come out like this: top bottom.


Linking to an anchor in the same page

[#anchorname]

Linking to an anchor in another page

[nameofpage#anchorname]

Linking to an anchor in a page in another space

[spacekey:nameofpage#anchorname]

Linking to headings

Confluence treats all headings as anchors. So you don't have to place an anchor but simply link to it like this:

[#textofheading]

Warning
Page titles and links to other spaces can be combined with anchors and attachments, but you can't use attachments and anchors in the same link.

Note that if you are adding an anchor to the site welcome message, it must be to another page. Internal-only links such as {anchor:bottom} will not render.

RELATED TOPICS

Working with Links Overview

Take me back to Confluence User Guide

Labels

macro macro Delete
anchor anchor Delete
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.
  1. Dec 04, 2007

    Anonymous says:

    I need to link to an anchor from outside Confluence.  What's the URL for th...

    I need to link to an anchor from outside Confluence.  What's the URL for that?  I've tried page#anchorname without success.

    1. Dec 04, 2007

      Choy Li Tham says:

      Hi, I presume you want to link an anchor in the page outside from Confluence. I...

      Hi,

      I presume you want to link an anchor in the page outside from Confluence. If this is the case, you may want to use the page URL address instead of using the page name. An example would be:

      [alias|<URL of external page>#anchorname]
      

      Regards,
      Choy Li

      1. Dec 06, 2007

        Anonymous says:

        Thanks for your reply.  However, what you suggested is what I had tried - I...

        Thanks for your reply.  However, what you suggested is what I had tried - I guess I wasn't clear about that.

         I have found that this works:

        [alias|UBaseURL/namespace/page#page-anchor]
        
        &nbsp;
        
        I have no idea why the redundant page is needed between the # and the \-, but JSPWiki requires the same sort of syntax, so there is precedent.
        
        1. Dec 06, 2007

          Kelly Roney says:

          No longer anonymous... Sorry about the extra boxes above.

          No longer anonymous...

          Sorry about the extra boxes above.

  2. Feb 13, 2008

    Anonymous says:

    Hi,     In the opposite direction to the post above, was wonderi...

    Hi,

        In the opposite direction to the post above, was wondering what the syntax might be to address an anchor (inside a confluence space/page) via a link (email etc.) from the outside.

        I have made a (failed) attempt by appending #table_anchor to  the 'tiny' link from the page's info tab. It looks something like tiny_link#table_anchor.

        When clicking on the link from an email message, the page opens but does not advance to the anchor.

        Any thoughts would be appreciated.

    Thanks in advance,

        Derek B. 

       
     

      
     

    1. Feb 14, 2008

      Ming Giet Chong says:

      Hi, The following link is an example of linking to an anchor of a page: http...

      Hi,

      The following link is an example of linking to an anchor of a page:

      If you need any further technical assistance for this issue, I would suggest you to raise a support ticket at:

      Regards,
      MG

    2. Feb 28, 2008

      Anonymous says:

      I'd be interested in this too - it seems like there should be some kind of a uni...

      I'd be interested in this too - it seems like there should be some kind of a unique page ID that you should be able to look up and use per page to form the syntax something like <siteIDorURL><ParentPageID><childPageID><AnchorName>.  My concern is that any link that is dependent on the name value used in the left-hand button/tab navigation will not be as stable long-term to link to as a url based upon a key or unique ID value.. but I have been unable to locate more than the "tiny link" value in the info or edit of a page.  It seems like there must be a key value assigned, because some pages display a numeric identifier at the end of the url, but I'm not sure what the logic is whereby this gets used in the url - I can't figure out how to get it for some of the sub-pages.

      If anyone has any insights for locating this +/or samples for how to form this successfully using something more able to weather change than the name value, I'd much appreciate your insights!

      Monica 

  3. May 28, 2008

    Anonymous says:

    I am playing with the evaluation version to see if this is what our company need...

    I am playing with the evaluation version to see if this is what our company needs. I tried placing 2 anchors on the same page, like the top and bottom example above.

    On the first one, the link was on the top of the page, and it worked beautifully leading me to the bottom of the page where the anchor was.

    Then I tried doing the opposite: placing an anchor on the top of the page, and the link at the bottom. I cannot get this to work, even though the syntax is correct. Actually, on the top I have "Upload .", but when I save and view all that shows up is "Upload ." 

    Any idea what is going on here?

    Thank you!

     Marta

    1. Jun 02

      Ming Giet Chong says:

      Hi Marta, I would suggest you to raise a support ticket at https://support.atla...

      Hi Marta,

      I would suggest you to raise a support ticket at https://support.atlassian.com to further investigate to this issue. Please provide the wiki markup for this issue. Thanks.

      Regards,
      MG

  4. Jul 08

    Anonymous says:

    I cannot get an anchor to work within a table. The link is from outside of the t...

    I cannot get an anchor to work within a table. The link is from outside of the table, and the anchor itself is within the table. When I click on the link to jump to the anchor, nothing happens. Is there any way around this?

    1. Jul 09

      Azwandi Mohd Aris says:

      Hi there, Unfortunately, I cannot reproduce the problem on my local instance. T...

      Hi there,

      Unfortunately, I cannot reproduce the problem on my local instance. The anchor seems to work fine when included within a table. Please try the following wiki markup:

      Link to content within [#table]
      ||heading 1||heading 2||heading 3||
      |cell A1|cell A2|cell A3|
      |cell B1|cell B2
      \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ 
      \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ 
      \\ \\ \\ \\ \\ \\ \\ \\ \\ \\
      \\ \\ \\ \\ \\ \\ \\ \\ \\ \\
      \\ \\ \\ \\ \\ \\ \\ \\ \\ \\
      {anchor:table}Your content|cell B3|
      

      Please note that in the above example, I have to make sure that the page is scrollable, so that I could see the effect of the anchor link.

      However, if the problem still persists, please raise a support request at http://support.atlassian.com

      Cheers,
      Azwandi

  5. Jul 22

    Margaret Ostrander says:

    I've been trying to figure out a way to use an IMAGE as an ANCHOR link to anothe...

    I've been trying to figure out a way to use an IMAGE as an ANCHOR link to another location on the same page without using the default styling of the text.
    Is there a way to do this?

    1. Jul 24

      Azwandi Mohd Aris says:

      Hi Margaret, To my understanding, you can try to use the following notation: ...

      Hi Margaret,

      To my understanding, you can try to use the following notation:

       [!YOUR_IMAGE.jpg!|#ANCHOR_NAME] 

      Hope this helps. Feel free to clarify if I have misinterpreted your question.

      Cheers,
      Azwandi

      1. Jul 28

        Margaret Ostrander says:

        Thanks Azwandi! The issue is that we're having some odd linking issues in ge...

        Thanks Azwandi! The issue is that we're having some odd linking issues in general when using the Rich Text editor. Using the wiki code straight away solves the problem. A simple solution that I did not see staring me in the face earlier. Your help is much appreciated!

  6. Jul 22

    Anonymous says:

    I am trying to use a heading as an anchor. to do this i am doing something like ...

    I am trying to use a heading as an anchor. to do this i am doing something like this (with various combinations), but nothing seems to work

    OR

     any help is appreciated.

    1. Jul 23

      Azwandi Mohd Aris says:

      Hi there, You might want to try the following to set an anchor to headers: ...

      Hi there,

      You might want to try the following to set an anchor to headers:

      {anchor:my_anchor_name} h3. My Header
      

      Hope this helps.

      Cheers,
      Azwandi

Add Comment