Shopify chatbot: add Kyros to your Shopify store
Kyros answers customer questions from your store pages in German, English and seven more languages, and links its sources. You add it with a snippet in your theme; there is no app.
To add a Shopify chatbot with Kyros, you paste a snippet into your Shopify theme: into the theme.liquid file or into a Custom Liquid section in the footer. Kyros has no app in the Shopify App Store and no connection to the orders, products or customers in your store. The chatbot answers from the store pages you list in Kyros, such as shipping, returns, FAQ or size guides, and lists the pages it drew on under “Further Links” below each answer.
What the chatbot knows about your store, and what it doesn’t
In Kyros, you paste the URLs of the pages the assistant should know, one per line. Kyros ingests them and can re-sync them every 6, 12 or 24 hours or weekly, so updated shipping costs or return windows come through. Kyros doesn’t crawl a whole site or sitemap on its own, and you can’t upload files such as PDFs. For questions where the exact wording matters, you write Golden answers.
Because Kyros isn’t connected to Shopify, the chatbot knows your product range only as far as the listed pages describe it, and it doesn’t know your orders at all. It can’t answer “Where is my order?” by itself. That only works if you connect your own API and call it from an Interactive Card (Beta); there’s an example below. If your content has no answer, the assistant is instructed to say so. That is not a guarantee.
What your customers see
In your store, the chat appears as a floating bubble or as an inline frame in a fixed spot, for example on your FAQ page. You set colors, font, logo, launcher and position in Kyros. The widget is available in nine languages: German, English, Ukrainian, Arabic, Turkish, Russian, Polish, French and Farsi, plus Easy language (Leichte Sprache). Every widget permanently notes that answers are AI-generated and may be inaccurate. Under “Privacy,” visitors open the “Using our chatbot” panel.
Answer quality depends mostly on your pages: clear shipping and returns pages with specific deadlines help more than long texts with conflicting details. Chatlogs show you the conversations and visitor ratings; with Revise, you save a better answer as a Golden answer.
Example: a return request as an Interactive Card (Beta)
How to add Kyros to Shopify
Two ways to put the floating bubble on every page, and one for the inline frame. Menu names are given as they appear in Shopify’s English help; if your Shopify admin is in another language, the labels may differ.
Step 1: Copy the code in Kyros
In Kyros, open your assistant, then Deploy and Install the widget. Choose Floating bubble and the HTML guide; Kyros has no Shopify-specific guide. Under Website access, you set which domains the chat can open on; add your store’s domain there. On other domains the chat button still shows, but the chat window won’t load. Under Code expiry, you can set the code to expire. The copied code looks like this:
<script src="https://kyros.omniratio.de/api/widget?id=…&sig=…&type=chatbot"></script>In your copy, id= and sig= are followed by your widget’s ID and its signature.
Step 2, option A: theme.liquid in the code editor
- In your Shopify admin, go to Online Store.
- Click ⋯ → Edit code.
- Open your theme’s layout file, usually
layout/theme.liquid(Shopify’s help page doesn’t name the file). - Paste the Kyros code directly before the closing
</body>tag and save the file. - Open your store and reload the page; the chat bubble should appear.
In the Shopify mobile app, the path runs through the menu: Sales channels → Online Store → Manage themes → ⋯ → Edit code.
Shopify recommends duplicating the theme before you edit it, so you have a backup. Important: if your code changes are incompatible with a theme update, Shopify removes all of them in the updated copy. Check after every theme update that the Kyros code is still there. Paid themes you’re still trying out can only be edited after you’ve bought them.
Step 2, option B: a Custom Liquid section in the footer
This route doesn’t need the code editor.
- Go to Online Store and click Edit theme.
- In the Footer area, click Add section and choose Custom Liquid.
- Paste the Kyros code into the section and click Save.
According to Shopify, your header and footer are shared across all pages of your online store, so code in the footer loads everywhere. Themes in the Shopify Theme Store must offer a Custom Liquid section; other themes may not. Shopify’s help doesn’t say explicitly whether the section survives a theme update.
Alternative: an inline frame on a specific page
To place the chat in a fixed spot on one page, such as your FAQ or contact page, choose Inline frame in Kyros and copy the <iframe> code. Then, in the theme editor (Edit theme → Add section → Custom Liquid), add a Custom Liquid section to that page’s template and paste the code there.
A note on Shopify’s Starter plan
According to Shopify, its Starter plan comes with the Spotlight theme only; other themes and customization options aren’t available on it. So on that plan, don’t count on either the code editor or a Custom Liquid section, and there’s no Kyros app to fall back on. This refers to Shopify’s plan, not the Kyros Starter plan.
If the widget doesn’t appear
Check these points one by one.
Code in the wrong place
In the code editor, the code belongs in layout/theme.liquid, directly before the closing </body> tag, and the file has to be saved. If the Custom Liquid route didn’t work, try theme.liquid instead.
Wrong theme edited
If you pasted the code into a duplicate, it only shows once that theme is the one your store is using. Otherwise, edit the theme your store currently uses.
Removed by a theme update
If your code changes are incompatible with a theme update, Shopify removes them in the updated copy. Paste the Kyros code in again.
Chat window won’t load: domain not allowed
If Website access lists domains, the chat only opens there. Check that your domain, including staging, is listed.
Held back by a cookie banner
A third-party cookie banner that blocks scripts until consent will also hold back the Kyros code until then. According to Shopify, its own cookie banner governs Shopify’s own tools, such as Shopify Pixels.
Shopify Inbox, Sidekick or Kyros?
Shopify comes with its own AI tools, and for some stores they are enough.
Shopify Inbox is Shopify’s chat for the online store. Your team can reply to customers there, or you can turn on an Inbox agent that responds automatically. According to Shopify, it handles questions about products, shipping, returns, sizing and store policies, and replies in the language the customer writes in. Inbox requires the Basic, Grow, Advanced or Shopify Plus plan, an active online store and new customer accounts. Sidekick, by contrast, is an AI assistant in the Shopify admin that helps you as the merchant; your customers never see it.
When Shopify Inbox is enough
- Your team wants to chat with customers live. Kyros can’t do that: it has no live chat and no handoff to staff.
- You want chat and the AI agent to come from Shopify itself.
- Your store is on Basic or higher anyway, and the Inbox agent’s topics (products, shipping, returns, sizing, policies) cover what you need.
When Kyros fits
- Kyros answers from your own pages and lists numbered source links below its answers.
- You want to set Golden answers for sensitive questions and revise answers straight from Chatlogs.
- The widget should offer a choice of languages: nine of them, plus Easy language.
- The same assistant should also run on your company website, a blog or through the REST API, not just in your store.
Shopify sources
As of October 1, 2026. Statements about Shopify come from Shopify’s English help center and developer documentation; features and plans may change.
- Shopify Help: Edit theme code
- Shopify Help: Customizing sections (header and footer)
- Shopify Help: Apps in your theme and Custom Liquid
- Shopify Help: Sections and blocks
- Shopify Dev: Theme Store requirements
- Shopify Help: Starter plan
- Shopify Help: Privacy settings and cookie banner
- Shopify Help: Shopify Inbox
- Shopify Help: Inbox agent and requirements
- Shopify Help: Sidekick
Shopify chatbot FAQ
Is there a Kyros app in the Shopify App Store?
No. Kyros has no Shopify app, so there is also no app embed of the kind chat apps use in the theme editor. You add Kyros with a snippet, either in the theme.liquid file directly before the closing </body> tag or in a Custom Liquid section in your theme’s footer. This doesn’t connect Kyros to orders, products or customer data in Shopify; the chatbot answers from the pages you list in Kyros.
Can the Shopify chatbot look up orders?
Not by itself. Kyros has no access to orders in Shopify and answers from the pages you list, such as your shipping and returns pages. For order lookups, you need your own API: an Interactive Card (Beta) can ask for the order number and email address in the chat and call your API. You provide that API yourself. Without one, the Card can only store the request so your team can follow up.
Does the chatbot work on product pages?
Yes. If you paste the code into theme.liquid, it loads on every page of your online store, product pages included. A Custom Liquid section in the footer also loads everywhere, because Shopify shares the header and footer across all pages. The chatbot only answers about a product if the details are on pages you listed in Kyros, for example the product page itself or your size guide.
Is there a Shopify chatbot in German?
Yes. Kyros is built by omniratio in Germany, its dashboard is available in German and English, and the chat widget speaks German and eight more languages: English, Ukrainian, Arabic, Turkish, Russian, Polish, French and Farsi, plus Easy language (Leichte Sprache). With two or more languages enabled, visitors pick one in the widget. The assistant is instructed to answer in the selected language or in the language the visitor writes in.
What about data protection with a Shopify chatbot?
Kyros is hosted in Germany, with its API and database in Frankfurt. The provider of the AI model you choose also processes each message, not always in Germany. A DPA (Art. 28 GDPR) is available, the privacy policy states that customer data isn’t used to train AI models, and you set retention per assistant. According to Shopify, its cookie banner covers Shopify’s own tools; for scripts you add yourself, Shopify points to third-party banners or custom logic. Clarify consent questions with your data protection advisor.
How much does a Shopify chatbot with Kyros cost?
The Kyros Starter plan is €0, permanently, with no credit card required. It includes one assistant with a chat widget and monthly credits; every message uses credits, and each model shows its credits per message before you choose it. Pricing for Pro and Business is available on request. On the Shopify side, you need a plan that allows theme customization; according to Shopify, its Starter plan doesn’t.
Further reading
Embed the widget
Floating bubble or inline frame, website access and code expiry
Knowledge base
Add your store pages and re-sync them automatically
Interactive Cards (Beta)
Forms in the chat, stored submissions and API calls
AI assistant for e-commerce
Shipping, returns and product questions in your online store
Add Kyros to your Shopify store.
The Starter plan is €0, permanently, with no credit card required. It includes one assistant with a chat widget.