Change the Primary Domain for Your Hubspot Content
Managing domains in Hubspot is critical when rebranding, launching a new site, or consolidating content. This guide walks you through changing the primary domain for your Hubspot-hosted content safely, so you avoid broken pages, tracking issues, and SEO problems.
The steps below are based on the official documentation for domains and URLs in your account and explain what happens in the background when you switch a primary domain.
How Hubspot Handles Primary Domains
Before you change any primary domain, it is important to understand how Hubspot uses domain settings across tools, content, and tracking.
- A primary domain is the main domain used for a specific type of content, such as website pages, landing pages, blog posts, or the knowledge base.
- You can also have secondary domains and redirect domains for more advanced setups.
- Hubspot relies on your primary domain to generate default URLs, tracking code behavior, and some system pages.
When you change a primary domain in Hubspot, all content previously using that primary domain is reassigned in bulk to the new primary domain for that content type.
Pre-Change Checklist in Hubspot
Before making any edits in your domain settings, review this checklist to avoid issues:
- Confirm domain ownership and DNS. Make sure your new domain is already added, connected, and verified inside Hubspot.
- Review your content types. Determine whether you are changing the primary domain for website pages, landing pages, blogs, or the knowledge base.
- Take note of existing URLs. Export or document key URLs that receive traffic, so you can check them after the change.
- Plan for redirects. If the old domain will no longer be used, decide how you will redirect it to the new one.
- Communicate with stakeholders. Inform marketing, sales, and developers of the planned change and timing.
Preparation is essential because Hubspot will apply updates to a large number of URLs automatically, and you want to verify that your most important assets still work correctly.
Step-by-Step: Change the Primary Domain in Hubspot
Follow these steps in your account to switch the primary domain used for hosted content.
Step 1: Open Your Hubspot Domain Settings
- Sign in to your Hubspot account with sufficient permissions to edit domains and URLs.
- In the main navigation, go to Settings.
- In the left sidebar, navigate to the Website or Domains & URLs section, depending on your interface version.
You should now see a list of domains that have been connected to Hubspot, along with their current roles (primary, secondary, or redirect).
Step 2: Choose the Domain to Make Primary
- Locate the domain that you want to make the new primary one for your content.
- Ensure this domain already appears as a connected domain in your Hubspot account.
- Confirm that DNS is correctly configured and that the domain status is healthy.
If the domain is not yet connected, you must add and connect it first, following the verification steps explained in the official documentation at Hubspot Knowledge Base.
Step 3: Set the New Primary Domain in Hubspot
- In the domains list, find the row for the new domain.
- Use the actions menu (often labeled as Edit or with a dropdown) next to that domain.
- Select the option to make this domain Primary for the relevant content type.
- Confirm the change when prompted.
Depending on your subscription and settings, you can control primary domains separately for:
- Website pages
- Landing pages
- Blog posts
- Knowledge base
Carefully assign the correct primary role in Hubspot so that only the intended content moves to the new domain.
What Changes After You Update the Primary Domain in Hubspot
Once you confirm the change, Hubspot will automatically apply a series of updates to keep your content functional.
URL Updates to Hosted Content
- All pages, posts, and knowledge base articles that used the previous primary domain for that content type will now use the new domain in their URLs.
- Existing slugs and paths usually remain the same, with only the domain portion changing.
- Hubspot processes this update in the background, so large sites may take some time to fully reflect the change.
Tracking and System Behavior in Hubspot
- Default tracking scripts generated by Hubspot will reference the new primary domain configuration, where applicable.
- System pages and some automatic links may also update to the new domain, depending on your setup.
- Cookies and analytics tied to the previous domain may not transfer automatically, so plan for any data continuity needs.
After the update finishes, test your top pages to ensure they load correctly using the new domain and that forms, CTAs, and tracking still behave as expected.
Managing Redirects After a Hubspot Domain Change
To protect search rankings and user experience, you should handle redirects carefully after changing the primary domain in Hubspot.
Use URL Redirects in Hubspot
Set up redirects in your account so visitors to the old domain land on the new URLs automatically:
- Open Settings in your Hubspot account.
- Go to Domains & URLs and then to the URL Redirects tab.
- Create 301 redirects from old domain paths to the corresponding paths on the new domain.
For large sites, use bulk upload or mapping strategies to reduce manual work and keep coverage high.
Decide What to Do with the Old Domain
- Keep the old domain as a redirect domain to route all traffic into the new primary domain.
- Update external links and campaigns over time to point directly to the new domain.
- Monitor analytics in Hubspot to see how much traffic still hits the old URLs.
Post-Change Verification in Hubspot
After you switch the primary domain and set up redirects, perform a quick health check of your implementation.
Technical and SEO Checks
- Load key pages using the new domain to confirm they render correctly.
- Verify forms, CTAs, and interactive modules within Hubspot pages.
- Check that redirects from old URLs return proper 301 status codes.
- Use crawling tools to detect any 404 errors introduced by the domain change.
Analytics and Tracking Checks
- Confirm that page views and events still register in Hubspot reports.
- Validate that any embedded tracking scripts referencing the old domain have been updated if needed.
- Monitor contact creation and form submissions during the first few days after the change.
Ongoing monitoring helps ensure your domain switch in Hubspot does not negatively impact conversion tracking or reporting.
When to Get Additional Help with Hubspot Domains
Complex setups involving multiple languages, brand domains, or subdomains may require extra planning. In those cases, consider working with a Hubspot specialist or technical partner who understands DNS, redirects, and analytics.
You can also consult experienced implementation teams, such as the specialists at Consultevo, to design a domain migration strategy that protects your existing traffic and data.
Finally, continue to reference the official Hubspot documentation for domains and URLs as you maintain and optimize your account over time.
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.
“`
