How to add a TOC to your post and use anchor tags

Anchors let you mark a specific section of your post so you can link directly to it, whether that's from a Table of Contents block, a button elsewhere in the post, or a URL you share outside beehiiv. Setting an anchor is also the most reliable way to add a section to your post's table of contents.

This article covers how to set an anchor on a section, display your anchors in a Table of Contents block, and link directly to an anchor from anywhere in your post.

1. In your post, hover over the section you want to anchor and click the 6 dots menu to its left > Select Anchor from the dropdown.
   
   
2. In the Anchor panel:
   
   
   • Toggle on Set anchor to create the anchor. 
   • Show in table of contents is on by default, so this section is included as soon as you set the anchor. Toggle it off if you want an anchor available for direct linking without appearing in the TOC.
   • Enter an Anchor title. This is the label readers see if the anchor is shown in your Table of Contents.
   • The Anchor id field auto-fills as a slugified version of your title (for example, "My Section" becomes my-section), truncated to 35 characters. You can edit this field directly if you want a different id.

Blocks with an anchor set show a small anchor icon in the corner of the block, so you can see at a glance which sections have one.

To display your anchored sections as a navigable list:

1. Type / on the canvas and select Table of Contents under Page structure. 
   
   
   
   Alternatively, start typing /table of contents and the option will show up automatically. 
   
   
2. The block automatically populates with every anchor in the post that has Show in table of contents toggled on.
   
   
3. You can hide or show any listed entry by hovering over it and selecting the eye icon. Selecting the pencil icon opens the anchor's full settings, where you can edit the title, the id, and whether it's included in the TOC.

When you hyperlink text or an image, the link panel lets you either enter a URL or link to an anchor.

1. Highlight the text or select the element you want to hyperlink, then click the Link icon.
   
   
2. The Link panel will open. Type # in the input field. This opens a searchable list of every anchor in the post.
   
   
3. The post editor inserts the slugified anchor id (for example, #pricing), not the title you typed when creating the anchor.
   
   
4. To link to an anchor from outside the post (for example, in an external link or a shared URL), add the Anchor id to the end of the post's URL with a # at the beginning. For example, a post link like yourpublication.com/p/example-post would become yourpublication.com/p/example-post#summary.