Integrations

Install the HubSpot WordPress plugin

Last updated: January 10, 2019

Marketing Hub Free, Starter, Professional, Enterprise
free

There are two ways to install the Contact Form Builder for WordPress – Conversion Tools by HubSpot WordPress plugin to begin tracking activity on your WordPress pages in HubSpot:

Please note: the original HubSpot for WordPress plugin has been deprecated at the end of 2018. If you're currently using the HubSpot for WordPress plugin, deactivate the plugin first before installing and activating the Contact Form Builder for WordPress - Conversion Tools by HubSpot plugin.

 

Plugin requirements

  • Your website or blog must be using a WordPress.org install. The tracking code plugin cannot be installed on WordPress.com sites, as they do not allow plugins or JavaScript.
  • You must have WordPress version 3.0 or higher installed on your server (the latest version is recommended).
  • The wp_footer function must be included in your WordPress theme’s footer file (footer.php). This function is required for the tracking code to be installed on every page of your site.
  • You must be a WordPress admin to install plugins for your site. If you are not an admin, you can send this article to the person who manages your WordPress install.

 

Install the plugin from WordPress

  • Click Activate Plugin.
  • In the left sidebar menu, navigate to HubSpot. wordpress-plugin-update-hubspot-sidebar
  • If you haven't set up your HubSpot account yet, you'll be prompted to create a HubSpot account. If you're already a HubSpot user, click Log in to your account to finish the installation process.

 

Install the plugin from a zip file

 

User-added image

Deactivate the HubSpot for WordPress plugin

If you're currently using the original HubSpot for WordPress plugin, you must deactivate it before installing the Contact Form Builder for WordPress – Conversion Tools by HubSpot plugin. This includes removing any existing shortcodes with the original plugin, as they are not compatible with the new plugin.

To remove any form shortcodes:

  • Navigate to your WordPress account.
  • In the left sidebar menu, navigate to HubSpot > Shortcodes.
  • If there are form embeds codes saved in fields next to shortcodes, locate the page(s) on your site where they are in use.
  • In the relevant content editor, replace the shortcode (e.g. [hs_form id="0"] ) with the form embed code in the Text tab.
  • On the right of the content editor, click Update.

To remove any CTA shortcodes:

  • Navigate to your WordPress account.
  • In the left sidebar menu, navigate to Calls to Action.
  • If there are saved CTA shortcodes, locate the pages on your site where they are in use.
  • In the relevant content editor, replace the shortcode (e.g. [hs_action id="0"] ) with the CTA embed code in the Text tab.
  • On the right of the content editor, click Update.

Swapping shortcodes

Once all existing shortcodes are removed, deactivate the HubSpot for WordPress plugin:
  • In the left sidebar menu, navigate to Plugins > Installed Plugins.
  • In the HubSpot for WordPress section, click Deactivate.
Deactivate