To add an anchor link in HubSpot, open your page, post or knowledge base article, click a rich text module, and choose Insert > Anchor from the rich text toolbar to create the anchor. Then highlight the text you want visitors to click, click the link icon, and choose Link to > Anchor on this page. To link a button instead, enter # and the anchor name (for example, #pricing) in the Button module's URL field.
Checked against the HubSpot Knowledge Base on October 20, 2026.
Anchor links (also called jump links) send a visitor to a specific section of a page instead of the top. They work on website pages, landing pages, blog posts and knowledge base articles, and HubSpot lists the feature as available with all products and plans.
What is an anchor link?
An anchor link has two parts. The anchor is the marker in your content, the spot a visitor should land on. The link points to that marker using the # symbol followed by the anchor's name, such as #faq. When a visitor clicks it, the browser scrolls to the marker on the same page, or opens the other page and scrolls there.
In plain HTML, the marker is an element with an id attribute, and the link is an href that ends in #id. MDN's HTML reference says an id "must be unique within the entire document," and that one of its purposes is to identify a single element when linking with a fragment identifier. HubSpot's editor handles the HTML for you, so you never need to type it.
What you need before you start
| Item | What HubSpot requires |
|---|---|
| Subscription | All products and plans |
| Pages and blog posts | Edit permission to edit the rich text module |
| Knowledge base articles | Service Access with the Knowledge base articles permission |
| Where anchors live | Inside rich text modules |
| Emails | Not recommended, because some email clients may not support anchor links |
How to create an anchor in HubSpot
Create the anchor first. You cannot link to a section until it has one.
- Open your content. For website pages, go to Content > Website Pages. For landing pages, go to Content > Landing Pages. For blog posts, go to Content > Blog. For knowledge base articles, go to Service > Knowledge Base. If your account shows a More menu, click it first.
- Click the name of the page, post or article.
- Click the rich text module where the section starts.
- In the rich text toolbar, click the Insert dropdown menu and select Anchor.
- In the pop-up box, enter a name for the anchor, such as pricing-plans, then click Insert.
- The anchor appears as a blue line with an anchor symbol. To move it, click it and drag it to a new spot in the content.
Place the anchor right before the heading of the section, so the heading sits at the top of the screen when a visitor lands.
HubSpot anchor naming rules
HubSpot's rules for anchor names are short:
- The name must begin with a letter.
- It can contain only letters, numbers, hyphens, underscores, colons and periods.
- Separate multiple words with hyphens.
| Anchor name | Works? | Why |
|---|---|---|
| pricing-plans | Yes | Starts with a letter, words joined by a hyphen |
| faq.setup | Yes | Periods are allowed |
| step_2 | Yes | Underscores and numbers are allowed |
| 2026-pricing | No | Starts with a number |
| pricing plans | No | Spaces are not allowed |
| pricing&plans | No | The ampersand is not an allowed character |
A good habit: keep every name lowercase and descriptive, and use each name only once per page. Then the link you type always matches the anchor you created, and two sections never compete for the same name.
How to link text to an anchor on the same page
- Open the page, post or article in the content editor.
- Highlight the text you want to turn into a link, such as an entry in your table of contents.
- In the rich text toolbar, click the link icon.
- In the pop-up box, click the Link to dropdown menu and select Anchor on this page.
- Click the Anchor dropdown menu, select the anchor, then click Insert.
- Click Publish or Update in the top right.
Because you pick the anchor from a dropdown, you avoid typos. If the anchor you want is missing from the list, create it first with Insert > Anchor.
How to link to an anchor on a different page
You can send visitors from one page straight to a section of another page, for example from a blog post to the FAQ on your pricing page.
- Make sure the anchor exists on the destination page.
- On the page where the link will live, highlight the text and click the link icon.
- In the Link to dropdown menu, select URL.
- Enter the full URL of the destination page, then the # symbol and the anchor name. HubSpot's example is https://mydemo-page.test/home#faq.
- Click Insert, then Publish or Update.
The same format works anywhere you can paste a URL, such as a social post or a sales email, because the browser reads the part after # and scrolls to it once the page loads.
How to link a button to an anchor
Buttons are the usual choice for a "See pricing" or "Jump to the form" call to action near the top of a long landing page. HubSpot documents this for website pages, landing pages and blog posts with a Button module in a drag and drop area.
- In the content editor, click the Add icon in the left sidebar.
- Expand the Forms and Buttons section, then drag the Button module into position.
- In the Button text field, enter the label visitors will see.
- In the URL field, enter # followed by the anchor name, such as #pricing-plans. To jump to a section on another page, enter the full URL, then # and the anchor name.
- Style the button on the Styles tab.
- Click Publish or Update in the top right.
One rule to remember for CTAs: HubSpot says anchor links added to CTAs must have the Track clicks through the browser option selected. If a CTA does not scroll, check that setting first.
Build a table of contents with anchor links
A table of contents is the most common use of anchor links. Here is the workflow in HubSpot:
- Add an anchor before each major heading, named after the section (overview, features, pricing, faq).
- At the top of the page, add a rich text module with a short list of the section names.
- Link each list item to its anchor with Link to > Anchor on this page.
- Optionally, add a small "Back to top" link after long sections that points to an anchor at the top of the page.
Keep the labels in the table of contents identical to the headings they point to. Visitors trust a menu that matches what they see when they land.
Fix an anchor hidden behind a sticky header
If your site has a fixed or sticky navigation bar, a jump can land with the section heading tucked under the bar. HubSpot's anchor article does not describe an automatic offset, so the fix is a line of CSS.
The CSS Scroll Snap specification from the W3C says scroll-padding affects scroll-into-view operations, and that scroll-margin adjusts the area used when a page is navigated to a fragment. In practice, one rule on the page covers every anchor:
html { scroll-padding-top: 90px; }
Set the value to the height of your header plus a little breathing room. To add it to one page, put the rule inside a style tag in the page's Head HTML: in the content editor, open the Settings menu, select Advanced, and paste it into the Head HTML field under Additional code snippets. To apply it to a whole domain, click the settings icon, go to Content > Pages, choose the domain, and add it in the Site Header HTML section. HubSpot notes that head and footer HTML options vary by subscription and content type, so your developer may prefer to add the rule to the theme stylesheet instead.
Want the jump to glide instead of snap? MDN documents scroll-behavior: smooth on the root element for scrolling triggered by navigation. Wrap it in a prefers-reduced-motion: no-preference media query so visitors who turned on reduced motion on their device are not affected.
Troubleshooting HubSpot anchor links
| Problem | Likely cause | Fix |
|---|---|---|
| The link does not scroll to the section | The anchor name in the link does not match the anchor | Re-link with Link to > Anchor on this page and pick from the dropdown |
| The anchor name has spaces or symbols | The name breaks HubSpot's naming rules | Start with a letter, remove spaces and symbols other than hyphens, underscores, colons and periods |
| The page jumps to the wrong section | The same name is used twice | Rename one anchor so each name is unique on the page |
| The heading lands under the menu | A sticky or fixed header | Add a scroll-padding-top rule as shown above |
| A CTA does not scroll | Click tracking setting | Select Track clicks through the browser on the CTA |
| A cross-page link opens the page but does not scroll | Missing # or wrong anchor name in the URL | Check the full URL, the # and the name on the destination page |
| Anchor links in a marketing email fail | Email client support | Avoid anchors in emails, as HubSpot recommends |
Always test on the published page, on desktop and on a phone, since the header height and layout can differ between the two.
Do anchor links help SEO?
Anchor links mainly help readers. They make long pages easier to scan and let you link other content straight to the answer a visitor needs. Keep the search side in perspective: Google's URL structure guidance says not to use fragments to change the content of a page, because Google Search generally does not support URL fragments. A #section link is a pointer into the same page, not a new page for Google to index. Use anchors to organize content that already lives on one URL, and give separate topics their own pages.
Track clicks on your anchor links
To see which sections visitors jump to, you can track clicks with a codeless custom event. HubSpot offers two codeless event types, Clicked element and Visited URL, on Professional and Enterprise tiers of Marketing Hub, Sales Hub, Service Hub, Data Hub, Content Hub, Smart CRM and Revenue Hub.
- Go to Data Management > Event Management.
- Click Create an event, then select Create custom event.
- Select Use visualizer, click Next, enter your page URL and click Done.
- Name the event and choose Clicked element.
- Click the target icon, select a table of contents link or button, choose where to track it, add a tracking name and click Next.
A single Clicked element event can track up to 30 elements, so one event can cover a full table of contents. The page must have the HubSpot tracking code installed. HubSpot does not list scroll depth as a codeless event type, so measure clicks rather than scrolling.
A worked example (hypothetical)
Imagine a software company with a long pricing page: plans, a feature comparison, implementation details and an FAQ.
- The marketer adds four anchors in the page's rich text modules: plans, compare, implementation and faq.
- Under the hero, a short table of contents links to each one with Link to > Anchor on this page.
- The hero's Button module gets #plans in its URL field, so "See plans" scrolls straight to pricing.
- The site has a 72-pixel sticky header, so the developer adds html { scroll-padding-top: 90px; } to the page's Head HTML.
- A blog post about onboarding links to the full pricing page URL followed by #implementation, so readers land on the implementation section.
- A Clicked element event tracks the four table of contents links, and the team checks which sections get the most jumps before deciding what to move higher on the page.
Getting help with HubSpot pages
INSIDEA is an Elite HubSpot Partner and the growth operating system for modern businesses. If your HubSpot pages need clearer structure, cleaner templates or better tracking, our HubSpot team can work through it with you.
How INSIDEA works
