Insert links and anchors

Send your readers to the right spot by using one of Confluence's content links. You can link to pages or to content on a page, like comments. 

This section details how links can be added to pages without the use of adding anchors.  

Either highlight the text to be used as the link and click the link tool, or just click the link tool.

Clicking the link tool gives you the ability to paste a link or search for recently viewed Confluence blogs or pages; the pages can be from any space in your Confluence site. After establishing the destination of the link, you can modify the text that is displayed to page viewers.

Depending on the destination of your link, there are a variety of ways to get the right URL.

Description

How to find and use

Description

How to find and use

Link to external sites, Confluence blogs, or Confluence pages

  1. Navigate to the page whose link you want to use.

  2. Copy the URL.

  3. Paste the URL in the link tool pop-up where ever you want it to appear on the page, and give it a more friendly name if desired.

Link to a page comment in a Confluence blog or page

  1. Navigate to the page whose link you want to use.

  2. Locate the page comment.

  3. Click the date link below the comment. The page reloads scrolling you to the comment.

  4. Copy the URL.

  5. Navigate to and edit the page where you want to link to the comment.

  6. Paste the URL in the link tool pop-up where ever you want it to appear on the page, and give it a more friendly name if desired.

Link to an inline comment in a Confluence blog or page

  1. Navigate to the page whose link you want to use.

  2. Locate the inline page comment, and click to open the pop-up.

  3. Click the date link below the comment. The page reloads scrolling you to the comment.

  4. Copy the URL.

  5. Navigate to and edit the page where you want to link to the comment.

  6. Paste the URL in the link tool pop-up and give it a more friendly name if desired.

Link to an email address

  1. Navigate to the page where you want to link to the email.

  2. Type the email address in the link tool pop-up where ever you want it to appear on the page, and give it a more friendly name if desired. Confluence automatically creates a 'mailto:' link.

Link to a page’s attachment

Doing this through the link tool is coming soon. In the meanwhile, you can use this process to accomplish your goal.

  1. Navigate to the published version of the page containing the attachment to which you want to link.

  2. Go to More ••• > Attachments.

  3. Right-click on the file name of the attachment, and select Copy Link Address.

  4. Navigate to and edit the page where you want to link to the attachment.

  5. Paste the URL in the link tool pop-up, and give it a more friendly name if desired.

Link to the latest version of an attachment on another page

  1. Navigate to the published version of the page containing the attachment to which you want to link.

  2. Go to More ••• > Attachments.

  3. Right-click on the file name of the attachment, and select Copy Link Address.

  4. Navigate to and edit the page where you want to link to the attachment.

  5. Paste the URL in the link tool pop-up, remove any text after the file extension in the URL, and give it a more friendly name if desired.

Link to a heading on a page or another page

Heading links use a combination of the three character space identifier and the page ID along with the page name and header name.

If you only need to get the URL that takes viewers to a heading, do the following:

  1. Navigate to the page and scroll down to the heading.

  2. Hover over the heading to reveal the link icon to the left of the heading.

  3. Click the link icon to copy the link.

  4. Navigate to and edit the page where you want to link to the heading.

  5. Paste the URL in the link tool pop-up, and give it a more friendly name if desired.

If you need to create several links to headings on a page, it’s more efficient to get the page URL and construct the heading portion yourself.

  1. Navigate to and view the page containing the heading.

  2. Copy the page URL for future use. Keep in mind that the page URL capitalization must match the page title capitalization. Spaces in the page title are replaced with a plus ( + ).

  3. Make note of all the exact headings that to which you want to link.

  4. Navigate to and edit the page where you want to link to the headings.

  5. Paste the page URL in the link tool pop-up, add the page heading title, and give it a more friendly name if desired. Keep in mind that the heading part of the URL must match the capitalization of the page heading. Spaces in the heading title are replaced with a hyphen ( - ).

  6. Repeat Step 6 until you’ve created all the heading links needed.

yoursite.atlassian.net/wiki/spaces/AAA/pages/#####/Page+title+goes+here#Page-heading-goes-here

Link to a Jira issue
(where Confluence and Jira are connected)

  1. Navigate to the Jira issue.

  2. Navigate to and edit the page where you want to link to the attachment.

  3. Paste the URL onto the page. Confluence automatically converts this to a smart link that displays the issue number, summary text, and status.

 

Creating links to non-heading sections of your page isn't possible in the new editor. If you need to link to a part of the page that isn’t worthy of a major heading, try using a smaller heading like an H5 or H6.

Linking to text formatted as headings in tables isn’t currently possible in the new editor.