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.

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.

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:


  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

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:

  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.