HubSpot Content Hub Plugin

Introduction

​

This guide walks you through installing the Airgentic package for HubSpot Content Hub. The widget has two modes:

• Hover widget – appears on every page (bottom‑right launcher).

• Service Hub UI – a full‑width chat experience shown on chosen pages only.

You’ll upload one package, enter your Airgentic IDs once, and then let editors decide where (if anywhere) the Service Hub appears.

​

1. Prerequisites

​​

• HubSpot Content Hub site with permission to upload a theme and edit page templates/modules.

• User permissions – an Admin or user with Design Tools / Website content access.

• Airgentic IDs – have your Account ID and Service ID handy.

• Package file – airgentic.zip (provided by Airgentic).

​

2. Install the plugin

​

1. Download airgentic.zip (link below).

2. In HubSpot, go to Settings → Website → Themes → Upload theme.

3. Choose the ZIP and upload. The theme “Airgentic” (or your chosen label) appears in your account.

4. Open Marketing → Files and Templates → Design Tools to confirm the two modules exist:

   1. Airgentic: Global Loader

   2. Airgentic: Service Hub Mount

5. You do not need to switch your site’s active theme. This package only adds two reusable modules.

​

​

​

​

​

 

​

3. Configure global settings

 

Set your IDs once so the hover widget loads site‑wide.

1. Open any website page in the editor.

2. Click your Footer area, then choose Edit global content (or “Open in global content editor”).

3. In the left Add panel, search for Airgentic: Global Loader and drag it into the header or footer (either is fine).

4. In the module’s fields, enter:

   1. Account ID

   2. Service ID

5. Click Publish to X assets to apply globally.

6. Result: the hover widget is now active on every page.

(View source of any page—you’ll see the <script id="airgentic-script" … async></script> tag injected automatically.)

​

4. Add the Service Hub to selected pages

​​​​​

Option A — Drag‑and‑drop module (recommended)

​

1. Open the page where you want the full chat UI.

2. In the Add panel, search Airgentic: Service Hub Mount.

3. Drag it to the exact spot where the chat should render (typically near the top of the main content).

4. Ensure Show Service Hub on this page is toggled on.

5. Publish the page. The full chat window renders at the module’s position.

 

Note: Position is controlled by where you place the module. Use the module’s Container ID and Extra CSS classes (optional) if your layout or styles require them.

​

Option B — HTML placeholder (when you can’t add modules)

 

If you can’t use the module (e.g., a locked template), insert a Custom HTML block in the desired position and add:

​

<div id="airgentic"></div>

Publish the page. The Service Hub UI binds to this element.

​

5.  Troubleshooting

​​

Widget not showing at all

• Is Airgentic: Global Loader present in global header/footer?

• Were Account ID and Service ID saved?

• Browser/CSP blocking third‑party JS? (Script served from https://chat.airgentic.com; ensure your Content‑Security‑Policy allow‑lists this domain.)

​

Service Hub missing on a page

• Is Airgentic: Service Hub Mount on that page and enabled?

• If using an HTML placeholder, is <div id="airgentic"> present and not hidden by CSS?

• Avoid multiple identical IDs in repeating content (e.g., blog listings). If needed, set a unique Container ID per instance.

​

Duplicate widgets or unexpected behaviour

• Ensure the loader is added once globally. Don’t also paste the script in Site header/footer HTML.

• Remove any legacy hard‑coded Airgentic snippets from templates.

 

Caching / CDN delay

• After first install, publish the global content and the page again.

• If using an external CDN (e.g., Cloudflare), purge cache.

 

6. Removing the integration

​​

• Open the global content editor for your header/footer and delete the “Airgentic: Global Loader” module. Publish globally.

• Remove Airgentic: Service Hub Mount from any pages that use it and republish.

• Optionally, delete the uploaded airgentic theme from Design Tools.

• No data tables or site settings are left behind.

​

​

7. Appendix

​

• Airgentic: Global Loader (module)
  Loads https://chat.airgentic.com/_js/airgentic-1.4.js asynchronously once per site, passing your IDs.

• Airgentic: Service Hub Mount (module)
  Outputs a configurable container (default <div id="airgentic"></div>) for the full Service Hub UI.

​