WandStore Documentation
Welcome to the WandStore documentation. These docs cover the Shopify app, theme app blocks, Studio, audiences, analytics, billing, privacy, and troubleshooting.
What is WandStore?
Section titled “What is WandStore?”WandStore is a Shopify app for generating AI-powered storefront experiences that fit inside an existing Shopify theme. Merchants add WandStore app blocks to theme surfaces, then use Studio to generate, preview, version, and publish the content that appears in those blocks.
Core concepts
Section titled “Core concepts”| Concept | What it means |
|---|---|
| Surface | A place in the Shopify theme where WandStore can render, such as a widget block on the home page or a homepage replacement block. |
| Widget | A focused generated module, such as a banner, modal, promotion, upsell, recommendation, reorder prompt, or campaign block. |
| Experience | A generated output for one surface, audience, and placement. Each experience can have drafts, live versions, and history. |
| Audience | Who should see an experience: default visitors, one customer, a tag cohort, or an AI smart cohort. |
| Studio | The app screen where merchants create experiences, write instructions, generate drafts, promote versions, and iterate. |
| Campaign | An AI-planned promotion that coordinates an audience, an optional discount, an onsite widget, and a marketing email — reviewed and launched by the merchant. |
Which block should I use?
Section titled “Which block should I use?”| Use case | Best block |
|---|---|
| Add a banner, modal, upsell, recommendation, reorder prompt, gift guide, loyalty module, or promotion inside an existing page | WandStore Widget |
| Test a personalized module without changing the rest of the theme page | WandStore Widget |
| Add multiple personalized surfaces to the same page | WandStore Widget |
| Replace most of the home page for a larger campaign while keeping the theme header and footer | WandStore Homepage |
| Build a full-page experience for a specific customer or campaign audience | WandStore Homepage |
Choose WandStore Widget when the generated experience belongs inside an existing page section. Choose WandStore Homepage when the generated experience should take over the main page area.
How it works in a nutshell
Section titled “How it works in a nutshell”- Install WandStore from the Shopify App Store and choose a plan in Shopify admin.
- Complete onboarding, including AI data consent.
- Add a WandStore Widget block for a focused module, or a WandStore Homepage block for a page-wide experience.
- Open Studio and choose a surface, audience, and generation instruction.
- Generate a private draft, preview it on the storefront, then set the selected version live.
- Track rendered, visible, click, add-to-cart, checkout, order, and revenue performance in Analytics.
What’s in these docs
Section titled “What’s in these docs”| Section | What you’ll find |
|---|---|
| Getting Started | Product overview, surfaces, and quick start |
| Installation | Shopify app setup, theme blocks, and verification |
| Configuration | Dashboard, settings, billing, theme analysis, and operational controls |
| Guides | Studio, instruction writing, widgets, audiences, analytics, and version management |
| Campaigns | The AI campaign agent, campaign audiences, and campaign emails |
| Developer Tools | Drive your store from the terminal with the wand CLI or from an AI assistant via the MCP server |
| Privacy & Security | Data usage, AI processing, GDPR, and security practices |
| Troubleshooting | Common setup, rendering, analytics, and support issues |
Key features
Section titled “Key features”- Personalized widgets - Generate merchant-directed blocks that live inside existing Shopify pages.
- Studio workflow - Create drafts, preview on the storefront, promote live, iterate from prior versions, roll back, or deactivate.
- Theme-native styling - Analyze the live storefront so widget prompts can reuse safe theme classes, colors, typography, and component patterns.
- Audience targeting - Generate for default visitors, a specific customer, or a cohort built from Shopify customer tags.
- Homepage experiences - Create page-wide personalized campaigns when a single widget is not enough.
- AI campaigns - Let the agent plan a complete promotion - audience, offer, onsite widget, and email - then review, approve, and launch.
- Command-line control - Drive campaigns, cohorts, experiences, emails, and analytics from the terminal with the
wandCLI, or script them into your own automation. - AI assistant control - Connect Claude, Cursor, or any MCP client to your store with the WandStore MCP server and manage campaigns, audiences, and emails in conversation.
- Performance analytics - Measure render, visibility, click, add-to-cart, checkout, order, and attributed revenue signals.
- Privacy-first design - Use Shopify customer, order, product, audience, and store context without browsing-history tracking, payment data, or customer passwords.
Ready to get started?
Section titled “Ready to get started?”Start with What is WandStore?, follow the Quick Start Guide, or open the WandStore Shopify App Store listing when you are ready to install.