Integrations

Install the HubSpot WordPress plugin

Last updated: October 16, 2018

free

Follow the instructions below to install the Contact Form Builder for WordPress – Conversion Tools by HubSpot, and begin tracking activity on your WordPress pages within HubSpot.

Please note: the original "HubSpot for WordPress" plugin will no longer be supported and will be deprecated by the end of 2018. If you are currently using the HubSpot for WordPress plugin, skip to the instructions below to deactivate it before installing and activating the Contact Form Builder for WordPress - Conversion Tools by HubSpot.

Plugin requirements

Before you install the plugin, make sure you meet the requirements below:

  • 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 you to add 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 the admin, you can forward the instructions below to the person who manages your WordPress install.

Install the plugin

  • Log in to WordPress.
  • If you are currently using the HubSpot Tracking Code for WordPress, you need to deactivate the old plugin before installing this plugin:
    • On the sidebar on the left side, click Plugins.
    • Locate the HubSpot Tracking Code for WordPress and click Deactivate.
  • Once the plugin is deactivated, navigate to Plugins > Add New.
  • Search for the Contact Form Builder for WordPress - Conversion Tools by HubSpot plugin.
  • Click Install Now.
install-new-wordpress-plugin2
  • Click Activate Plugin.
  • In the left sidebar menu, select HubSpot. wordpress-plugin-update-hubspot-sidebar
  • If you haven't set up your HubSpot account yet, you will be prompted to create an account. If you are already a HubSpot user, click Log in to your account to finish the installation process.
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:

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

To remove any CTA shortcodes:

  • In the WordPress 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 page or post editor, replace the shortcode (e.g. [hs_action id="0"]) with the relevant CTA embed code in the Text tab of the editor.
  • Click Update on the right of the page or post editor.Swapping shortcodes
Once all existing shortcodes are removed, proceed to deactivate the HubSpot for WordPress plugin:
  • In the left WordPress sidebar menu, navigate to Plugins > Installed Plugins.
  • In the HubSpot for WordPress plugin, click Deactivate.
Deactivate