Shopify integration

The Shopify integration is the smoothest way to get Zubby AI running. It’s an officially-listed Shopify app that authenticates via OAuth, reads your catalog via the Admin GraphQL API, and embeds the widget through a theme app extension — so there’s no code to paste anywhere.

Install the app

Two ways in: open the Zubby listing in the Shopify App Store, or start from Zubby Dashboard → Connect store → Shopify. Both routes end at the same OAuth approval screen.

1. 1

   Authenticate to Shopify

   Approve the connection with the user that has Apps and channels permission on the store you want to install on. Zubby can’t install on stores where you have staff-only access.
2. 2

   Approve OAuth scopes

   We request read_products, read_orders, read_customers, and read_content, plus scoped write access (write_orders, write_products, write_order_edits, write_cart_transforms) that powers cart-rescue discounts and catalog write-back. Approve to continue.
3. 3

   Land back in Zubby

   You’re redirected to your Zubby dashboard with the store row already created. The status will read Syncing catalog.

Scopes explained

Each scope maps to one capability. If your security team needs to audit, here’s the breakdown:

First catalog sync

Shopify runs the initial pull as a bulk operation. For small stores (under 5,000 SKUs) this completes in well under a minute. Larger stores can take up to twenty. Zubby streams progress in Dashboard → Catalog → Sync.

After the bulk import finishes, the background worker generates embeddings so the AI can retrieve products by meaning. Embedding progress shows as a second bar on the same screen.

Webhooks

Zubby registers the following Shopify webhooks (API version 2025-10) on install. You don’t need to do anything — we handle the subscription handshake and HMAC verification on every inbound event.

• products/create, products/update, products/delete
• collections/create, collections/update
• orders/create, orders/paid, orders/cancelled, orders/fulfilled
• checkouts/create, checkouts/update
• customers/data_request, customers/redact, shop/redact (GDPR)

Embed the widget

The fastest way to put Zubby on the storefront is the theme app embed. From your Shopify admin:

1. 1

   Open the theme editor

   Online Store → Themes → Customize on your live theme.
2. 2

   Toggle the App embed

   Click App embeds in the left rail. Find Zubby AI Chat and switch it on.
3. 3

   Save the theme

   Save and reload your storefront. The launcher should appear within a couple of seconds.

Full walkthrough including position tweaks and audience rules at Embed the widget on Shopify.

Manual snippet (Shopify 2.0 themes only, advanced)

If you want to embed without the theme app block — for example to gate the widget on a custom Liquid condition — paste this just before </body> in your theme’s theme.liquid:

<!-- Zubby AI -->
<script
  src="https://cdn.zubbyai.com/widget/v1/loader.js"
  data-store-id="{{ shop.permanent_domain }}"
  data-widget-key="{{ block.settings.widget_key }}"
  async
></script>

Uninstalling

Uninstall from the Shopify Apps page. Zubby receives the app/uninstalled webhook, immediately revokes all tokens, and queues GDPR jobs to redact shopper data on the 30-day schedule. You can re-install later without losing historical analytics — workspace data is retained for 90 days before deletion.