Adding WandStore App Blocks

WandStore renders through Shopify theme app blocks. Add at least one block to create a storefront surface that Studio can target.

Available blocks

Block	Use it for
WandStore Widget	Focused generated UI for banners, modals, upsells, promotions, recommendations, reorder prompts, loyalty modules, and other modules.
WandStore Homepage	A larger full-page or homepage replacement experience for eligible customers.

Choose the right block

Goal	Recommended block
Add a personalized module to an existing page section	WandStore Widget
Run a promotion, recommendation, reorder prompt, modal, or upsell without replacing the rest of the page	WandStore Widget
Add several independent generated experiences to one page	WandStore Widget
Replace the main homepage area for a larger campaign	WandStore Homepage
Let WandStore control the full page story for a specific audience	WandStore Homepage

Choose WandStore Widget when the experience belongs inside an existing theme page. Choose WandStore Homepage when the generated content should control the main page area.

Add a widget block

1. In Shopify admin, go to Online Store > Themes.
2. Click Customize on the active theme.
3. Select the template where the widget should appear.
4. Add a section or block and search for WandStore Widget.
5. Give the widget a clear Widget name. This name appears in Studio and Analytics.
6. Optionally enter a Preset label, such as winback, gifting, reorder, cross-sell, loyalty, bundles, or category education.
7. Leave Placement key override blank unless you need a stable custom key across theme changes.
8. Save the theme.

In the theme editor, the block shows a placeholder and a Generate in WandStore link that opens Studio with that placement prefilled.

Add a homepage block

1. In the theme editor, open the home page or template where a full-page experience should render.
2. Add WandStore Homepage.
3. Keep the default placement key unless you intentionally manage multiple homepage placements.
4. Save the theme.

Homepage blocks affect more of the page

The homepage block can replace surrounding page sections when a live homepage experience exists for an eligible customer. Use it intentionally, because it has a much larger visual footprint than a widget.

How rendering works

On the storefront, each block loads the WandStore script and requests the live experience for its kind, page type, placement key, and visitor context.

• Widget blocks fill only their own container.
• Homepage blocks may hide surrounding homepage sections when active.
• If no live version exists, WandStore returns no content and the Shopify theme remains intact.
• Storefront reads are cache-first and do not run AI generation on the shopper’s page load.

Placement keys

A placement key identifies the surface. If you leave it blank on a widget block, WandStore uses the Shopify block instance ID.

Use a custom placement key when:

• You want to remove and re-add a block without losing the Studio association.
• You want the same generated experience to follow a placement through theme edits.
• You manage several similar widgets and need clearer labels.

Keep placement keys lowercase and descriptive, such as home-vip-modal or product-reorder-banner.

Next step

After adding app blocks, open Studio to generate a draft for one of the surfaces.