Linking to Pages

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

To link to a page within the current space, simply enclose the page title in square brackets:

[Links]

Which results in:

Links

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]

Which results in:

Links

Of course, you can add custom on-screen text and tooltips to any of these links:

[Links Tutorial|Links|View the links tutorial]
[Links Feature Tour|ADAPTAVIST:Links|View the links feature tour]

Which results in:

Links Tutorial
Links Feature Tour

Automatically Creating 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:

[My New Page]

People who do not have edit privileges will see a broken link:

[USERGUIDE:My New Page]

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

Linking to pages on external sites uses similar notation to pages within your own site, only you use a full URL instead:

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

http://jarrod.adaptavist.com

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