How to Change Your Domain in HubSpot (Without Breaking Links)
Changing your company's domain is one of those projects where the technical steps are straightforward but the blast radius is enormous. In HubSpot, your domain is not just your website URL. It is embedded in email addresses across your contact database, hardcoded into blog post links, baked into landing page CTAs, referenced in email templates, and stored in form submission data. Missing any of these during a domain change means broken links, bounced emails, and confused customers.
This guide walks through every place your domain appears in HubSpot and how to update each one without breaking the things your team depends on.
See how a domain swap works across CRM records in a single operation:
Where your domain lives in HubSpot
Before changing anything, inventory every place your domain appears. It is more places than you think.
HubSpot settings
Website domain. Under Settings > Website > Domains & URLs, your primary domain is connected to HubSpot for hosting your CMS pages. Changing this is a HubSpot configuration change that involves DNS updates and SSL certificate provisioning. HubSpot has detailed documentation for this process, and it is the one part of a domain change that HubSpot handles well.
Email sending domain. Under Settings > Marketing > Email, your email sending domain is configured for deliverability (SPF, DKIM, DMARC). The new domain needs the same DNS records configured before you can send marketing emails from it.
Tracking code domain. The HubSpot tracking code is associated with your domain. If you change domains, the tracking code configuration may need updating to track visitors on the new domain.
CRM data
Contact email addresses. Every contact whose email ends in @olddomain.com has an email address referencing the old domain. These are not automatically updated. If you are changing your company's domain and your employees are contacts in your own CRM, their email addresses need updating. If contacts at other companies have email addresses on your old domain, those need updating too.
Company website properties. Company records have a Website property that stores the company's domain. Your own company record and any other companies on your old domain need the URL updated.
Custom properties. Any custom text property that stores URLs, email addresses, or domain references may contain the old domain. This includes properties like "Customer Portal URL," "Documentation Link," or "SSO Login URL."
Deal and ticket descriptions. Free-text fields on deals and tickets often contain URLs or email addresses referencing the old domain.
CMS content
Blog posts. Internal links in blog post body content often use absolute URLs: https://olddomain.com/pricing instead of relative paths like /pricing. Every one of these links needs updating.
Landing pages. Same issue as blog posts, plus landing page CTAs often contain hardcoded URLs to other pages on your site.
Website pages. Navigation links, footer links, image sources, and embedded content may reference the old domain.
Email templates. Marketing email templates contain links to your website, unsubscribe pages, and preference centers. Templates are easy to update one at a time but time-consuming if you have dozens.
Forms and workflows
Form confirmation redirects. If a form redirects to a thank-you page on your old domain, the redirect URL needs updating.
Workflow actions. Workflows that send emails or redirect to URLs may contain hardcoded domain references.
Sequences. Sales sequences with email templates containing links to your old domain need updating.
The domain change process
Phase 1: Set up the new domain
Before changing any content, configure the new domain in HubSpot and your DNS provider.
-
Add the new domain in HubSpot — Go to Settings > Website > Domains & URLs and add the new domain. HubSpot will provide DNS records (CNAME or A records) to point at HubSpot's servers.
-
Configure DNS — Add the required DNS records at your domain registrar. Propagation takes up to 48 hours, though it is usually faster.
-
Provision SSL — HubSpot automatically provisions an SSL certificate for the new domain once DNS propagates. Verify that HTTPS works on the new domain.
-
Set up email authentication — Configure SPF, DKIM, and DMARC records for the new domain so you can send marketing emails from it. This is critical for deliverability — sending emails from a domain without authentication lands you in spam folders.
-
Keep the old domain active — Do not disconnect the old domain yet. You need it active for redirects.
Phase 2: Set up redirects
Before updating any content, create URL redirects from the old domain to the new domain. This ensures that any link pointing to the old domain still works during and after the transition.
In HubSpot, go to Settings > Website > Domains & URLs > URL Redirects and create redirects. For a full domain change, you ideally want a wildcard redirect: any path on olddomain.com redirects to the same path on newdomain.com.
HubSpot's redirect tool supports individual URL redirects and flexible redirects (pattern-based). If wildcard redirects are not available in your HubSpot tier, you will need to create redirects for your most important pages individually and handle the rest at the DNS or CDN level.
Phase 3: Update CRM data
This is where bulk find-and-replace is essential.
Contact email addresses. Search for @olddomain.com in the Email property and replace with @newdomain.com. Preview the results carefully — you only want to update contacts whose email addresses should reference the new domain. External contacts who happen to have email addresses on your domain (former employees, contractors) may need different handling.
Company website properties. Search for olddomain.com in the Website property and replace with newdomain.com.
Custom URL properties. For any custom property that stores URLs, search for olddomain.com and replace with newdomain.com.
Free-text fields. Search deal descriptions, ticket descriptions, and note bodies for olddomain.com and replace with newdomain.com. Use substring search so it catches the domain in any context (URLs, email addresses, plain text mentions).
Each of these is a separate find-and-replace operation with its own preview and rollback. If any replacement produces unexpected results, you can revert that specific operation without affecting the others.
Phase 4: Update CMS content
Blog posts. Search blog post body content for olddomain.com and replace with newdomain.com. This updates every internal link, image source, and hardcoded URL across all posts.
Be careful with blog posts that intentionally mention external URLs on your old domain (for example, instructions like "visit olddomain.com/setup"). In most cases, these should also point to the new domain, but preview the results to catch any cases where the old domain reference is intentional.
Landing pages. Same approach: search body content for olddomain.com and replace with newdomain.com.
Website pages. If you manage website pages in HubSpot CMS, the same find-and-replace applies. However, website pages often have more complex templates with domain references in modules, global content, and HubL variables. Check your template settings and global content modules separately.
Email templates. Update links in marketing email templates to use the new domain. HubSpot does not offer a bulk email template update, so these typically need to be updated individually in the email editor. For teams with many templates, prioritize the ones in active use and archive the rest.
Phase 5: Update external references
Outside HubSpot, your old domain appears in:
- Google Search Console — Add and verify the new domain, submit an updated sitemap
- Google Analytics — Update the property settings for the new domain
- Social media profiles — Update website links on LinkedIn, Twitter, Facebook, etc.
- Third-party integrations — Any tool that sends traffic to or receives data from your domain
- Ad campaigns — Update destination URLs in Google Ads, LinkedIn Ads, Facebook Ads, etc.
- Email signatures — Update company-wide email signatures that link to the old domain
- Business directories — Google Business Profile, Yelp, Crunchbase, etc.
- Partner and vendor links — Notify partners who link to your site
Phase 6: Monitor and decommission
After the transition:
-
Monitor redirect traffic — Track how much traffic still hits the old domain. This tells you how many external links still point to the old domain.
-
Check for 404s — Review your HubSpot traffic analytics and Google Search Console for pages returning 404 errors on the new domain. These indicate redirects you missed.
-
Monitor email deliverability — Watch your email bounce rates and spam folder placement after switching to the new sending domain. Deliverability takes time to build on a new domain.
-
Plan old domain sunset — Keep the old domain active for redirects for at least 6-12 months. The longer you maintain redirects, the more link equity you preserve. When you eventually stop renewing the old domain, any remaining external links will break — but by then, most should have been updated.
Common mistakes during domain changes
Forgetting email authentication. Sending marketing emails from a domain without SPF/DKIM/DMARC configured will destroy your deliverability. Set this up before sending a single email from the new domain.
Updating content before setting up redirects. If you update blog post links to the new domain before redirects are in place, readers following old links (from social media, external sites, bookmarks) get 404 errors during the transition window.
Not previewing CRM data changes. A blanket find-and-replace on olddomain.com in email addresses could accidentally modify contacts at other companies if those companies have subdomains or similar domain names. Always preview.
Ignoring form data. Historical form submissions store the data as it was entered, including email addresses with the old domain. These are not typically updated (they are historical records), but be aware that reports on form submission data will still show the old domain.
A domain change in HubSpot is manageable if you treat it as a project with clear phases and do not skip the cleanup steps. The bulk data updates are the most time-consuming part, and they are the part where having the right tooling — find-and-replace with preview and rollback — makes the difference between a smooth transition and months of cleaning up broken links.
Keep working through the cleanup
Related HubSpot guides for planning, previewing, and validating the next step.
HubSpot Agency Migration Guide: Moving Client Data
A practical guide for agencies migrating client data into or between HubSpot portals. Covers planning, data mapping, cleanup, and post-migration validation.
Read guideHubSpot Email Domain Migration: Update @company.com Across All Contacts
Migrating email domains? Learn how to update email addresses across your entire HubSpot portal — from @olddomain.com to @newdomain.com — without breaking associations or losing data.
Read guideHubSpot Migration Checklist (Complete Guide)
Everything you need before, during, and after migrating to HubSpot. Covers data mapping, import sequencing, post-migration cleanup, and validation.
Read guideHow to Bulk Update URLs in HubSpot
Old URLs hiding in CRM records, blog posts, and email templates cause broken links and lost traffic. Learn how to find and replace URLs across your entire HubSpot portal.
Read guideStill editing HubSpot records one by one?
Start with 100 free applied records — no credit card required.