✦ Setup Wizard Guide

Get Lumio running in 7 easy steps

The setup wizard walks you through everything — from connecting your AI provider to syncing your content. Most sites are live in under 3 minutes.

~3 minutes
🎯
7 steps
🚀
No coding required
1

Welcome

Overview and what to expect

After activating the Lumio AI plugin, the setup wizard launches automatically. This first screen gives you a quick overview of what you are about to configure and sets expectations for the process ahead.

  • The entire wizard takes approximately 3 minutes to complete
  • You can skip steps and return to them later from the settings page
  • All settings are saved automatically as you progress through each step
  • No technical or coding knowledge is required
💡
Before you start
Have your Groq API key ready (free) or an OpenAI key if you prefer. You will need it in Step 3. You can get one at console.groq.com in about 30 seconds.
Lumio AI — Setup Wizard
Welcome to Lumio AI
Let's get your AI chatbot up and running. This wizard will guide you through 7 quick steps. Estimated time: ~3 minutes.
Let's Begin →
Skip Wizard
2

Site Type

Tell Lumio what kind of site you run

Choosing a site type preset instantly configures Lumio for your content structure. Each preset auto-configures three things: the primary post type to sync, entity detection settings, and system prompt hints so the AI understands your domain.

PresetWhat it does
🛒 E-commerceSyncs WooCommerce products, sets product entity detection, adds pricing/inventory awareness
✎ BlogSyncs posts and pages, optimised for article-based Q&A
📍 DirectorySyncs listings and custom post types (e.g. business directories, job boards)
🛠 ServicesSyncs service pages, tuned for service-based businesses
⚙ CustomManual configuration — choose your own post types and entity rules
💡
Not sure which to pick?
Go with the preset that best matches your primary content. You can always change it later in Settings → Lumio AI → General. The Custom option gives you full control if none of the presets fit.
Step 2 of 7 — Site Type
What kind of site is this?
Choose a preset to auto-configure Lumio for your content.
🛒
E-commerce
WooCommerce products
Blog
Posts & pages
📍
Directory
Listings & CPTs
🛠
Services
Service pages
Custom
Manual configuration
3

API Key

Connect Lumio to an AI provider

Lumio needs an AI provider to generate responses. The free and recommended option is Groq, which provides fast inference at no cost. Here is how to get your key:

  1. Go to console.groq.com in your browser
  2. Sign up for a free account (Google or GitHub login works)
  3. Navigate to API Keys in the left sidebar
  4. Click Create API Key, give it a name (e.g. "Lumio")
  5. Copy the key and paste it into the wizard field
Connection test
The wizard automatically tests your API key before saving. You will see a green checkmark if the connection is successful. If it fails, double-check that you copied the full key.
💎
Pro alternative: OpenAI
Pro users can use OpenAI (GPT-4o) as their provider for higher-quality responses. Enter your OpenAI API key and select the model from the dropdown. This requires a paid OpenAI account.
Step 3 of 7 — API Key
🔑
Connect your AI provider
⚡ Groq FREE
OpenAI PRO
API Key
gsk_a7bK9x...••••••••
Connection successful — Groq is ready
4

Bot Identity

Personalise your chatbot's appearance

Give your chatbot a name and personality that matches your brand. These values appear in the chat widget header and the welcome screen visitors see when they first open the chat.

  • 💬 Bot name — displayed in the chat header (e.g. "Lumio Assistant", "ShopBot", "HelpDesk")
  • 🎨 Avatar icon — choose from built-in icons or upload your own
  • 👋 Welcome title — the headline shown when the chat opens (e.g. "Hey! How can we help?")
  • 📝 Welcome subtitle — supporting text under the title (e.g. "Ask me anything about our products")
  • 🚀 Suggestion pills — comma-separated quick questions visitors can click to start a conversation (e.g. "Shipping info, Return policy, Best sellers")
💡
Great suggestion pills
Think about the 3–4 questions your visitors ask most often. These become clickable pills beneath the welcome message, giving visitors an instant starting point and boosting engagement.
Step 4 of 7 — Bot Identity
Bot Name
Lumio Assistant
Avatar
💬
🤖
🚀
Welcome Title
Hey! How can we help?
Welcome Subtitle
Ask me anything about our products
Suggestion Pills
Shipping info, Return policy, Best sellers
Shipping info Return policy Best sellers
5

Layout

Choose how the chatbot appears on your site

Lumio offers three layout modes. Pick the one that works best for your site's UX:

  • 📄 Full-page chat — a standalone page (like ChatGPT or Claude). Visitors navigate to a dedicated chat URL. When selected, the wizard automatically creates the WordPress page with the correct Lumio template applied.
  • 💬 Bubble widget — a floating chat button that appears on every page of your site. Visitors click the bubble in the bottom-right corner to open the chat overlay.
  • 💫 Both — use the full-page chat and the bubble widget together. PRO
Auto-page creation
If you select Full-page or Both, Lumio creates a new WordPress page (e.g. /chat) and assigns the Lumio Chat template automatically. No shortcodes or manual page setup needed.
Step 5 of 7 — Layout
Choose your layout
Full-page
Standalone chat page
Bubble
Floating widget
Both PRO
Page + widget
6

Customise

Theme, lead capture, and rate limits

Fine-tune the look and behaviour of your chatbot. This step covers three areas:

  • 🎨 Theme picker — choose from 5 visual themes. Classic and Minimal are free; Dark Night, Pastel, and Glass are Pro themes. Each theme changes the header gradient, bubble colours, input styling, and overall mood.
  • 📬 Lead capture — toggle on to collect visitor name and email before or during the chat. Enter a notification email to receive alerts when new leads come in.
  • Rate limit — set the maximum number of messages a single visitor can send per hour. This protects your API usage and prevents abuse. Default is 30 messages/hour.
Rate limiting
If you are on the Groq free tier, keep the rate limit at 30 or lower to stay within API quotas. Pro users with OpenAI can safely increase this to 60+.
Step 6 of 7 — Customise
Pick a theme
Classic
Hello!
Hi there
Minimal
Hello!
Hi there
Dark
Hello!
Hi there
Pastel
Hello!
Hi there
Glass
Hello!
Hi there
📬 Lead Capture
Collect name & email
Notification Email
hello@yoursite.com
Rate Limit (msgs/hour)
30
7

Sync & Build Knowledge Base

Index your content so the AI can answer questions

The final step indexes your WordPress content into Lumio's knowledge base. This is what powers accurate, hallucination-free answers. Here is what happens behind the scenes:

  1. Select which post types to index using the checkboxes (posts, pages, products, etc.). Each shows a count of available items.
  2. Click "Build Knowledge Base" to start the sync process.
  3. Lumio processes your content in batches of 200 posts at a time, extracting text, custom fields, and metadata.
  4. A TF-IDF vector index is built from the extracted content, enabling fast semantic search.
  5. A progress bar shows real-time status. Once complete, your chatbot is ready to answer visitor questions.
💡
Re-syncing
You can re-sync at any time from Settings → Lumio AI → Knowledge Base. Lumio also auto-syncs when you publish or update content (configurable). Large sites with 1,000+ posts may take 1–2 minutes to index.
Step 7 of 7 — Sync
Select content to index
📄
Posts
142 items
📃
Pages
18 items
🛒
Products
67 items
📂
Custom CPT
24 items
227 / 227 items indexed Complete ✓
🎉
Knowledge base ready!
227 items indexed · TF-IDF vectors built

Ready to set up Lumio AI?

Install the plugin and the setup wizard will walk you through everything. Your chatbot will be live in under 3 minutes.

Get Lumio AI Free