How to Set Up Tidio Lyro AI for Your Shopify Store (2026 Guide)

What Lyro Actually Does (And What It Doesn't)

Before you install anything, you need to know what you're getting. Tidio's Lyro is an AI agent that sits inside your Shopify store's chat widget and answers customer questions automatically. It pulls answers from your FAQ content, product pages, and any knowledge base material you feed it.

What it handles well: order status questions, shipping policy inquiries, product availability checks, return procedures, and basic product recommendations through card-style messages. It supports over 30 languages and hands off to human agents when it gets stuck.

What it does not do: process refunds, modify orders, execute custom API calls, or handle multi-step reasoning chains that require external data. If a customer asks "can you cancel my order and apply a discount to my next purchase," Lyro will route that to a human agent. For a full breakdown of capabilities, see our Tidio review.

Knowing these boundaries saves you from over-promising to customers and under-delivering on resolution rates.

Step 1: Install the Tidio App on Shopify

Head to the Shopify App Store and search for Tidio. Click Add app, then authorize the permissions Tidio requests. The install takes about 30 seconds and places a chat widget on your store automatically.

After installation, you'll land on the Tidio dashboard. The widget is already visible to visitors at this point, but Lyro isn't active yet. The default state is a basic live chat window with no AI responses.

If you're running a headless Shopify setup or a custom theme with aggressive script blocking, you may need to add the Tidio embed code manually. Tidio provides a JavaScript snippet in Settings > Installation that you can paste into your theme's layout/theme.liquid file before the closing tag.

A common mistake here: some merchants install both the Shopify app and the manual embed code. This creates duplicate widgets. Use one method, not both.

Step 2: Connect Your Knowledge Base

Lyro's answer quality depends entirely on the content you give it. Go to Lyro AI > Knowledge Base in the Tidio dashboard. You have three ways to feed it information:

Option A: Import from URL. Paste your store's FAQ page URL, shipping policy page, or returns page. Lyro crawls the content and extracts Q&A pairs. This is the fastest method and works well for stores with dedicated FAQ pages.

Option B: Manual Q&A pairs. Write individual question-answer pairs directly in the dashboard. This gives you the most control over exact wording. Recommended for your top 10 most frequent customer questions.

Option C: Upload documents. Upload PDF or text files containing your support documentation. Useful if you have internal SOPs or detailed product guides that aren't published on your site.

Start with Option A for your FAQ and shipping pages, then add 10-15 manual Q&A pairs for questions specific to your products. You can always add more later as you see what customers ask.

The quality of your knowledge base is the single biggest factor in Lyro's performance. Vague, generic answers produce vague, generic responses. Specific, detailed answers produce responses customers actually find helpful.

Step 3: Configure Conversation Triggers

Triggers determine when Lyro starts a conversation proactively. Go to Flows > Add New Flow and set up these three high-value triggers:

Cart abandonment trigger: Fire when a visitor has items in cart and has been idle for 60+ seconds. Lyro can ask if they have questions about sizing, shipping, or the product. This is where the real revenue impact happens. According to our Tidio for Shopify analysis, stores using this trigger see measurable recovery rates on abandoned carts.

Product page dwell trigger: Fire when a visitor spends 30+ seconds on a single product page. Lyro can offer to answer questions about that specific product. Use the product card message type to show the product image and price directly in the chat.

Returning visitor trigger: Fire for visitors who've been to your store before but haven't purchased. Lyro can mention what's new or highlight a current promotion.

Don't set up more than 3-4 triggers initially. Too many proactive messages make your store feel pushy, and customers will close the widget permanently. Start conservative, measure, then expand.

Step 4: Set Up the Handoff to Human Agents

Lyro needs to know when to stop trying and route to a human. Go to Settings > Lyro AI > Handoff Rules and configure these conditions:

• Customer explicitly asks for a human agent
• Lyro confidence score drops below 40% (configurable)
• Conversation exceeds 5 exchanges without resolution
• Customer expresses frustration or anger (sentiment detection)
• Topic involves refunds, complaints, or order modifications

The handoff message matters. Don't use something generic like "Let me connect you with an agent." Instead, use: "I want to make sure you get the right help for this. I'm connecting you with [Your Store Name] support, and they'll have the full context of our conversation."

This small detail improves the customer experience significantly. The human agent receives the entire conversation history, so the customer never has to repeat themselves.

For stores without 24/7 human agents, configure offline hours to collect email and create a ticket instead of promising a live connection. Nothing damages trust faster than "connecting you now" followed by silence.

Step 5: Test Before Going Live

Before enabling Lyro for real customers, run through this testing checklist:

Knowledge base accuracy test. Ask your top 20 customer questions through the widget. Compare Lyro's answers to what a human agent would say. Flag any that are wrong, misleading, or incomplete.

Edge case test. Try questions about products you don't sell, requests in different languages, typos and misspellings, and deliberately confusing multi-part questions. Lyro should handle these gracefully, either answering correctly or handing off.

Handoff test. Trigger every handoff condition and verify the transition works. Check that the human agent receives conversation context.

Mobile test. Open your store on a phone. The widget should be fully functional and not block important elements like the Add to Cart button. Tidio's widget is responsive by default, but custom themes sometimes create overlap issues.

Speed test. Lyro's response time should be under 3 seconds. If it's slower, your knowledge base may be too large or contain contradictory information that forces more processing.

Fix everything before enabling Lyro for all visitors. A bad first impression from an AI agent is worse than having no AI agent at all, because customers will actively avoid using the chat widget in the future.

Step 6: Monitor and Improve

After going live, check the Lyro AI > Analytics dashboard daily for the first two weeks. Key metrics to watch:

Resolution rate tells you what percentage of conversations Lyro resolves without human involvement. A healthy starting point is 40-50%. Top-performing stores reach 65-70% after optimizing their knowledge base. If your resolution rate is below 30%, your knowledge base needs work.

Handoff rate shows how often Lyro gives up. Some handoffs are correct (complex issues), but a high rate on simple questions means your FAQ content has gaps.

Customer satisfaction is measured through post-conversation ratings. If satisfaction drops after enabling Lyro, check which specific question types are causing problems and either improve the answer or add a manual handoff for that topic.

Unanswered questions is the most actionable metric. Every question Lyro couldn't answer is a gap in your knowledge base. Add these Q&A pairs weekly, and your resolution rate will climb steadily.

The stores that get the best results from Lyro treat it like training a new employee. The first week is rough, but if you invest time in filling knowledge gaps based on real conversations, the agent improves quickly.

Pricing: What This Costs

Lyro AI is included in the Tidio+ plan at $29/month, which covers 50 Lyro conversations. Beyond that, extra AI conversations cost $0.50 each. If you handle 200 AI conversations per month, that's $29 + $75 = $104/month.

For a detailed pricing analysis with all tiers and add-on costs, see our Tidio pricing breakdown. We also compare Tidio's pricing against competitors in our Tidio for ecommerce guide.

Whether this is worth it depends on your current support costs. If a human agent costs $15/hour and handles 8 chats per hour, that's about $1.87 per conversation. Lyro at $0.50-0.58 per conversation is a clear saving, assuming the resolution quality holds up.

You can start a free trial with Tidio to test Lyro with real customers before committing. The free tier includes a limited number of Lyro conversations so you can validate the setup.

Alternatives to Consider

Lyro isn't the only option. Depending on your store size and needs, you might also evaluate:

• LiveChat with ChatBot for stores that want separate chat and bot platforms with deeper customization
• Gorgias Automate for high-volume Shopify stores focused on ticket management and refund automation
• HelpDesk for teams that need structured ticketing alongside chat

We maintain a full comparison of these options in our AI Agent Directory, where you can compare capabilities and pricing side by side.

Common Mistakes to Avoid

Enabling Lyro before building the knowledge base. This is the number one mistake. Lyro with an empty knowledge base is worse than no AI at all.

Setting the confidence threshold too low. If Lyro answers questions it's not sure about, it will give incorrect information. Keep the threshold at 40% minimum until you're confident in the knowledge base.

Ignoring the unanswered questions report. Every week, go through the list of questions Lyro couldn't answer and add them. This is the highest-ROI activity for improving your AI agent.

Not testing on mobile. Over 60% of Shopify traffic is mobile. If the widget doesn't work well on phones, you're losing the majority of potential conversations.

FAQ

How long does it take to set up Tidio Lyro on Shopify?

The basic install takes 5 minutes. Building a proper knowledge base and testing takes 2-4 hours. Budget a full afternoon for the initial setup if you want to do it right.

Can Lyro access my Shopify order data?

Yes, through the native Shopify integration. Lyro can look up order status, tracking information, and product availability directly from your Shopify admin.

What happens when Lyro can't answer a question?

It hands off to a human agent with the full conversation context. If no human agents are available, it collects the customer's email and creates a support ticket.

Does Lyro work with Shopify Plus?

Yes, Tidio works with all Shopify plans including Plus. There are no additional requirements or limitations.

How many languages does Lyro support?

Lyro supports over 30 languages and can detect the customer's language automatically. It responds in the same language the customer uses.

Can I customize Lyro's tone and personality?

Yes, in the Lyro AI settings you can adjust the tone from formal to casual. You can also add specific phrases or brand terminology to use in responses.