.png)
The most common form of links are those that link web pages together. This tutorial shows you how to link to pages within Confluence and also on external sites...
Linking to Pages
If you link to a page on your own site that does not yet exist, the resulting link will automatically generate the page ready for editing when clicked on by someone who has edit privileges in that area:To link to a page within the current space, simply enclose the page title in square brackets:
[Links]Which results in:
To link to a page in another space, simply prefix the page title with the space key. For example, to link to the "Links" page within our Builder Feature tour (which lives in our ADAPTAVIST space), use the following:
[ADAPTAVIST:Links]Of course, you can add custom on-screen text and tooltips to any of these links:
Which results in:
Automatically Creating Pages
[My New Page]
People who do not have edit privileges will see a broken link.
However, anyone with edit privileges, such as yourself, will be able to click the link to create the page.
So why is this useful? When you are creating pages, you will often be aware that they need to link to other pages which may not have been created yet - simply add in the link and once your page is complete click all the links to missing pages to create and edit them.
Linking to pages on external sites uses similar notation to pages within your own site, only you use a full URL instead:Linking to External Sites
[http://jarrod.adaptavist.com] [Jarrod's Edge|http://jarrod.adaptavist.com] [Jarrod's Edge|http://jarrod.adaptavist.com|My personal home page]
Which results in:
http://jarrod.adaptavist.com
Jarrod's Edge
Jarrod's Edge
As you can see, external links have a green arrow next to them. You can also use a shortcut to the first version of the links shown above by simply adding the URL to your page:
http://jarrod.adaptavist.com
Which results in:
Hints and Tips
Whenever you link to pages within your own Builder account, you should always try to use the notation shown at the start of this tutorial because it enables Builder to automatically update the links should you rename or move a page.
Frequently Asked Questions
| Q | I've used CamelCase links on other Wiki systems to link to pages - does that work with Confluence? |
|---|---|
| A | Yes, but it's not enabled by default. To enable CamelCase links, use the Administration Console. |
| Q | Is it possible to create a link that makes a new page based on a specific template or boilerplate? |
|---|---|
| A | Yes. Use either the add-page macro or the link-page macro. |
Comments (12)
May 31, 2006
Anonymous says:
How can you link to an external page in a new window? Thanks, Charlie (new t...How can you link to an external page in a new window?
Thanks,
Charlie (new to Confluence)
Sep 13, 2006
Anonymous says:
I am wondering the same thing. How to link to an external page (or site) and ope...I am wondering the same thing. How to link to an external page (or site) and open it in a new browser window. I can't find anything in the documentation that speaks to this, so I'm assuming it can't be done?
Janet (new to Confluence)
Oct 05, 2006
Anonymous says:
Ditto! This would be a really nice feature...Ditto! This would be a really nice feature...
Oct 05, 2006
Guy Fraser says:
Unfortunately there is no way to configure Confluence to open external links in ...Unfortunately there is no way to configure Confluence to open external links in new windows by default, but you can use the link-to macro to open links in new windows.
Oct 16, 2006
Anonymous says:
can you please give an example of using link-to macro to open external links...can you please give an example of using link-to macro to open external links in new windows: it's not really obvious from the documentation...
Dec 28, 2010
Robert Collier says:
I believe this can be achieved with the javascript code described here: http://c...I believe this can be achieved with the javascript code described here: http://confluence.atlassian.com/display/DOC/How+to+Force+Links+to+Open+in+a+New+Window
May 07, 2007
Christian Fecteau says:
I couldn't even reply with Firefox 2: the RTE doesn't work. I had to use IE6. A...I couldn't even reply with Firefox 2: the RTE doesn't work. I had to use IE6.
Anyway, the link-to macro doesn't work for this. I use the menulink macro:
target blankCode:
(menulink:custom|target=_blank|link=http://www.adaptavist.com/display/USERGUIDE/menulink+macro)target blank(menulink)
Sep 24, 2007
Philip Parkinson says:
Does the external link support additional parameters like disabling toolbar, set...Does the external link support additional parameters like disabling toolbar, setting browser size etc etc. (All the standard stuff you do in javascript links)
Sep 24, 2007
Guy Fraser says:
No, but you can use the new window user macro to do that: http://confluence.atl...No, but you can use the new window user macro to do that:
http://confluence.atlassian.com/display/CONFEXT/New+Window+User+Macro
Jul 07, 2009
Lars Martinussen says:
As you can see, external links have a green arrow next to them. No they dont, a...No they dont, and why is that? I recon it has something to do with me (and you) are using the Builder Theme. How can I make the green arrows show?
Nov 01, 2010
Tom Kiefer says:
If automatic camel-case links are enabled, is there a way to disable them within...If automatic camel-case links are enabled, is there a way to disable them within a page or for a specific instance?
If a wiki's admin has enabled this feature, then it can be pretty annoying for the rest of us to build a page that contains lots of camel-case terms that, for whatever reason (external product names like MySpace or ComicCon, made-up expressions like NinComPoop, etc.), are not intended to be pages within the wiki – and pretty confusing for the poor information-seeker who later finds that page.
Nov 01, 2010
Tom Kiefer says:
Nevermind. Finally found the {nolink} macro. Might wanna mention that here alo...Nevermind. Finally found the {nolink} macro. Might wanna mention that here alongside the CamelCase note.