Shopify Available (v1)

On Shopify there is no code to paste. Visz installs as a Theme App Extension (App-Embed). You flip one toggle and tracking starts.

Two ways in

App Store — apps.shopify.com/visz-ai → “Install app”. A fresh connect without a Visz account creates your user and workspace implicitly (sign-up via OAuth) and lands you at /onboarding/verify.
Onboarding — “Continue with Shopify” (step 2) connects an existing account that already has a pending site row. Both paths run through the same OAuth tunnel.

Theme App Extension (App-Embed, OS 2.0)

Visz does not write into your theme files. It registers an activatable App-Embed block that you switch on yourself, so the install survives theme updates — the block is referenced by the theme, not embedded into it. No Asset API, no exemption request. This is the review-compliant path Shopify intends.

Scopes — transparent (data minimization)

Requested	Explicitly NOT requested
`read_themes`, `write_themes`	any `write_*` beyond themes
`read_orders`, `read_customers`	`read_all_orders`
`read_products` (optional, v1)	payment / marketing scopes

Activate the App-Embed — one toggle, then it runs

A deep link opens the theme editor with the Visz block highlighted. There:

Switch on the Visz App-Embed toggle
Save

That’s it. Visz then tracks automatically — you edit no code. That single toggle is the only manual step: no snippet to copy, survives theme updates, auto-events without setup.

Legacy-theme fallback

If your shop still runs an older theme (Debut, Brooklyn, Supply and the like), it has no App-Embed blocks. That is not an error — Visz quietly falls back to the manual path via the plain snippet: edit theme → theme.liquid → paste before </head>.

Verification

Use the same 4-point diagnosis. Forgot the toggle? You’ll see “snippet not loaded yet” — just return to the deep link.

What happens on uninstall

The app/uninstalled hook stops tracking immediately, deactivates the integration, and deletes recordings after a grace period. Your workspace is deactivated, not instantly deleted (GDPR + recovery). The mandatory GDPR webhooks (shop/redact, customers/redact, customers/data_request) are honored.

Last updated: June 5, 2026