How to Create Anchor Links in Hubspot CMS

Using anchor links in Hubspot is one of the easiest ways to help visitors jump to the exact information they need on a long page or blog post. With a few simple steps, you can add in-page navigation that improves user experience and makes your content easier to scan.

This guide walks through how anchor links work in the Hubspot CMS, how to add them to rich text modules, and how to troubleshoot the most common issues.

What Are Anchor Links in Hubspot?

An anchor link is a hyperlink that takes a visitor to a specific section of the same page instead of loading a new page. In Hubspot, you can create these links inside rich text modules on website pages and blog posts.

Anchor links are useful when you have:

• Long how-to guides and tutorials
• Detailed product or feature pages
• FAQ sections with many questions
• Resource or support hubs with multiple topics

On a Hubspot page, an anchor link is made of two parts:

1. An anchor, which marks the destination spot in your content.
2. A link, which points to that anchor and lets users jump there.

Where You Can Use Anchor Links in Hubspot

You can add anchor links in most rich text areas inside the Hubspot CMS, including:

• Website pages built with drag-and-drop editor modules
• Landing pages that use rich text modules
• Blog posts created in the blog editor
• Knowledge base or help articles powered by Hubspot content tools

In each of these areas, the process for creating anchors and links is nearly the same, because the rich text toolbar is consistent across the Hubspot editors.

How to Add an Anchor in Hubspot

Start by creating the destination that your link will jump to. In Hubspot, this is the anchor ID you place at the right spot in your content.

Step 1: Open Your Hubspot Content Editor

1. Log in to your Hubspot account.
2. Navigate to Marketing > Website > Website Pages or Marketing > Website > Blog, depending on what you are editing.
3. Open the page or blog post where you want to add an anchor link.
4. Locate the specific rich text module that contains the section you want users to jump to.

Step 2: Place the Anchor in a Rich Text Module

Once you are editing the correct rich text area in Hubspot, add the anchor:

1. Click inside the content at the exact spot where you want users to land. This is typically at the start of a heading or a new section.
2. In the rich text toolbar, look for the Insert options, then choose the option to insert an anchor (the icon label may read Anchor or appear in a dropdown depending on your editor version).
3. Type a short, descriptive anchor name. Use only letters, numbers, hyphens, or underscores. Avoid spaces and special characters.
4. Save or update the rich text module.

The Hubspot editor automatically converts that name into an in-page ID. For example, an anchor named pricing would be available as #pricing on the page.

How to Link to an Anchor in Hubspot

After you have created an anchor, you can make a clickable link that jumps to that section. In Hubspot, you can turn any piece of text or image into an anchor link.

Step 3: Choose the Text or Element to Link

1. In the same page or post, highlight the text you want to use as a link. This could be part of a table of contents, a button label, or a phrase in the body copy.
2. You can also select an image or button module if you want the anchor link to be attached to a visual element rather than plain text.

Step 4: Insert the Anchor Link in Hubspot

To connect your link to the anchor:

1. With the text or element selected, click the link icon in the rich text toolbar.
2. In the link dialog that opens, choose the option for a Page or anchor on this page (wording may vary by editor version).
3. From the available dropdown, select the anchor you previously created. Hubspot should list your anchors by the names you entered.
4. Confirm and apply the link.
5. Update or publish your content when ready.

This tells Hubspot to form an in-page link such as #pricing, which sends visitors straight to that section when they click.

How to Test Anchor Links in Hubspot

Before publishing, always test your in-page navigation to make sure visitors will land in the right place.

1. In the page or blog editor, click Preview.
2. Use the preview window to click each anchor link in your content.
3. Confirm that the page scrolls smoothly to the correct section.
4. Check that the final scroll position leaves the heading or section clearly visible, especially if you have a sticky header.

If your layout uses a fixed navigation bar, you may want to place the Hubspot anchor slightly above the visible heading so it is not hidden behind the menu when users jump to it.

Common Anchor Link Issues in Hubspot

Sometimes anchor links do not behave as expected. Here are a few problems you might see in the Hubspot CMS and how to fix them.

Anchor Link Does Not Scroll

• Cause: The anchor name was mistyped or changed after you created the link.
• Fix: Open the rich text module and confirm both the anchor name and the link reference match exactly.

Anchor Scrolls to the Wrong Spot

• Cause: The anchor was inserted in the wrong paragraph or module, or the layout shifted.
• Fix: Move the anchor to the correct heading or top of the section in your Hubspot editor and update the content.

Anchor is Hidden Behind a Sticky Header

• Cause: A fixed header or sticky menu covers the top part of the section.
• Fix: Place the anchor one line above the main heading, or adjust spacing using your theme or custom CSS in Hubspot.

Best Practices for Anchor Links in Hubspot

To get the most from in-page navigation, keep these tips in mind as you structure your Hubspot content:

• Use clear, readable anchor names that match section topics.
• Group anchors into a simple table of contents near the top of long pages.
• Avoid creating too many anchors on a very short page.
• Keep link text descriptive instead of using generic labels like “Click here.”
• Re-test anchor links whenever you rearrange modules or rewrite headings in the Hubspot editor.

More Help with Hubspot and Anchor Links

If you want to see the original product documentation, you can review the official instructions for creating anchor links in the Hubspot CMS on the Hubspot blog.

For teams that need broader strategy support, including content structure, technical setup, and optimization around Hubspot implementations, you can also explore consulting resources like Consultevo for additional guidance.

Once you understand where anchors belong and how the in-page IDs work, creating anchor links in Hubspot becomes a quick, repeatable part of your publishing workflow. Add them to your long-form pages, documentation, and resource hubs to help visitors find what they need with fewer clicks and a smoother on-page experience.

Need Help With Hubspot?

If you want expert help building, automating, or scaling your Hubspot , work with ConsultEvo, a team who has a decade of Hubspot experience.

Scale Hubspot

“`