User Onboarding for Shopify
BreakGround installs on any Shopify store via a snippet in `theme.liquid` — no app store install, no monthly app fee, no Shopify-specific code. It works with Online Store 2.0 themes, classic themes, and Shopify Plus.
BreakGround works with Online Store 2.0 (Dawn, Sense, Crave, Refresh, etc.) and classic 1.0 themes alike. Compatible with Shopify Plus, including bespoke checkout extensions. The SDK doesn't conflict with Shopify apps because it runs as a standalone script in `theme.liquid`. Customer identification works on storefronts that expose `customer.id` through Liquid, including all standard Shopify themes.
How to set up
- Add the snippet to theme.liquid: Open your theme code editor in Shopify admin, find `theme.liquid`, and add the snippet inside the `<head>` tag.
- Identify logged-in customers (optional): Use Shopify's Liquid customer object to pass identification to BreakGround for segment-aware guides.
- Generate your first guide: Open the BreakGround dashboard, paste your Shopify store URL, and AI generates a welcome popup, cart-abandonment guide, or product education tour.
Capabilities
- Works on every Shopify theme: OS 2.0, classic, custom — BreakGround targets rendered DOM so theme structure doesn't matter.
- Customer-aware guides: Segment by orders_count, total_spent, tags, or Liquid customer attributes. Different guides for first-time vs returning customers.
- Cart and checkout guides: Trigger popups on cart abandonment, surfaces nudges on checkout pages, and announce promotions on product pages.
- Shopify Plus compatible: Works on Shopify Plus including custom checkout extensions and Plus-only theme features.
Frequently asked questions
Do I need to install a Shopify app?
No. BreakGround installs as a single script tag in your `theme.liquid`. There is no app store install, no monthly app fee, and no Shopify Permissions to grant.
Will BreakGround slow down my store?
The SDK loads asynchronously and is heavily tree-shaken. Typical impact on Lighthouse is below 50ms — far less than the average Shopify app, which often loads multiple synchronous scripts.
Does the integration affect pricing?
No. BreakGround prices on monthly active users (MAU), not by framework, integration, or site count. The integration is the same on every plan — including the free tier.
