How to Connect WordPress to HubSpot
Connecting WordPress to HubSpot transforms your WordPress website into a lead generation engine backed by a full CRM and marketing automation platform. The integration adds HubSpot's forms, live chat, popups, and analytics tracking to your WordPress site, while syncing all captured leads directly into your HubSpot CRM. This setup is ideal for businesses that run their website on WordPress but want enterprise-level marketing tools without migrating to a different CMS. You get to keep your WordPress site exactly as it is while layering HubSpot's marketing and sales capabilities on top.
Prerequisites
Make sure you have the following before starting:
- Self-hosted WordPress site: The HubSpot WordPress plugin works with self-hosted WordPress installations (WordPress.org). If you are on WordPress.com, you need a Business plan or higher to install plugins. Your WordPress version should be 5.0 or later for compatibility.
- WordPress admin access: You need administrator-level access to your WordPress site to install and activate plugins.
- HubSpot account: Any HubSpot account works, including the free CRM. For advanced features like marketing automation workflows, email sequences, and custom reporting, you will need Marketing Hub Starter, Professional, or Enterprise.
- HubSpot account permissions: You need Super Admin access or Account Access permissions in HubSpot to connect external integrations.
Step-by-Step Connection Guide
- Log in to your WordPress admin dashboard (typically at yourdomain.com/wp-admin).
- Navigate to Plugins, then Add New in the left sidebar.
- Search for HubSpot in the plugin search bar. The official plugin is called "HubSpot - CRM, Email Marketing, Live Chat, Forms & Analytics."
- Click Install Now on the HubSpot plugin, then click Activate.
- After activation, a HubSpot setup wizard will appear. Click Sign in to HubSpot (or Create a free account if you do not have one yet).
- Log in with your HubSpot account credentials in the popup window that appears.
- Select the HubSpot portal you want to connect to your WordPress site (if you have access to multiple portals).
- Grant the necessary permissions by clicking Connect or Authorize.
- The plugin will automatically install the HubSpot tracking code on your WordPress site. This code enables visitor tracking, form capture, live chat, and analytics.
- You will see a confirmation screen in WordPress indicating the connection is successful. The HubSpot menu item will now appear in your WordPress sidebar.
Configuration and Settings
Tracking Code Verification
After installation, verify the HubSpot tracking code is loading on your site. Visit your website in a browser, view the page source, and search for "hs-script-loader" or your HubSpot portal ID. Alternatively, go to HubSpot Settings, then Tracking and Analytics, then Tracking Code, and use the "Validate" feature to confirm the code is active. The tracking code enables page view tracking, form analytics, and visitor identification.
Form Configuration
The HubSpot plugin lets you add HubSpot forms to any page or post using a shortcode, Gutenberg block, or widget. Go to HubSpot, then Forms in your WordPress sidebar to create new forms or manage existing ones. Forms created here sync directly to your HubSpot CRM. Any submission on your WordPress site creates or updates a contact in HubSpot with the submitted information.
Live Chat Setup
Enable live chat by going to HubSpot, then Live Chat in WordPress. You can create chatflows that appear on your website, set up automated chatbots, and route conversations to specific team members. Configure which pages the chat widget appears on, set business hours, and customize the chat widget's appearance to match your WordPress theme.
Email Capture Popups
Create popup forms, slide-in boxes, and banner CTAs through the HubSpot plugin. Navigate to HubSpot, then Forms, then create a new form and select a popup type. Set triggers for when the popup appears (exit intent, scroll percentage, time on page) and configure targeting rules for which pages display the popup.
Non-HubSpot Form Capture
If you use other WordPress form plugins (like Contact Form 7, Gravity Forms, or WPForms), HubSpot can capture submissions from those forms automatically. Enable the "Collected Forms" feature in your HubSpot settings. This captures submissions from non-HubSpot forms on your WordPress site and creates contacts in your CRM. No form modification is required.
What You Can Do After Setup
- Capture and track all website leads: Every form submission on your WordPress site creates a contact in HubSpot's CRM, complete with the visitor's browsing history, traffic source, and pages viewed before converting.
- Add live chat and chatbots: Engage website visitors in real time with live chat or automated chatbot conversations. Qualify leads through chat and route them to sales reps automatically.
- Track website analytics in HubSpot: View page performance, traffic sources, and conversion rates for your WordPress site directly in HubSpot's analytics dashboard. Understand which pages drive the most leads.
- Build email marketing campaigns: Use HubSpot's email tools to send newsletters, nurture sequences, and promotional emails to contacts captured from your WordPress site. Segment your audience based on their website behavior and form submissions.
- Automate marketing workflows: On Professional and Enterprise plans, create workflows triggered by WordPress form submissions, page views, or specific visitor behaviors. Automate lead nurturing, internal notifications, and CRM updates.
Best Practices
- Replace or supplement existing forms with HubSpot forms: HubSpot forms provide richer data capture and direct CRM sync. Where possible, replace basic contact forms with HubSpot forms to get full tracking and automation capabilities. If you prefer to keep existing forms, ensure Collected Forms is enabled.
- Set up lead scoring based on page views: Use HubSpot's lead scoring to assign points based on which WordPress pages a visitor views. Visits to pricing pages, case studies, and product pages should score higher than blog posts or the homepage. This helps your sales team prioritize leads.
- Create conversion paths on key pages: Add HubSpot CTAs, forms, or chat widgets to your highest-traffic WordPress pages. Use HubSpot's analytics to identify which pages get the most visits and ensure those pages have a clear conversion opportunity.
- Use smart content for personalization: On HubSpot Professional and above, use smart content in forms and CTAs to show different messages to returning visitors versus first-time visitors. This increases conversion rates by personalizing the experience based on CRM data.
- Keep the plugin updated: HubSpot regularly updates the WordPress plugin with new features, bug fixes, and security patches. Enable auto-updates or check for updates weekly to ensure compatibility with the latest WordPress version and HubSpot features.
Troubleshooting Common Issues
- Tracking code not loading: If visitor tracking is not working, check for caching plugins that may be serving a stale version of your pages. Clear your WordPress cache (WP Super Cache, W3 Total Cache, WP Rocket, or whatever plugin you use) and verify the tracking code appears in the page source. Some performance optimization plugins may strip or defer the HubSpot script.
- Plugin conflicts: If your WordPress site behaves unexpectedly after installing the HubSpot plugin, deactivate other plugins one by one to identify conflicts. Common conflicts occur with other marketing or analytics plugins that inject similar tracking codes. Contact HubSpot support with the conflicting plugin name for guidance.
- Forms not submitting: If HubSpot forms are not working, check for JavaScript errors in your browser's developer console. jQuery conflicts, minification issues, or Content Security Policy headers can prevent HubSpot forms from functioning. Ensure your theme does not block external scripts.
- Live chat not appearing: Verify that the chatflow is published and set to appear on the correct pages. Check the targeting rules in HubSpot to ensure the chat widget is configured for your WordPress domain. Also check for ad blockers in your browser that might block the chat widget.
- Connection lost between WordPress and HubSpot: If the plugin shows a disconnection, go to the HubSpot menu in WordPress and click "Reconnect." You may need to re-authenticate with your HubSpot credentials. This can happen after WordPress or plugin updates.
Limitations and Workarounds
- No WordPress content management from HubSpot: You cannot create, edit, or publish WordPress posts and pages from within HubSpot. Content management stays in WordPress. HubSpot is added as a marketing and CRM layer, not a replacement for WordPress's content tools.
- Limited e-commerce tracking: The basic HubSpot plugin does not include e-commerce tracking for WooCommerce stores. If you run WooCommerce, install a separate WooCommerce-HubSpot integration to sync order and product data. The standard plugin focuses on lead capture and marketing.
- Performance impact: The HubSpot tracking code and chat widget add some load to your WordPress pages. On very performance-sensitive sites, this may slightly increase page load time. Workaround: Use HubSpot's script loading options to defer non-critical scripts and test page speed after installation.
- Multisite limitations: If you run a WordPress multisite network, the HubSpot plugin needs to be activated on each individual site within the network. Each site connects to a HubSpot portal independently. Workaround: Use a single HubSpot portal and connect each WordPress site separately.
- Collected Forms data may be limited: When capturing non-HubSpot form submissions, only visible form fields are captured. Hidden fields, multi-step forms, or AJAX-submitted forms may not be captured reliably. Workaround: For critical forms, use native HubSpot forms to ensure complete data capture and CRM sync.
