This page describes how to create a link in your Confluence page to another page. You can create links on your page to:
You can also create a link to a non-existent Confluence page. You can use the following methods to create links:
Linking to Confluence pagesAdding a link using autocompleteYou can use autocomplete to create a link to any page in the Confluence site, if you know the name of the page you want to link to. You can type [ to see a list of suggested links. For details, see Using Autocomplete. Adding a link using the Insert Link dialogTo create a new link using the 'Insert Link' dialog:
| On this page: Related pages: |
Copying and pasting a link from your web browser
To paste a link from your web browser:
- In your web browser, select and copy the title of a Confluence page.
- Edit your Confluence page and paste the title where you want the link to appear.
Linking to web pages
Use the 'Insert Link' dialog to link to an external web page.
To create a link to a web page:
- While editing the page, place your cursor at the point where you want to create the link, or highlight the text that you want linked.
- Click Link in the toolbar, or press Ctrl+K. See keyboard shortcuts for more information.
- Click Web Link and enter or paste the web address into the URL text box.
- Enter link text that will be displayed on the page if required. If you have not highlighted text in the page, and leave the 'Link Text' text box empty, the link will display the destination page name or URL.
- Click Insert.
You can also simply copy and paste a link to a web page into your Confluence page, as described above.
Linking to an anchor
You can link to a specific location within a page, by marking that location with an Anchor macro and then linking to the anchor name.
You can link to an anchor from:
- A link on the same page as the anchor
- Another page in the same space
- A page in another space of the same Confluence site.
- Another web page or another Confluence site, using a specifically formatted URL.
To link to an anchor from within the same Confluence site:
- Edit the page where you want to place the link.
- Choose Link in the editor toolbar, or press Ctrl+K.
Choose Advanced and enter the anchor name into the Link box, noting the following:
- The anchor name is case sensitive. You must use the same pattern of upper and lower case letters as you used when creating the Anchor macro.
Use the following syntax:
Anchor location
Link syntax for anchor
Examples Same page
#anchorname#bottom
#important information
Different page
pagename#anchornameMy page#bottom
My page#important information
Page in another space
spacekey:pagename#anchornameDOCS:My page#bottom
DOCS:My page#important information
- Enter the Link Text (alias) that will be displayed on the page, if required. If you leave the 'Link Text' box empty, the link will display the destination page name or URL.
- Choose Insert.
To link to an anchor from another web page or another Confluence site:
Use a full URL in the following format:
Link syntax | Examples |
|---|---|
| http://myconfluence.com/display/DOCS/My+page#Mypage-bottom http://myconfluence.com/display/DOCS/My+page#Mypage-importantinformation |
Notes about the full URL:
- The page name is repeated in the URL, after the # sign. The second occurrence of the page name is concatenated into a single word, with all spaces removed.
- There is a single dash (hyphen) between the concatenated page name and the anchor name.
- The anchor name in the full URL is concatenated into a single word, with all spaces removed.
- The anchor name is case sensitive. You must use the same pattern of upper and lower case letters as you used when creating the Anchor macro.
Linking to a heading
You can link to a heading that is on the same page, on another page in the same space, or on a page in another space of the same Confluence site.
To link to a heading:
- Edit the page where you want to put the link.
- Choose Link in the toolbar, or press Ctrl+K.
Choose Advanced and enter the heading into the Link box, noting the following:
- The
headingnameis case-sensitive and must be entered without spaces. Use the following syntax:
Heading location
Link syntax for heading
Same page
#headingnameDifferent page
pagename#headingnamePage in another space
spacekey:pagename#headingname
- The
- Enter link text that will be displayed on the page, if required. If you leave the Link Text box empty, the link will display the destination page name or URL.
- Choose Insert.
Linking to an undefined Confluence page
You may want to insert a link pointing to a Confluence page that does not yet exist, but which you intend to create later. This type of link is called an undefined link.
To add an undefined link for later creation of a page:
- Edit the page in which the link should appear.
- Type '[' to trigger autocomplete, and type the name of the undefined page. Alternatively, type the text first, then select the text and type '['.
- Choose Insert Link to Create Page.
When you save the page, Confluence colours the undefined link red. When someone clicks the link, the new page opens in edit mode. That person can then enter the page name, add content and save the page, as usual.
Using a shortcut link
If you have configured shortcut links on your Confluence site, then you can link to an external site using a shortcut link that looks like this: CONF-17025@jira. Our Confluence site (where this documentation is housed) is configured to allow shortcut links to our JIRA site, using the shortcut @jira. So the shortcut link CONF-17025@jira produces this link.
To add a shortcut link using the 'Insert Link' dialog:
- Click Link in the toolbar, or press Ctrl+K. See keyboard shortcuts for more information.
- Click Advanced and enter or paste the shortcut link into the Link box. Shortcut links are case-insensitive.
- Enter link text that will be displayed on the page, if required. If you leave the Link Text box empty, the link will display the destination page name or URL.
- Click Insert.
You can also type '[' and choose Insert Web Link > Advanced to enter a shortcut link.
See Configuring Shortcut Links for more details.