> ## Documentation Index
> Fetch the complete documentation index at: https://docs.heylua.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Shopify

> Add AI shopping assistant to your Shopify store

## Overview

### About Shopify

**Shopify** is the world's leading e-commerce platform, powering over 4 million online stores globally. From small businesses to enterprise brands, Shopify provides everything you need to sell products online - inventory management, payment processing, shipping, and a beautiful storefront.

### Transform Your Shopify Store with AI

The **Lua AI Shopping Assistant** turns your Shopify store into an AI-powered sales machine. Instead of customers browsing alone, they get a personal shopping assistant available 24/7 across WhatsApp, Instagram, Facebook Messenger, and your website.

**The Impact:**

* 🚀 **Boost Conversions** - AI guides customers from browsing to checkout
* 💬 **Multi-Channel Sales** - Sell on social media with the same AI assistant
* ⏰ **24/7 Availability** - Never miss a sale, even at 3 AM
* 🎯 **Personalized Shopping** - AI recommends products based on preferences
* 📱 **Meet Customers Anywhere** - Website, WhatsApp, Instagram, Facebook
* ⚡ **Instant Responses** - No waiting for human agents
* 💰 **Higher Cart Values** - AI upsells and cross-sells intelligently

<CardGroup cols={2}>
  <Card title="Shopify App Store" icon="shopify">
    Official verified Shopify app
  </Card>

  <Card title="10-Minute Setup" icon="clock">
    Install and configure in minutes
  </Card>

  <Card title="Multi-Channel Sales" icon="broadcast-tower">
    WhatsApp, Instagram, Facebook, Website
  </Card>

  <Card title="AI-Powered" icon="robot">
    Smart product search and recommendations
  </Card>
</CardGroup>

## App Store Link

<Card title="Lua AI Shopping Assistant on Shopify" icon="shopify" href="https://apps.shopify.com/lua-shopping-assistant" horizontal>
  Visit the Shopify App Store to install
</Card>

## Features

