Studio

Studio is the main workspace for creating generated storefront experiences. Use it to generate widget and homepage drafts, review them on the storefront, and decide which version should go live.

Create an experience

1. Open Apps > WandStore > Studio.
2. Choose a Surface placement. This comes from WandStore blocks in the Shopify theme.
3. Choose an Audience:
   • Default visitor
   • Customer
   • Cohort
4. Write a Generation instruction.
5. Optionally use a starter: Modal box, Banner, Upsell, or Promotion.
6. Enter a clear widget or experience name.
7. Click Generate draft.

The draft appears in the generated experiences list when generation completes.

Use starters as structure

Starters are predefined generation instructions. They give WandStore a strong first draft shape, including the expected layout, interaction style, content hierarchy, and design quality for that experience type. You can use a starter as-is, or combine it with your own instruction for a more specific campaign.

Write useful instructions

Good instructions describe the merchant goal, offer priority, product angle, and audience.

Examples:

• Create a compact reorder widget that highlights products this customer buys repeatedly. Keep it practical and direct.
• Create a premium modal for VIP customers. Feature one high-value product and avoid discount language.
• Create a storefront banner for customers tagged wholesale. Keep copy practical and point to bulk-friendly products.
• Create a promotion widget for the spring collection. Use real discount details only if active discounts are available.

Keep facts grounded

Avoid asking WandStore to invent facts, discounts, inventory, shipping promises, or reviews.

Drafts are private

Generating a draft does not change the storefront. A draft becomes shopper-facing only after you set a version live.

Use this workflow:

1. Generate draft.
2. Open the experience detail page.
3. Review the selected version.
4. Open the signed storefront preview.
5. Set the selected version live when it is ready.

Storefront preview

The preview URL opens the live Shopify storefront with a private preview flag. Preview mode:

• Shows the generated version on the matching block.
• Displays a WandStore preview banner.
• Skips shopper analytics tracking.
• Expires automatically.

If preview is unavailable, confirm that the version has finished generating and the matching theme block still exists.

Version actions

Action	What it does
Generate next version	Creates a new draft using the selected version as context plus your change instruction.
Set selected live	Makes the selected version the live storefront version. This is also how you roll back to an older version.
Discard draft	Removes the current draft while leaving the live version unchanged.
Deactivate	Stops the experience from rendering while preserving versions, prompt context, billing usage, and analytics history.

Versions are preserved

Older versions are preserved. Promotion changes the live pointer; it does not overwrite history.

Generation debug

The detail page can show debug context for generated versions, including:

• LLM provider and model trace
• Prompt version
• Merchant instruction
• Generation brief
• Product titles sent to the model
• Theme style profile details
• CTA links detected in the generated HTML
• Prompt audit JSON

Use debug data to understand why a version was generated a certain way and to write better iteration instructions.

When to use homepage generation

Use a homepage experience when the campaign should replace most of the home page for an eligible customer. Use widgets when you want to improve one placement while keeping the surrounding Shopify theme intact.

Related pages

• Instruction Cheatsheet - Write stronger Studio instructions.
• Personalized Widgets - Understand surfaces and widget settings.
• Audiences - Choose customers and cohorts.
• Versions & Cache - Understand live versions and cache-first delivery.