Personalized Widgets

Personalized widgets are the main WandStore surface. A widget is an isolated generated module that lives inside your existing Shopify theme.

Common widget uses

Use widgets for:

• Product recommendations
• Reorder prompts
• Promotion banners
• Modal offers
• Cross-sell or upsell modules
• Gift guides
• Loyalty or VIP moments
• Category education
• Winback messages
• Subscription-aware account prompts

One widget, many experiences

The same WandStore Widget block can support all of these because the offer type is part of the Studio instruction, not a separate theme block.

Widget settings in the theme editor

Setting	What it does
Widget name	Human-friendly label shown in Studio and Analytics.
Preset label	Optional label for analytics or intent, such as reorder, gifting, or promotion.
Placement key override	Optional stable key for the block. Leave blank to use the block instance ID.

Generated widgets are responsive and should work on mobile and desktop. Studio instructions and prompt starters guide the generated layout for the placement.

Placement keys

Every widget has a placement key. Studio uses the key to connect a generated experience to the correct block.

Use a custom key when you need stability across theme changes:

• home-vip-modal
• home-reorder-banner
• product-cross-sell
• collection-promo-strip

If you do not set one, WandStore uses the Shopify block ID.

Default visitor and customer widgets

Widget blocks can render different live versions depending on the visitor context:

1. Customer-specific widget for the signed-in customer.
2. Default visitor widget for the same placement.
3. Default visitor widget for the default widget placement.
4. Nothing, leaving the native theme unchanged.

Start broad, then target

This fallback pattern lets you start with a default widget, then add targeted customer or cohort experiences later.

Theme-native output

WandStore uses theme style context during generation so widgets can better match the live storefront. The context can include safe classes, colors, typography, and component patterns.

After a major theme change, generate a fresh widget version and review it on the storefront before publishing. If the new draft still feels off-brand, contact support with the widget name and placement.

Related pages

• Adding App Blocks - Add widget surfaces to the theme.
• Studio - Generate widget drafts.
• Instruction Cheatsheet - Write stronger widget instructions.
• Analytics - Measure widget performance.