According to the [Shopify App Store](https://apps.shopify.com/lua-shopping-assistant):

* 🔍 **AI-powered product search** - Help customers find exactly what they need
* 💡 **Personalized recommendations** - Smart product suggestions
* 🛒 **Cart creation in chat** - Build carts directly in conversations
* 💳 **Checkout links** - One-click checkout from chat
* 📱 **Multi-channel** - Messenger, Instagram, WhatsApp, Website
* 🌍 **Multi-language** - Supports 100+ languages
* 📊 **Analytics** - Track conversions and engagement
* ⚡ **Fast setup** - Less than 10 minutes to launch

**Rating**: ⭐⭐⭐⭐⭐ 5.0

***

## Installation from Shopify App Store

<Steps>
  <Step title="Visit Shopify App Store">
    Go to the [Lua AI Shopping Assistant](https://apps.shopify.com/lua-shopping-assistant) page

    Or search for "Lua AI Shopping Assistant" in Shopify App Store
  </Step>

  <Step title="Click Install">
    Click the "Install" button on the app page

    <Frame>
      <img src="https://mintcdn.com/luaglobal/9voTmYGj2sNBYqpY/images/integrations/shopify-install-button.png?fit=max&auto=format&n=9voTmYGj2sNBYqpY&q=85&s=a0ca14734a96ba2dd6c6a8e0667dd326" alt="Shopify install button" width="1582" height="581" data-path="images/integrations/shopify-install-button.png" />
    </Frame>

    *Screenshot: Shopify App Store page with "Install" button highlighted*
  </Step>

  <Step title="Accept Access Request">
    Shopify will ask for permissions. Review and click "Install"

    <Frame>
      <img src="https://mintcdn.com/luaglobal/9voTmYGj2sNBYqpY/images/integrations/shopify-accept-permissions.png?fit=max&auto=format&n=9voTmYGj2sNBYqpY&q=85&s=a638e6e8c652d40dca044d591716aad2" alt="Accept permissions" width="645" height="451" data-path="images/integrations/shopify-accept-permissions.png" />
    </Frame>

    *Screenshot: Permission request dialog showing:*

    * Read/write products
    * Read/write orders
    * Read customer data
    * "Install" button
  </Step>

  <Step title="Installation Complete">
    App installs and admin dashboard loads

    <Frame>
      <img src="https://mintcdn.com/luaglobal/9voTmYGj2sNBYqpY/images/integrations/shopify-admin-loaded.png?fit=max&auto=format&n=9voTmYGj2sNBYqpY&q=85&s=f6363d0c327e0ed76b604e441789502b" alt="Admin dashboard loaded" width="1856" height="705" data-path="images/integrations/shopify-admin-loaded.png" />
    </Frame>

    *Screenshot: Lua admin dashboard loaded within Shopify admin*
  </Step>
</Steps>

***

## Activate Chat Widget on Website

After installation, enable the chat widget on your storefront:

<Steps>
  <Step title="Navigate to Online Store">
    In Shopify admin: **Sales Channels** → **Online Store**

    <Frame>
      <img src="https://mintcdn.com/luaglobal/9voTmYGj2sNBYqpY/images/integrations/shopify-online-store-menu.png?fit=max&auto=format&n=9voTmYGj2sNBYqpY&q=85&s=00eef41e5163e9e994dd36b5007f8a11" alt="Online Store menu" width="279" height="178" data-path="images/integrations/shopify-online-store-menu.png" />
    </Frame>

    *Screenshot: Shopify sidebar showing Sales Channels → Online Store*
  </Step>

  <Step title="Go to Themes">
    Click **Themes** → **Customize**

    <Frame>
      <img src="https://mintcdn.com/luaglobal/9voTmYGj2sNBYqpY/images/integrations/shopify-themes-customize.png?fit=max&auto=format&n=9voTmYGj2sNBYqpY&q=85&s=109625f83b31ce6f686db36494826bd7" alt="Themes customize button" width="1043" height="557" data-path="images/integrations/shopify-themes-customize.png" />
    </Frame>

    *Screenshot: Themes page with "Customize" button*
  </Step>

  <Step title="Open App Embeds">
    In the theme customizer, click **App embeds** in the left sidebar

    <Frame>
      <img src="https://mintcdn.com/luaglobal/9voTmYGj2sNBYqpY/images/integrations/shopify-app-embeds-menu.png?fit=max&auto=format&n=9voTmYGj2sNBYqpY&q=85&s=d0b397f82b17082c624062a0a716f6a5" alt="App embeds menu" width="362" height="226" data-path="images/integrations/shopify-app-embeds-menu.png" />
    </Frame>

    *Screenshot: Theme customizer showing "App embeds" in left navigation*
  </Step>

  <Step title="Find LuaPop Chat">
    Locate "LuaPop Chat" in the app embeds list

    <Frame>
      <img src="https://mintcdn.com/luaglobal/9voTmYGj2sNBYqpY/images/integrations/shopify-luapop-app-embed.png?fit=max&auto=format&n=9voTmYGj2sNBYqpY&q=85&s=d0c48ebe8cd18d6bab4069714e57d2f9" alt="LuaPop in app embeds" width="359" height="271" data-path="images/integrations/shopify-luapop-app-embed.png" />
    </Frame>

    *Screenshot: App embeds list showing "LuaPop Chat" with toggle*
  </Step>

  <Step title="Toggle Active & Customize">
    1. Toggle the switch to **Active**
    2. Customize appearance:
       * Position (Bottom Right, Bottom Left, etc.)
       * Theme (Light or Dark)
       * Button text
       * Colors and styling

    <Frame>
      <img src="https://mintcdn.com/luaglobal/9voTmYGj2sNBYqpY/images/integrations/shopify-luapop-customize.png?fit=max&auto=format&n=9voTmYGj2sNBYqpY&q=85&s=4b7a2dde031c6a5c458727129d0b4e31" alt="Customize LuaPop" width="655" height="1126" data-path="images/integrations/shopify-luapop-customize.png" />
    </Frame>

    *Screenshot: LuaPop settings panel showing:*

    * Active toggle (ON)
    * Position dropdown
    * Theme selector
    * Button text field
    * Color pickers
    * Styling options
  </Step>

  <Step title="Save Changes">
    Click **Save** in the top right corner

    <Frame>
      <img src="https://mintcdn.com/luaglobal/9voTmYGj2sNBYqpY/images/integrations/shopify-save-button.png?fit=max&auto=format&n=9voTmYGj2sNBYqpY&q=85&s=d6ab57f141886140ae195ddd05393624" alt="Save button" width="342" height="60" data-path="images/integrations/shopify-save-button.png" />
    </Frame>

    *Screenshot: Theme customizer with "Save" button highlighted in top right*
  </Step>
</Steps>

***

## Styling & Customization

For complete styling options and customization:

<Card title="Chat Widget Styling Guide" icon="palette" href="/chat-widget/styling" horizontal>
  Complete guide to colors, positioning, themes, and custom styles →
</Card>

All LuaPop customization options are available in the Shopify app embed settings!

***

## What Your Agent Can Do

With Shopify integration, your agent can:

* 🔍 **Product Search** - Find items in your catalog
* 📦 **Product Details** - Specs, pricing, availability, reviews
* 🛒 **Cart Creation** - Build carts in chat conversations
* 💳 **Checkout Links** - Generate one-click checkout URLs
* 📍 **Order Tracking** - Check order status and shipping
* 💡 **Smart Recommendations** - Personalized product suggestions
* ❓ **Answer Questions** - Product info, shipping, returns, policies
* 🌐 **Multi-Channel** - Same assistant on web, WhatsApp, Instagram, Facebook

***

## Multi-Channel Setup

The Shopify app supports multiple channels beyond website chat:

<CardGroup cols={2}>
  <Card title="WhatsApp" icon="whatsapp">
    Connect WhatsApp Business
  </Card>

  <Card title="Instagram" icon="instagram">
    Link Instagram Business account
  </Card>

  <Card title="Facebook" icon="facebook">
    Connect Facebook Page
  </Card>

  <Card title="Website" icon="globe">
    Chat widget (auto-enabled)
  </Card>
</CardGroup>

<Card title="Setup Additional Channels" icon="link" href="/channels/introduction">
  See Channels documentation to connect WhatsApp, Instagram, and Facebook →
</Card>

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="Widget not appearing on store">
    **Check:**

    1. App embed is toggled to **Active**
    2. Theme customizer changes were **Saved**
    3. Clear browser cache and refresh
    4. Check theme compatibility
    5. View published theme (not preview)
  </Accordion>

  <Accordion title="Chat not responding">
    **Check:**

    1. Agent is deployed (`lua production`)
    2. Skills are pushed (`lua push`)
    3. Check browser console for errors
    4. Verify agent ID is correct
    5. Test in admin dashboard
  </Accordion>

  <Accordion title="Can't find app embeds">
    **Location:**

    * Theme Customizer → Left sidebar → App embeds

    **If missing:**

    * Ensure app is installed
    * Try different theme
    * Contact Shopify support
  </Accordion>

  <Accordion title="Products not showing in chat">
    **Check:**

    1. Products are published in Shopify
    2. Products have inventory
    3. Agent has product search tools
    4. Test with simple product names
  </Accordion>
</AccordionGroup>

***

## Best Practices

<AccordionGroup>
  <Accordion title="Position for Best Engagement">
    **Bottom Right** (default)

    * Standard placement
    * Familiar to users
    * Doesn't interfere with product images

    Mobile-optimized automatically
  </Accordion>

  <Accordion title="Match Your Brand">
    Customize colors to match your store:

    * Use your brand colors
    * Match header/footer styling
    * Ensure good contrast
    * Test on mobile and desktop
  </Accordion>

  <Accordion title="Test Before Going Live">
    ```bash theme={null}
    # Test your agent first
    lua chat

    # Test product searches
    # Test cart creation
    # Test checkout links

    # Then enable on store
    ```
  </Accordion>

  <Accordion title="Monitor Performance">
    * Check analytics in Shopify admin
    * View conversations in `lua admin`
    * Track conversions from chat
    * Optimize based on usage
  </Accordion>
</AccordionGroup>

***

## App Updates

The Shopify app updates automatically:

* ✅ Latest features added automatically
* ✅ Security patches applied
* ✅ No manual update needed
* ✅ Changes announced in app dashboard

***

## Support & Resources

<CardGroup cols={2}>
  <Card title="Shopify App Store" icon="shopify" href="https://apps.shopify.com/lua-shopping-assistant">
    View app listing and reviews
  </Card>

  <Card title="Configure Agent" icon="robot" href="/cli/persona-command">
    Set up shopping assistant personality
  </Card>

  <Card title="Widget Styling" icon="palette" href="/chat-widget/styling">
    Customize chat appearance
  </Card>

  <Card title="Get Support" icon="life-ring" href="mailto:support@heylua.ai">
    Email: [support@heylua.ai](mailto:support@heylua.ai)
  </Card>
</CardGroup>

***

## What Customers Are Saying

From the [Shopify App Store](https://apps.shopify.com/lua-shopping-assistant) reviews:

> "Great product- helped us automate customer queries & turn chats into sales."\
> — Ma boutique, France

> "I installed Lua to help me sell on Instagram & WhatsApp- loving it so far!"\
> — Rocco & Rose, United Kingdom

**Rating**: ⭐⭐⭐⭐⭐ 5.0 out of 5

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Install Shopify App" icon="shopify" href="https://apps.shopify.com/lua-shopping-assistant">
    Get started on Shopify App Store
  </Card>

  <Card title="Configure Channels" icon="broadcast-tower" href="/channels/introduction">
    Add WhatsApp, Instagram, Facebook
  </Card>

  <Card title="E-commerce Demo" icon="cart-shopping" href="/demos/ecommerce-assistant">
    See complete shopping assistant
  </Card>

  <Card title="Test Your Agent" icon="comments" href="/cli/chat-command">
    Test shopping conversations
  </Card>
</CardGroup>