//blog · productPRODUCT

What Happens When You Click "Start Setup Wizard" (A Behind-the-Scenes Look)

FEBRUARY 5, 20265 MIN READ

Most Shopify apps make you fill out 15 forms before anything works. We thought: what if you just clicked one button? That's how our setup wizard was born — and people keep asking what actually happens in those 2–3 minutes while it runs.

So here's a completely honest, behind-the-scenes look at what our wizard does when you click "Start Setup Wizard." No marketing fluff — just the actual technical steps explained in plain English.

You Click One Button (That's Actually It)

When you first install FunctionalAI from the Shopify App Store, you see this screen:

//wizard · live_view
Setup wizard start screen showing a single 'Start Setup Wizard' button

That's it. One button. No "What's your business category?" dropdown. No "Describe your brand voice in 500 characters." Just click and watch it work.

Step 1: Fetching Your Store Data

The first thing the wizard does is pull data from your Shopify store. Here's what it grabs:

//wizard · live_view
Wizard progress screen showing all the automated setup steps
  • Products Retrieved: all your products with names, descriptions, prices, images, and variants
  • Pages Retrieved: About pages, shipping info, return policy — anything you've published
  • Blogs Retrieved: if you have blog posts, those get pulled too (great for FAQs)
  • Theme Colors Retrieved: your store's primary colors so the widget matches your brand

We fetch your products so the AI can recommend actual items from your catalog. Not generic answers like "check our product page" — it'll say "Yeah, we have that! Here's the Blue Cotton T-Shirt in Medium for $29.99" with a direct link.

Pro tip
The wizard pulls whatever's currently published in your Shopify store. If you have draft products or hidden pages, they won't be included. Make sure your key info pages (shipping, returns, FAQ) are actually published before running the wizard.

Step 2: Building Your Knowledge Base

The wizard takes all that store data and creates a "vector store" — a searchable knowledge base.

  • Vector Store Created: a searchable database optimized for AI retrieval
  • Files Uploaded: your products, pages, and blog posts get converted into a format the AI can understand

When a customer asks "Do you ship to Germany?", the AI doesn't just guess — it searches your shipping page, finds the relevant info, and answers based on YOUR actual policies. This is called RAG (Retrieval-Augmented Generation).

Common mistake
The AI can only answer based on the info you give it. If your Shopify product descriptions are just "Great t-shirt!", the AI can't magically know the fabric, care instructions, or sizing. Better product descriptions = better AI answers.

Step 3: Creating Your AI Assistant

The wizard builds your assistant. Here's what gets configured automatically:

  • Assistant Created: an OpenAI-powered chatbot configured for e-commerce support
  • Vector Store Linked: connects your knowledge base to the assistant
  • Template Linked: adds pre-built Shopify functions (product search, order lookup)
  • Shared Assistant Created: generates the public-facing chat widget customers will see
  • Shopify Configuration Updated: registers the widget with your store so it works immediately

The "Assistant" is the backend brain — where you configure prompts, temperature settings, and knowledge base connections. The "Shared Assistant" is the public widget customers interact with.

What You Get at the End

After 2–3 minutes, the wizard finishes and you have:

  • A fully configured AI assistant that knows your products, policies, and brand
  • A chat widget that matches your store's colors (no design work needed)
  • Pre-built Shopify integrations (product search, order tracking ready to go)
  • A knowledge base you can expand by adding more files later
  • Everything connected and ready to test — no code, no extra setup steps

Being Honest: What the Wizard Can't Do

The wizard gets you 80% there. The last 20% — your specific brand voice, edge cases, unique business rules — that's where you come in.

  • Write your brand voice for you (it uses a friendly, professional default)
  • Handle super niche product questions if the info isn't in your Shopify data
  • Configure complex custom workflows (like "if customer asks X, do Y")
  • Magically know internal policies that aren't documented anywhere

But here's the thing: most store owners don't need perfect on day one. They need something working that handles "Where's my order?" and "Do you ship to [country]?" so they can stop answering the same questions 50 times a day.

The TL;DR Version

Step 1: Fetch store data — products, pages, blogs, theme colors auto-pulled.
Step 2: Build knowledge base — convert everything into a vector store for RAG.
Step 3: Create assistant — link knowledge base, add Shopify functions, deploy widget.
Step 4: You're ready — test, customize, and enable on your live store.

No forms. No manual uploads. No waiting for support. Just one click and actual automation.

//try_it · free

Want to see it in action?

We have a live demo showing exactly what the wizard builds and how the assistant works with a real Shopify store. Or install from the Shopify App Store and run the wizard yourself — free to test (100 messages, no card).