Skip to main content
The HoopAI Platform integrates with WordPress so you can embed forms, track site visitors as contacts, and trigger automations from activity on your WordPress site — without rebuilding your site in a new platform.

​
What the WordPress integration does

  • Embed HoopAI forms on any WordPress page or post using a shortcode or widget
  • Track visitor activity — page views and form submissions create or update contact records automatically
  • Trigger automations — form submissions on WordPress pages fire the same automations as forms embedded in HoopAI funnels
  • Live chat — add the HoopAI chat widget to your WordPress site for real-time visitor conversations

​
Installing the HoopAI plugin on WordPress

1

Download the plugin

In the HoopAI Platform, navigate to Sites > WordPress. Download the WordPress plugin (.zip file) from the integration page.
2

Upload to WordPress

In your WordPress admin, go to Plugins > Add New > Upload Plugin. Select the downloaded .zip file and click Install Now.
3

Activate the plugin

After installation completes, click Activate Plugin.
4

Connect your HoopAI account

In the WordPress admin sidebar, find the HoopAI menu item. Click it and enter your HoopAI API key. Click Save. The plugin will verify the connection and confirm it is active.

​
Embedding forms on WordPress

Once the plugin is connected, embed any HoopAI form on a WordPress page using the shortcode: 
[hoopai_form id="YOUR_FORM_ID"]
Replace YOUR_FORM_ID with the form ID found in Sites > Forms (click the form and look in the URL or settings panel). Alternatively, use the HoopAI Form block in the WordPress block editor (Gutenberg) — it appears in the block library after the plugin is activated.

​
Embedding the chat widget on WordPress

The chat widget script can be pasted into the WordPress site header:
  1. Copy the chat widget embed code from Sites > Chat Widget > Get Code.
  2. In WordPress, go to Appearance > Theme File Editor (or use a plugin like Insert Headers and Footers).
  3. Paste the script into the <head> section of your theme.
  4. Save and visit your site to confirm the chat bubble appears.

​
Tracking visitors from WordPress

When the HoopAI plugin is active, it appends tracking parameters to links in emails and automations. When a contact from your HoopAI database visits your WordPress site via one of these links, their activity is logged against their contact record.

​
WordPress and automations

Form submissions from WordPress-embedded HoopAI forms fire the Form Submitted trigger in Automations — the same as forms on HoopAI-built pages. You can:
  • Send confirmation emails
  • Add contacts to pipelines
  • Assign tags based on which page the form was on (use hidden fields to pass the page URL)
The HoopAI WordPress plugin requires PHP 7.4 or higher and WordPress 5.6 or higher. Ensure your hosting environment meets these requirements before installing.
Use hidden form fields to pass the WordPress page title or URL into the HoopAI form submission. This helps you identify which page a lead came from in your contact record and automations.
Last modified on March 4, 2026