#Overview
In this guide, you will learn how to install WP Fusion and set up a direct connection to integrate your WordPress website with your HubSpot account.
To get started install and activate the WP Fusion plugin, then navigate to Settings » WP Fusion.
From the ‘Select Your CRM’ list choose ‘HubSpot ’.
Click ‘Authorize with HubSpot’, and you will be taken to HubSpot, where you can select which account you would like to connect to WP Fusion.
After choosing an account, review the permissions and data that will be shared between your website and HubSpot. Click Connect app to continue,
You will be redirected back to your WordPress site. WP Fusion will verify the connection with HubSpot and load your available lists and contact properties.
Once the connection is completed, click Save Changes below to save the changes.
That’s it! Your site is connected, and new WordPress users and customers will automatically be synced with HubSpot in real time.
- For exporting historical data from before you installed WP Fusion, check out the Exporting Data guide.
- For mapping and syncing additional custom fields with HubSpot, see the Syncing Contact Fields guide.
- For using HubSpot lists to track activity in WordPress and personalize the user experience, check out the Working with Tags and Restricting Access to Content guides.
#HubSpot static vs active lists
WP Fusion uses “Static Lists” in HubSpot to segment contacts (as opposed to “tags” with most CRMs).
HubSpot is a bit different than other platforms in that it has both Active Lists (set by HubSpot), and Static Lists, which can be updated by WP Fusion.
For more information on how Active vs Static lists work with WP Fusion, see the article How Lists Work with HubSpot.
HubSpot has a limit of 1,000 static lists per account. If you need to create additional segments, WP Fusion includes an option to use a custom multiselect field for segmentation instead of static lists.
A multiselect can have up to 5,000 options, so this significantly increases the number of segments you can create.
For more information on using a multiselect for segmentation with HubSpot, see Using a multiselect for segmentation with HubSpot.
#Marketing contacts
In HubSpot, only contacts tagged as marketing contacts can receive marketing emails and be targeted with ads.
In order to send marketing emails to contacts in Marketing Hub, you’ll first need to enable marketing contacts for the WP Fusion app.
All new marketing contacts will count towards your billable contact tier limit.
First head to Settings » Integrations » Marketing Contacts. Next to the WP Fusion app, click the toggle to enable syncing contacts as marketing contacts.
#Non-HubSpot forms
If you are using Site Tracking with HubSpot, HubSpot offers a feature called Collect data from website forms which attempts to automatically detect form submissions on your website and create new contacts.
For best compatibility with WP Fusion, it is recommended to leave this disabled.
If it’s enabled, you could get duplicate contact records in HubSpot (one created by WP Fusion, and one created by the tracking script).
You can disable support for non-HubSpot forms in your HubSpot settings, under Tools » Marketing » Forms.
#Webhooks
Using webhooks in HubSpot workflows and triggers, you can automatically sync lists changes and contact updates from HubSpot back to WordPress. You can even import new users based on HubSpot contacts.
For more information, see the documentation on HubSpot Webhooks.
#Site Tracking
WP Fusion includes a copy of the HubSpot tracking scripts, which can be enabled on the General settings tab.
When site tracking is enabled, any new users, customers, or form submissions will automatically be identified to HubSpot, and their page views will be tracked.
For more information, see the Site Tracking documentation.
#Enhanced Ecommerce
WP Fusion’s Enhanced Ecommerce Addon (available for Plus and Professional license holders) supports sending ecommerce transaction data as Deals to your HubSpot account for sales made in WooCommerce and other popular ecommerce plugins.
For more information, see the documentation on HubSpot Enhanced Ecommerce.
#Event Tracking
WP Fusion’s Event Tracking Addon can send events in real time from supported plugins to HubSpot. For more information, see the documentation.
#Disconnecting HubSpot and WP Fusion
To disconnect WP Fusion from your HubSpot account, navigate to Settings » WP Fusion » Setup in your WordPress admin and click Disconnect next to the HubSpot connection.
This will revoke the OAuth access and refresh tokens stored on your WordPress site. WP Fusion will also automatically call HubSpot’s Uninstall app API to remove WP Fusion from your HubSpot account’s Connected Apps.
Your account’s Super Admins will receive an email notification with a link to reinstall the app if needed.
You can reconnect at any time by selecting HubSpot from the Select Your CRM dropdown and clicking Authorize with HubSpot to complete the OAuth flow again.
#Uninstalling WP Fusion from your HubSpot account
In most cases, disconnecting from within WP Fusion (above) will automatically remove the app from your HubSpot account. However, you can also uninstall the app directly from HubSpot at any time.
To do so, navigate to Settings » Integrations » Connected apps in your HubSpot account, locate WP Fusion in the list of connected apps, click the Actions dropdown, and select Uninstall.
For full instructions, see HubSpot’s documentation on uninstalling a connected app.
#What happens when you disconnect or uninstall
Disconnecting or uninstalling stops all ongoing data sync between WordPress and HubSpot. Specifically:
- New WordPress users and customers will no longer be synced to HubSpot as contacts.
- Updates to existing contact fields, lists, and event tracking will no longer be sent to HubSpot.
- HubSpot site tracking scripts (if previously enabled via WP Fusion) will no longer load on your WordPress site.
- Any HubSpot workflows using the Update WordPress action to send data back to your WordPress site will stop functioning.
Your existing data is not affected. Contact records in HubSpot remain intact, as do WordPress user accounts and the contact ID associations stored in WordPress. If you reconnect later, syncing resumes from that point forward — historical changes that occurred while disconnected are not back-filled automatically. To export historical data after reconnecting, see the Exporting Data guide.
