← Help Centre

Install Miravo AI on Shopify

Use Shopify App Home to connect your store and publish the chat button through your theme’s app embeds. You need permission to install apps and edit your store’s theme.

1. Install and open the app

Install Miravo AI Chatbot using your Shopify installation link. Review the permissions Shopify displays and approve the installation. In Shopify admin, open Apps → Miravo AI Chatbot. The app connects a Miravo workspace to your store.

2. Review your plan

In App Home, choose Manage plan to review Shopify billing. Choose a plan and review its price and any trial shown before approving it. Development-store test plans are for testing. After your trial ends, an active plan is required to keep the widget available.

3. Sync your store knowledge

Choose Sync store data. Miravo indexes your products, pages, and store policies for answers. Wait until processing is ready before testing. Sync again after important catalog or policy changes, and check for failed processing before relying on an answer.

4. Enable the theme app embed

Choose Activate in theme to open Shopify’s theme editor. In App embeds, enable AI chat widget, then choose Save. Confirm you are editing the theme published on your store. You can also open Online Store → Themes → Customize → App embeds from Shopify admin. Repeat activation if you publish a different theme.

5. Test your storefront

Open your store in a new browser tab, refresh it, and select the floating chat button. Ask about a product and compare the answer with its current price and details. Test a store policy and a question whose answer is missing. Check the widget on a phone as well as a desktop. The assistant should not invent information it cannot confirm.

6. Customize your assistant

Return to App Home and choose Open chatbot dashboard. Review the assistant’s instructions, branding, welcome message, knowledge, and human contact options. Save your changes, then refresh your storefront and test again. See the customization and answer-quality guides below for more detail.

7. Disable or remove the widget

To hide the chat button, return to the theme editor’s App embeds, turn off AI chat widget, and Save. To remove the integration, uninstall Miravo AI Chatbot from Shopify admin’s app settings. Review your subscription status in Shopify when changing or removing your plan.

If the chat button does not appear

Confirm that AI chat widget is enabled and saved on the published theme, and that your trial or plan is active. Refresh the storefront after saving. Check your widget’s allowed domains if you use a custom storefront domain. Avoid adding a second manual script installation alongside the app embed.

If the button opens but answers are missing, check store-data processing and sync again. For order questions, the shopper must be signed in to the correct Shopify customer account. The assistant can only access that customer’s available orders; older orders may be outside Shopify’s standard order-access window. It cannot change orders or issue refunds.

If setup still fails, email [email protected] with your store domain, the step that failed, and a screenshot with private customer information removed.