If you’re building pages, emails, or blog posts inside HubSpot, link tracking and content accuracy can be a headache. Broken or outdated URLs, missing UTM tags, and inconsistent links across assets can quickly emerge, especially when multiple teams touch the same content.
Without a consistent system, tracked URLs get overwritten, campaign data disappears, and someone eventually spends hours fixing everything. HubSpot is built to prevent this if you know where to look and how to use its link tools properly.
This guide walks you through inserting and managing links precisely within HubSpot’s rich text modules.
You’ll get clear directions on setting up every link type, editing links after the fact, and keeping your analytics accurate.
Adding Links in HubSpot Rich Text: A Complete Guide
HubSpot’s rich text modules appear in many places: landing pages, website templates, blogs, and marketing emails. They provide WYSIWYG simplicity with options for formatting, images, and links.
Links in these modules span multiple formats:
- Internal or external website URLs
- Anchor links to jump to another point on the same page
- Mailto: links that open email clients
- File links to PDFs or docs in File Manager
- Tracked links or CTAs tied to specific campaigns
Accessing the link option is straightforward. From the toolbar in any rich text editor, click the link icon to open a modal. Here you define your link type, adjust attributes such as “open in new window” or “nofollow,” and, if relevant, apply HubSpot’s tracking capabilities.
This process applies across:
- Website and landing page editors via the Edit Modules panel
- Blog editors, classic or drag-and-drop
- Email editors built for marketing communication
For accurate analytics, HubSpot only tracks clicks when links are either tracked URLs or tied to HubSpot CTAs or campaigns.
How It Works Under the Hood
Understanding how link creation functions helps you build links that don’t break and maintain reporting integrity.
Input: Highlight a chunk of text or select an image, then click the link icon.
Selection: Paste a URL, choose from existing pages and files, or link to an email address or anchor.
Attributes: Define behaviors such as whether the link opens in a new tab, carries a tooltip, or uses UTM tracking for campaigns.
Output: HubSpot inserts the necessary HTML markup (<a> tag) but keeps it editable.
When published, HubSpot validates the link and appends tracking parameters, like utm_campaign or engagement tokens if tracking is enabled.
Key built-in options:
- Adds HTTPS if you forget the protocol
- Supports smart content conditions in personalized modules
- Auto-fills internal URLs to keep traffic structured and clean
- CMS Hub Enterprise or Marketing Hub Pro/Enterprise users can personalize links dynamically using contact properties or lifecycle stages
Main Uses Inside HubSpot
Enhance Website Navigation with Internal Links
Internal linking keeps visitors on-site and supports SEO architecture. Route users to product pages, support docs, or blog content within the same module.
Example:
On a feature overview page, highlight “Dive deeper into use cases” and link it to a blog series using “Link to HubSpot Page.” If the blog’s slug changes, HubSpot automatically preserves the connection.
Track Campaign Effectiveness Through Tracked URLs
Tracked links ensure click data feeds directly into your dashboards, keeping reporting accurate.
Example:
Sending a product launch email? Use HubSpot’s tracked link builder to tag links with the campaign ID, such as Q1_Product_Launch. These actions appear in the campaign performance view, aligning efforts across emails, blogs, and ad touchpoints.
Share Resources Using File Manager Links
Linking to manuals, decks, or datasheets is reliable through HubSpot’s File Manager. It keeps assets centralized and prevents broken links.
Example:
A support article needs a repair guide PDF. Using “Insert File Link,” select the file in File Manager. HubSpot tracks views, and if the file updates later, replacing it preserves the link.
Improve Contact Engagement with Personalization Links
Smart content or personalization allows links to vary by user segment.
Example:
On a download thank-you page, logged-in users see a link to their dashboard, while first-time visitors are prompted to sign up. Smart rules allow multiple URLs within a single module without duplicating content.
Common Setup Errors and Wrong Assumptions
Using Plain-Text URLs Instead of Hyperlinks
HubSpot does not track these. Always use the toolbar’s link functionality.
Forgetting HTTPS on External Links
HubSpot tries to backfill protocols, but not all browsers are forgiving. Manually start URLs with https:// to avoid warnings.
Failing to Update Outdated File Links
Deleting an old file breaks links. Use the Replace option in File Manager to preserve URLs.
Manually Editing Tracked Links
Overriding a tracked URL removes HubSpot’s auto-generated tracking tags. Use the campaign builder to maintain attribution.
Step-by-Step Setup or Use Guide
Follow these steps to insert or update links inside HubSpot rich text modules:
- Open the Content Asset
Go to Marketing > Website > Website Pages or Marketing > Email to locate your content. - Locate the Rich Text Module
Click into the module, then choose Edit in the hover menu. - Select the Element
Highlight the text or image to link. - Click the Link Icon
Use the insert link (chain) symbol in the toolbar. - Choose Link Type
Select Website URL, HubSpot Page, Email Address, Anchor, or File. - Enter or Search for Destination
Paste an external link or search HubSpot for hosted pages and files. - Adjust Advanced Fields
Choose whether the link opens in a new tab, add a tooltip, or toggle attributes like nofollow. - Enable Tracking as Applicable
For email or campaign links, turn on the Tracked URL option or use the pre-assigned campaign URL. - Save the Link
Click Insert or Apply. - Test Before Publishing
Use Preview or send a test email to confirm proper behavior.
To manage an existing link:
- Click the linked text or image
- Choose Edit Link or Remove Link
Measuring Results in HubSpot
HubSpot provides performance insights once links are live and tracked.
Tools to track performance:
- Page Analytics: Click maps and engagement metrics under Website > Website Pages > Analytics
- Email Performance: Link-level CTRs broken down by button text or label
- Campaign Dashboards: Group tracked links by campaign ID to monitor results
- Traffic Analytics: Filter sources by campaign tags to see clicks and visits by origin
Quick tracking checklist:
- Compare CTRs over time
- Scan for broken links using HubSpot’s SEO tool
- Focus dashboards on high-performing CTAs
- Spot-check UTM tags for reporting alignment
Early detection of underperforming links allows for fixes without rewriting content.
Short Example That Ties It Together
Your team launches a June campaign offering free consultations. A coordinator edits the landing page, highlights “Schedule your consultation,” and selects the Tracked URL associated with June_Consultation_Promo.
They enable the link to open in a new tab. After publishing, they test the link. Campaign view shows 150 clicks and 20 consult requests, all tied back to the original campaign.
This simple setup ensures content, campaigns, and analytics stay fully aligned.
How INSIDEA Helps
INSIDEA equips your team with HubSpot pros who manage content systems and reporting frameworks.
Our Services Include:
- Clean portal structures during onboarding
- Maintaining data integrity across modules
- Automating link management in workflows and the File Manager
- Custom dashboards highlighting links that drive pipeline or revenue
Visit INSIDEA to hire HubSpot experts.
Our HubSpot consulting services ensure every link is measurable, reliable, and optimized for reporting.
Effective link management isn’t just a checklist; it ensures every action is meaningful, measurable, and connected across your HubSpot environment.
Our team helps you build a foundation where none of your links go to waste.
