This page describes how to create a link in your Confluence page to another page.

You can create links on your page to:

  • Other pages in the Confluence site.
  • Web pages outside of Confluence.
  • Anchors or headings, on the same page or other pages.

You can also create a link to a non-existent Confluence page.

You can use the following methods to create links:

  • Autocomplete - to link to Confluence pages or a non-existent page.
  • The 'Insert Link' dialog - to link to Confluence pages and web pages.
  • Cutting and pasting a link from your browser - to link to Confluence pages and web pages.

Linking to Confluence pages

Adding a link using autocomplete

You 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 dialog

To create a new link using the 'Insert Link' dialog:

  1. 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.
  2. Click Link in the toolbar, or press Ctrl+K. See keyboard shortcuts for more information.
  3. Choose one of the tabs on the left to help you find the page or other location that you want to link to:
    • Search– Use this option to link to a page or file in Confluence.
      • Start typing the page name into the text box. Confluence will suggest options as you type.
      • If necessary, limit the search to the current space.
      • Select your link destination from the autocomplete results, or click Search and select the link destination from the search results.
    • Recently Viewed– Use this option to link to a page in Confluence.
      • Select your link destination from recently-visited pages.
  4. 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.
  5. Click Insert.

On this page:

Related pages:

Copying and pasting a link from your web browser

To paste a link from your web browser:

  1. In your web browser, select and copy the title of a Confluence page.
  2. 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:

  1. 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.
  2. Click Link in the toolbar, or press Ctrl+K. See keyboard shortcuts for more information.
  3. Click Web Link and enter or paste the web address into the URL text box.
  4. 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.
  5. 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:

  1. Edit the page where you want to place the link.
  2. Choose Link in the editor toolbar, or press Ctrl+K.

  3. 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#anchorname

      My page#bottom

      My page#important information

      Page in another space

      spacekey:pagename#anchorname

      DOCS:My page#bottom

      DOCS:My page#important information

  4. 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.
  5. 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/spacekey/pagename#pagename-anchorname

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:

  1. Edit the page where you want to put the link.
  2. Choose Link in the toolbar, or press Ctrl+K.

  3. Choose Advanced and enter the heading into the Link box, noting the following:


    • The headingname is case-sensitive and must be entered without spaces.

    • Use the following syntax:

      Heading location

      Link syntax for heading

      Same page

      #headingname

      Different page

      pagename#headingname

      Page in another space

      spacekey:pagename#headingname

  4. 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.
  5. 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:

  1. Edit the page in which the link should appear.
  2. Type '[' to trigger autocomplete, and type the name of the undefined page. Alternatively, type the text first, then select the text and type '['.
  3. 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.

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:

  1. Click Link in the toolbar, or press Ctrl+K. See keyboard shortcuts for more information.
  2. Click Advanced and enter or paste the shortcut link into the Link box. Shortcut links are case-insensitive.
  3. 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.
  4. Click Insert.

You can also type '[' and choose Insert Web Link > Advanced  to enter a shortcut link.

See Configuring Shortcut Links for more details.

 

  • No labels

Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.