Skip to Content
Shopify

Shopify Available (v1)

On Shopify you don’t copy any code into your theme. Visz ships an app embed block (Theme App Extension) that you switch on in the theme editor. There you enter your tracking key once and save.

Two ways to connect your shop

  • Through the Visz setup: In the first setup step, choose the platform Shopify. In the Embed snippet step, Connect with Shopify then appears: enter your Shopify domain (it ends in .myshopify.com) and confirm access in Shopify.
  • Through the Shopify App Store: After installing in your Shopify admin, you sign in to Visz and confirm the connection on the page Connect your shop to visz.ai. In doing so you agree to the Terms of Service and the Data Processing Agreement. Visz creates the website for your shop or reuses an existing one with the same domain.

Both paths end in the Verify connection step of the setup. Owners and admins can connect a shop through the setup; after an App Store installation, the workspace owner gives the confirmation.

How the installation works

Visz uses the Online Store 2.0 app embed:

  • Visz does not write into your theme files. It registers a block that you switch on yourself.
  • The installation survives theme updates, because the theme only references the block.
  • The block loads the Visz snippet on every page of your shop as soon as it is switched on and holds a tracking key.

Activate the app embed

After connecting, Visz shows you the card Activate Visz in your theme. Its button opens the theme editor with the Visz block. There:

  1. Under App embeds, switch on Visz Analytics.
  2. Enter your vz_… key in the Visz Tracking Key field.
  3. Save.

Without a key the block loads nothing. You find your key in the snippet on your website’s detail page under Websites; it is the part after id=.

Permissions (data minimization)

Visz only requests the read_themes access from Shopify. With it, Visz checks whether your theme supports app embeds. Visz does not access orders, customers, products, or payments through Shopify, and it writes nothing into your theme.

On Shopify too, Visz measures only after consent in the recommended mode. Visz does not read Shopify’s cookie banner. Consent arrives in one of these ways:

  • through the Visz cookie banner, which you switch on under Settings → Privacy in the Cookie banner tab,
  • through Google Consent Mode v2,
  • through the call visz('consent', true) from your own banner.

Details are in Consent Setup.

Older theme (no Online Store 2.0)

If your shop still runs an older theme without app embeds, that is not an error. Visz then shows you the snippet for manual installation: Online Store → Themes → Edit code → theme.liquid, paste the snippet right before </head> and save. More in Snippet Installation.

What happens on uninstall

When you remove the app in Shopify:

  • Tracking stops for the associated website right away.
  • Access to your shop is removed from Visz.
  • This website’s data is deleted after a grace period.
  • Your Visz account and your workspace remain.

Visz also processes the privacy webhooks required by Shopify (shop/redact, customers/redact, customers/data_request).

Verification

Use the same 4-point diagnosis. Forgot the toggle or the key? Then the check reports that the snippet hasn’t loaded yet. Go back to the theme editor and finish the step. If the check reports that access to your shop has expired, connect it again with Reconnect store.

Where in the dashboard

Websites in the sidebar, then your Shopify website: the Shopify integration card shows whether the shop is connected and offers Disconnect. The snippet on the same page contains your tracking key.

Last updated: