How WandStore Works

WandStore adds generated storefront experiences to Shopify through theme app blocks and an embedded Shopify app.

The two block types

WandStore Widget

The widget block renders an isolated generated module inside the existing theme. Use it when the experience should occupy one section of a page. Merchants can add the block multiple times, name each instance, and set a placement key. The generated output determines the widget layout for that placement.

Each widget instance can have its own generated experience and version history.

WandStore Homepage

The homepage block is for full-page or homepage-style personalization. Use it when the experience should control the main page story instead of one section. When a live homepage experience exists for an eligible customer, the block can replace surrounding homepage sections while keeping the theme header, footer, and announcement areas intact.

If the goal is a banner, recommendation, modal, upsell, or reorder module, use WandStore Widget. If the goal is a larger page-wide campaign, use WandStore Homepage.

The generation flow

1. A merchant adds surfaces. The theme editor registers WandStore blocks so the app can list available placements.
2. The merchant chooses an audience in Studio. Audiences can be default visitors, a specific customer, or a Shopify-tag cohort.
3. The merchant writes an instruction. Studio also includes prompt starters for modal box, banner, upsell, and promotion formats.
4. WandStore gathers context. Depending on the audience and surface, WandStore can use store settings, theme style profile, product catalog, active discounts, customer/order context, and cohort context.
5. AI generates a draft version. Drafts are private until promoted.
6. The merchant previews and publishes. A signed storefront preview URL lets the merchant review a version on the real theme. Setting a version live makes it eligible to render.
7. The storefront reads live versions cache-first. Theme blocks request the live experience for their placement. If no live version exists, the block stays empty and the native theme remains intact.

Storefront fallback behavior

WandStore is designed to avoid broken storefront states.

Visitor state	Widget behavior
Matching customer experience exists	Render the customer-specific live widget.
No customer-specific live widget	Fall back to a matching default visitor widget when available.
No live widget for the placement	Render nothing and keep the Shopify theme as-is.

Homepage replacement is more conservative because it affects the full page. Use the homepage block only when a live homepage experience is intentionally prepared for eligible customers.

Versions and control

Each experience can have many generated versions:

• Draft - A private generated version.
• Live - The version currently rendering for shoppers.
• Latest - The newest generated version, whether draft or live.
• Archived/inactive - Preserved for history and analytics but no longer rendered.

Promoting or rolling back changes which version is live. It does not erase older versions.

Analytics

Rendered experiences include tracking metadata for the experience key, version, placement, page type, and render ID. WandStore records:

• Rendered events
• Visible impressions
• Clicks
• Add-to-cart and checkout events from the Shopify Web Pixel
• Orders and attributed revenue from Shopify order reconciliation

Next step

Ready to install? Follow the Quick Start Guide.