Create Anchor Links in Help Scout Docs

Anchor links allow readers to jump to a specific part of the page. If your article is really long or text-heavy, consider creating a table of contents or index using anchor links for quick navigation. This article will teach you how to insert anchor links in the Help Scout Docs editor using the id HTML attribute.

Note: If you signed up for Help Scout after December 6, 2022, your experience here will be a little different as we're rolling out an exciting new editor and some things have moved a bit. Please reach out to our team with any questions and we'll be happy to lend a hand!  

In this article

Add an ID to an HTML Element

In the example shown below, clicking on the Editing Your Beacon Mode link will automatically send the reader to the Editing Your Beacon Mode heading further down in the article. We added an id attribute to the h3 header element so that we can create a link to it. Our example is using the header element, but you can add an ID to many different HTML element to create an anchor link. 

Toggle the HTML editor by clicking the </> icon on the toolbar. Within the <h3> tag, we add id="editing" to give this header its ID. Here's what our header looks like with an ID:

<h3 id="editing">Editing Your Beacon Mode</h3>

Creating the Anchor Link

With the header ID in place, complete the anchor connection by adding a link to that header:

  1. Highlight the text that should link to the header anchor.
  2. Click the link icon in the toolbar and select the Insert link option from the dropdown menu.
  3. Add your ID with a preceding # symbol in to the URL field. For our example above, it would look like this: #new
  4. Click the blue Insert button when you're finished.

Here's what the finished anchor looks like in the HTML editor:

<a href="#editing">Editing Your Beacon Mode</a>

Make sure to preview the article to test your anchor links before publishing.

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.