David Simpson Apps

Blog

Using anchors to link within a page in Confluence

A quick tutorial showing how you add inline anchors to a Confluence page.
David Simpson
David Simpson
Last updated: January 13, 2025

In this guide, we’ll walk through the process of creating and linking to anchors within a Confluence page. Anchors are incredibly useful for navigating long pages, allowing users to jump to specific sections effortlessly.

Watch the video tutorial below, or read on.

Step 1: Adding an anchor

  1. Navigate to the section of your Confluence page where you want to place the anchor. For this example, we’ll add an anchor near the bottom of the page.

  2. Insert an anchor by typing /anchor in the editor (or use the appropriate option from the editor toolbar). Give the anchor a name – in this case, we’ll call it test.

  3. To make the anchor more visible (optional), you can add some text or a marker near it. For example, you could add "Anchor: Test" to remind yourself or other collaborators about its purpose.


Step 2: Linking to the anchor

  1. Highlight the text where you want to add the link, such as "Jump to Anchor."

  2. Click the link button (or use the keyboard shortcut for adding links).

  3. In the link field, type #test (the name of your anchor preceded by a #). This will connect the link to your anchor.

  4. Save your changes by pressing Command + Enter or the Publish button.

  5. Test the link: Clicking on it should take you directly to the section where you added the anchor.


Step 3: Adding an anchor at the top

To make navigation even smoother, you might want to add an anchor at the top of the page as well:

  1. Go to the top of your page and add another anchor, naming it top.

  2. Add a link back to this anchor. For example:

    • Highlight the text "Jump to Top."
    • Use the link button and type #top in the link field.
    • Save your changes.
  3. Now you’ll have an easy way to return to the top of the page.


Testing your anchors

After adding your anchors and links, test them to ensure they work as expected:

  • Clicking "Jump to Anchor" should scroll the page to the section marked with #test.
  • Clicking "Jump to Top" should return you to the top of the page.

With these simple steps, you’ve created a seamless navigation experience within your Confluence page.

By using anchors strategically, you can make your Confluence pages more user-friendly, especially for longer documents.

Photo by Janosch Diggelmann on Unsplash.