Verifying the Setup

After installing the app and adding at least one block, use this checklist to confirm the setup.

When a widget needs to be live

There are two useful verification states:

What you are checking	Does the widget need to be live?
App installation, theme block detection, and Studio surface selection	No
Draft generation and storefront preview	No
Shopper-facing render, storefront network response, and Analytics events	Yes

A widget can be correctly installed even when nothing appears to shoppers. The storefront only renders generated content after a version is set live for the same block kind, page type, placement key, and audience.

Quick verification checklist

1. Check the dashboard

Open Apps > WandStore > Dashboard. Confirm:

• Shopify store status is connected.
• Theme surfaces are detected after you visit or save the theme editor.
• Web Pixel status is active, or repair it from Settings.
• Plan usage shows available generations.

2. Check the theme block

1. Open Online Store > Themes > Customize.
2. Navigate to the template where you added WandStore.
3. Confirm the WandStore Widget or WandStore Homepage block appears.
4. Save the theme.

No live version required

For widget blocks, the theme editor placeholder should show the widget name and placement key. The widget does not need a live generated version for this check.

3. Generate and preview a draft

1. Open Studio.
2. Choose the surface placement you added.
3. Choose Default visitor for the first test, unless you specifically want a customer or cohort test.
4. Write a short instruction, such as Create a banner recommending the most relevant product for this audience.
5. Click Generate draft.
6. Open the generated experience.
7. Click Open storefront preview.

Preview is private

The preview URL includes a private preview flag and shows a WandStore preview banner on the storefront. Preview mode does not count as shopper tracking.

The widget does not need to be live for preview verification. A draft can be reviewed privately before shoppers see it.

4. Set the version live

If the preview looks correct:

1. Click Set selected live.
2. Open the storefront page where the block was added.
3. Confirm the live widget appears in the block.

If it does not appear, confirm that the live version matches the same block kind, page type, and placement key.

Checking with browser developer tools

Open the storefront and use browser developer tools after setting a version live:

1. Elements tab - Look for a container with data-wand-experience-container.
2. Network tab - Filter for /apps/wand/experience. A 200 response means a live version was returned. A 204 response means no matching live version was found.
3. Console tab - Check for messages starting with [WandStore].

Before publishing

If you have not set a version live, an empty block or 204 response is expected.

Verify analytics

Analytics verification requires a live widget. Preview mode does not count as shopper tracking.

After a live widget renders:

1. Open Analytics.
2. Confirm rendered and visible events appear after storefront visits.
3. Test a product click from the widget.
4. If add-to-cart or checkout metrics stay at zero, open Settings and confirm the Shopify Web Pixel is active.

Common causes of an empty block

Symptom	Likely cause	Solution
Block placeholder appears only in theme editor	No live version has been promoted	Generate a draft in Studio and set it live
Storefront request returns 204	No matching experience for the placement	Check kind, page type, placement key, and audience
Customer-specific widget does not show	Customer is not signed in or no customer version exists	Test with a signed-in customer or create a default visitor widget
Add-to-cart analytics are missing	Web Pixel is missing or misconfigured	Repair the Web Pixel in Settings

For more help, see Common Issues.