Skip to content
JetStack AI Documentation

Installing the Extension

The JetStack AI Chrome Extension adds a sidebar panel to HubSpot so you can import assets, deploy configurations, run audits, and manage tasks without leaving the portal you are working in. This guide covers installation, first-time authentication, and verifying that the extension is active.

Requirements

Section titled “Requirements”

Before you begin, confirm the following:

  • Google Chrome (version 116 or later) — the extension uses Manifest V3 APIs that require a recent browser build
  • A JetStack AI account — sign up at the JetStack AI web dashboard if you have not already
  • At least one connected HubSpot portal — the extension interacts with portals you have already connected through the dashboard
  • HubSpot access — you must be able to log in to HubSpot at app.hubspot.com (or your regional hublet such as app-na1.hubspot.com or app-eu1.hubspot.com)

Step 1 — Install the Extension

Section titled “Step 1 — Install the Extension”

JetStack AI Chrome Extension listing in the Chrome Web Store with Add to Chrome button

  1. Open the Chrome Web Store and search for “JetStack AI” or navigate directly to the JetStack AI extension listing.
  2. Click Add to Chrome.
  3. In the confirmation dialog, review the requested permissions and click Add extension.

The extension requires the following permissions:

PermissionWhy It Is Needed
storagePersists your authentication tokens and workspace preferences locally
sidePanelOpens the JetStack AI sidebar panel when you are on HubSpot
tabsDetects whether the active tab is a HubSpot page
scriptingInjects the content script that communicates between the sidebar and HubSpot
cookiesReads HubSpot CSRF cookies so the service worker can proxy internal API calls

After installation, the JetStack AI icon appears in your Chrome toolbar. If you do not see it, click the puzzle-piece icon in the toolbar and pin JetStack AI.

Step 2 — Sign In

Section titled “Step 2 — Sign In”
  1. Navigate to any HubSpot page (for example, app.hubspot.com).
  2. Click the JetStack AI icon in your toolbar, or open the Chrome side panel and select JetStack AI.
  3. The sidebar opens and displays the sign-in screen.
  4. Enter your JetStack AI credentials — the same email and password you use for the web dashboard.
  5. Click Sign In.

Authentication is handled by Clerk. On successful sign-in, a JWT token is issued and stored locally. The extension automatically refreshes this token before it expires, using a 20-second TTL buffer to prevent mid-request authentication failures.

If your organization uses SSO, click the SSO option on the sign-in screen and follow the redirect flow. The sidebar will return to focus once authentication completes.

Step 3 — Select a Workspace

Section titled “Step 3 — Select a Workspace”

JetStack AI extension workspace selector dropdown for switching between organizations

If your JetStack AI account belongs to multiple organizations, the extension prompts you to select a workspace immediately after sign-in.

  • The workspace selector appears in the sidebar header.
  • Choose the organization you want to work with from the dropdown.
  • You can switch workspaces at any time by tapping the selector again.

All subsequent actions — imports, deploys, audits, and task views — scope to the selected workspace and its connected portals.

Step 4 — Verify the Extension on HubSpot

Section titled “Step 4 — Verify the Extension on HubSpot”

With authentication complete, confirm the extension is working:

  1. Navigate to any page inside HubSpot (dashboards, contacts, workflows — any section).
  2. Open the Chrome side panel (click the JetStack AI icon or use the keyboard shortcut).
  3. You should see the Home screen with a time-aware greeting, quick action cards, and your asset statistics.

If the sidebar displays a “Not on HubSpot” message, check that:

  • The URL starts with app.hubspot.com or a recognized hublet (app-na1.hubspot.com, app-eu1.hubspot.com, etc.)
  • You are not on a HubSpot marketing page (e.g., www.hubspot.com) — the extension only activates on the application domain
  • The extension is enabled in chrome://extensions

Supported HubSpot Domains

Section titled “Supported HubSpot Domains”

The extension activates on all HubSpot application domains:

DomainRegion
app.hubspot.comDefault
app-na1.hubspot.comNorth America
app-eu1.hubspot.comEurope

If HubSpot introduces new hublets in the future, extension updates will add support automatically.

Updating the Extension

Section titled “Updating the Extension”

Chrome auto-updates extensions in the background. To force an immediate update:

  1. Go to chrome://extensions
  2. Enable Developer mode (toggle in the top-right corner)
  3. Click Update in the top-left corner

After an update, refresh any open HubSpot tabs to load the latest version of the sidebar.

Uninstalling

Section titled “Uninstalling”

To remove the extension, right-click the JetStack AI icon in the toolbar and select Remove from Chrome. This clears all locally stored tokens and preferences. Your JetStack AI account, connected portals, and imported assets are unaffected — they live on the server and remain accessible through the web dashboard.

What’s Next

Section titled “What’s Next”