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

All Versions
Click for all versions
Confluence 2.9 Documentation

Index

Confluence tries to encourage linking by making it as simple as possible. You can link to content anywhere within Confluence or an external site just as easily, using the same syntax. Confluence also gives you the flexibility to do some pretty complicated things with links.

You can create links to and from any of the editable content on the site:

You can also use a Confluence link to:

Links in Confluence are always denoted by square brackets. Whenever you place text between square brackets, Confluence recognises it as a link.

Handy Hints
  • Links in Confluence will not break even when you rename pages or move them between spaces on your site!
  • Looking for link type not shown above? You might find a plugin can help you.
  • Your Confluence administrator can configure Confluence to display icons next to each link, distinguishing external links, user links and email links.


RELATED TOPICS

Rich Text-Creating a new link
Changing the Title of a Link
Working with Anchors
CamelCase linking
Trackback
Linking to Confluence Pages from Outside Confluence

Take me back to Confluence User Guide

Labels:

Enter labels to add to this page:
Wait Image 
Looking for a label? Just start typing.
  1. Apr 16, 2007

    David Ruddock says:

    Links in comments are not updated and will break when the page is renamed. Vote ...
    Handy Bug
    Links in comments are not updated and will break when the page is renamed. Vote for it to be fixed here:
    CONF-7901
  2. Aug 01, 2007

    Nicholas Kerzman says:

    Has anyone had any experience or know how to link to a network drive from Conflu...

    Has anyone had any experience or know how to link to a network drive from Confluence? Does it require using the HTML macro? We do not currently have that enabled.

    This is the type of link I am trying to create (from an HTML world)
    <a href="file://ca123/PKWSAFE/RGFD/SME/SMEDevelopment/" >Some folder I need to access</a>

    Essentially: //ca123/PKWSAFE/RGFD/SME/SMEDevelopment/

    Thanks 

    1. Aug 01, 2007

      Daniel Norton says:

      Just write &nbsp;&nbsp;&nbsp;&nbsp;{{\file://ca123/PKWSAFE/RGFD/SME/SMEDevelopm...

      Just write

          [file://ca123/PKWSAFE/RGFD/SME/SMEDevelopment/],

      which yields file://ca123/PKWSAFE/RGFD/SME/SMEDevelopment/

      Note that this convention won't work with all browsers, and particularly not with Firefox.

      1. Jul 15

        Anonymous says:

        Did anybody figure out a work around for firefox?

        Did anybody figure out a work around for firefox?

        1. Jul 15

          David Peterson says:

          Since this is a security precaution built into FireFox, the only workaround is t...

          Since this is a security precaution built into FireFox, the only workaround is to manually disable the precaution in FireFox. Details are here. I haven't tested if this works personally, however...

  3. Dec 21, 2007

    Anonymous says:

    I have the same question as Stefan which I did not see a response for.&nbsp; How...

    I have the same question as Stefan which I did not see a response for.  How can one break a link that one just created?

    1. Dec 27, 2007

      Tony Cheah Tong Nyee says:

      Hi there, To my understanding, you meant to say that in wiki markup, defining s...

      Hi there,

      To my understanding, you meant to say that in wiki markup, defining square brackets, "[" and "]" would lead to creating a link. However, you wish to display only the square brackets and the word wrapped in between as it is, without Confluence taking the line as a link?
      If that is the case, you could achieve this by escaping the "[" character. For example:

      \[<some text>\]
      

      Doing so in the wiki markup will render [<some text>] in the page.

      If I have misinterpreted your questions, please further clarify them for a better understanding.

      Cheers,
      Tony

  4. Mar 07, 2008

    Anonymous says:

    Is there any icons to symbolize external link, or link to a section in the same ...

    Is there any icons to symbolize external link, or link to a section in the same space and so on? Thanks

    1. Mar 10

      Choy Li Tham says:

      Hi, For Confluence version 2.6 onwards, Confluence provides the "Show Link Icon...

      Hi,

      For Confluence version 2.6 onwards, Confluence provides the "Show Link Icons" functionality, which allows you to distinguish an external link, user link and email link in wiki content. You may want to enable the "Show Link Icons" via the Administration > General Configuration > Formatting and International Settings and see if it fulfill your requirement.

      Regards,
      Choy Li

  5. Apr 21

    Anonymous says:

    Hi, Our organization has made some changes to the stylesheet to get a few desir...

    Hi,

    Our organization has made some changes to the stylesheet to get a few desirable effects. However, now we have some issue with broken links. They no longer show up in a different color than regular links - instead they show up just like a regular link and Confluence thinks you want to create a page with that title. So for example

    [my nonexistent page|spacekey:Some nonexistent page]
    

    it will show up like a regular link and not until you click it do you realize that this page doesn't exist. It doesn't show up like this: [my nonexistent page]

    Is this the effect of changes to the stylesheet? Where in the stylesheet is this configured? I don't think it has to do with the color scheme - but I could be wrong. Let me know if you know or if this issue is tracked at all (I couldn't find anything in JIRA).

    Thanks so much,
    Joseph

    1. Apr 23

      Mei Yan Chan says:

      Hi Joseph, Are you able to revert your changes made to the stylesheet and see i...

      Hi Joseph,

      Are you able to revert your changes made to the stylesheet and see if the problem still exist. If it does, I would suggest you to create a support request at the link below and provide us some explanation as given above. Thanks.

      Regards,
      Mei

  6. Jul 25

    Carl W. Hunt says:

    Is there syntax to link to functional links in Confluence? For instance,

    Is there syntax to link to functional links in Confluence? For instance, http://confluence.atlassian.com/users/editemailpreferences.action. I'd like to provide functional links when writing documentation about Confluence and I'd rather not use the syntax of an external link in case the hostname ever changes. The only way I can think of to do this is with a user macro.

    1. Aug 04

      Azwandi Mohd Aris says:

      Hi Carl, As far as I am concerned, the feature is not currently available in Co...

      Hi Carl,

      As far as I am concerned, the feature is not currently available in Confluence. If you are keen on it, feel free to raise an improvement request at http://jira.atlassian.com. Meanwhile, you might want to use shortcut links, although it might not fulfil your entire requirements. Hope this helps.

      Cheers,
      Azwandi

      1. Aug 04

        Carl W. Hunt says:

        Thanks. This meets my needs at this time.

        Thanks. This meets my needs at this time.

Add Comment