Skip to main content
Connect your Shopify store to IllumiChat and transform your AI assistant into an e-commerce agent that helps customers browse products, track orders, manage carts, and update their account — all through natural conversation.
You do not need to add any embed code manually. The chat widget installs automatically on your storefront when you connect your store and select a theme.

​
What Your Customers Can Do

Once connected, your assistant can handle real shopping conversations:

Browse Products

“Do you have any running shoes under $100?”Your assistant searches your Shopify catalog and returns real products with names, prices, images, and links.

Track Orders

“Where’s my order #1042?”Customers can check order status by order number or the email address they used at checkout.

Manage Carts

“Add the blue hoodie in size M to my cart”Your assistant can create a cart, add or remove items, and share a checkout link.

Update Account Info

“Can you update my shipping address?”Look up customer records and update contact details, addresses, and notes.

​
Getting Started

​
Prerequisites

  • An IllumiChat workspace with Admin access
  • A Shopify store (development stores work for testing)
  • Your store’s .myshopify.com domain

​
Step 1: Connect Your Store

  1. Go to your assistant’s Settings > Channels
  2. Click the Shopify card
  3. Enter your store domain (e.g., my-store or my-store.myshopify.com)
  4. Click Connect
  5. You’ll be redirected to Shopify — review the permissions and click Install app
  6. Shopify redirects you back to IllumiChat with your store connected
You can enter just your store name (e.g., my-store) without the .myshopify.com part — IllumiChat adds it automatically.

​
Step 2: Enable AI Actions

After connecting, you’ll see toggle switches for each AI capability. Enable the ones you want your assistant to use:
ActionDefaultWhat It Does
Product SearchOnSearch your catalog by keyword, return product details with prices and links
Order TrackingOnLook up order status by order number or customer email
Cart ManagementOffCreate shopping carts, add/remove items, share checkout links
Customer UpdatesOffLook up and update customer information (address, email, notes)
Click Save Changes when you’re done.
Start with Product Search and Order Tracking — these cover the most common customer questions. Add Cart Management and Customer Updates when you need them.

​
Step 3: Install the Widget on Your Store

  1. Scroll down to the Widget Embedding section
  2. You’ll see a list of your store’s themes
  3. Click Install Widget next to the theme you want
  4. The chat widget automatically appears on every page of that theme
That’s it — your customers can now chat with your AI assistant directly on your storefront.
If you switch your live theme in Shopify, you’ll need to install the widget on the new theme. The widget is tied to a specific theme, not your entire store.

​
Step 4: Test the Connection

Click Test Connection on the Shopify settings page to verify everything is working. Then visit your storefront and try asking the widget about your products.

​
Shopify Actions

Shopify Actions are the AI-powered capabilities your assistant uses to interact with your store data in real time. Each action can be toggled on or off independently. When enabled, your assistant can search your entire Shopify product catalog and return real results including:
  • Product name and description
  • Price and variants (sizes, colors)
  • Product images
  • Direct links to the product page
Example conversations:
  • “What laptops do you have?”
  • “Show me dresses under $50”
  • “Do you have the Nike Air Max in size 10?”

​
Order Tracking

Your assistant can look up any order using either the order number or the customer’s email address. It returns:
  • Current order status (fulfilled, unfulfilled, partially fulfilled)
  • Tracking information
  • Line items and quantities
  • Order total
Example conversations:
  • “Where’s my order #1042?”
  • “Can you check the status of my recent order? My email is jane@example.com”

​
Cart Management

Your assistant can create shopping carts and manage items during the conversation:
  • Create a new cart
  • Add products by name or variant
  • Remove items
  • Show cart summary with totals
Example conversations:
  • “Add the blue hoodie in medium to my cart”
  • “What’s in my cart?”
  • “Remove the socks from my cart”

​
Customer Updates

Your assistant can look up and modify customer records:
  • Find customers by email
  • Update shipping/billing addresses
  • Update contact information
  • Add notes to customer profiles
Example conversations:
  • “Update my address to 123 Main St, New York, NY 10001”
  • “What email do you have on file for me?”
Customer Updates requires the read_customers scope. This is included by default when you connect your store.

​
Analytics

Track how customers are using your Shopify integration from the analytics dashboard on your assistant’s Channels > Shopify page. Metrics tracked:
  • Product Searches — How often the assistant searches your catalog
  • Order Lookups — Number of order status inquiries
  • Cart Actions — Cart creates, item additions, and removals
  • Customer Updates — Customer data lookups and modifications
  • Webhooks Received — Store events received from Shopify
Filter by 7 days, 30 days, or 90 days to spot trends.

​
Managing Your Integration

​
Enable / Disable

Toggle the integration on or off from the Shopify settings page without losing your configuration. When disabled, AI actions and the widget stop working, but your store stays connected.

​
Disconnect Store

Click Disconnect Store to completely remove the integration. This removes the widget from your storefront and deletes the stored access token. You can reconnect at any time by going through the OAuth flow again.

​
Connection Status

The Channels overview page shows your Shopify connection status at a glance:
  • Connected (green) — Store is connected and active
  • Not Connected — No store linked yet

​
Best Practices

Add Shopify-specific instructions to your assistant’s system prompt. For example:“When helping with product questions, always include the price and a link to the product page. If a product is out of stock, suggest similar alternatives. Keep responses concise and helpful.”
Shopify offers free development stores for testing. Connect one first to verify your assistant handles product searches and order lookups correctly before going live.
Fewer tools means faster, more focused responses. Most stores only need Product Search and Order Tracking. Add Cart Management and Customer Updates when you have specific use cases for them.
High product search volume suggests customers need better product discovery on your site. High order lookups may indicate gaps in your shipping notifications. Use the data to improve both your assistant and your store.

​
Troubleshooting

  • Verify your store domain is correct (must be a valid .myshopify.com domain)
  • Ensure you have owner or admin access on the Shopify store
  • Make sure your IllumiChat instance is accessible via HTTPS
  • Confirm the widget is installed on your active (live) theme — not an unpublished draft
  • Check the Widget Embedding section for installation status
  • Clear your browser cache or try an incognito window
  • Make sure the integration is enabled (not just connected)
  • Verify the store is connected (green status on the Channels page)
  • Ensure the specific action toggle is on (e.g., Product Search)
  • Click Test Connection to verify the access token is still valid
  • If the test fails, disconnect and reconnect the store
  • The store owner may have uninstalled the app from Shopify’s admin
  • The access token may have been revoked
  • Reconnect from the Shopify channel page — it only takes a few clicks

​
Next Steps

Widget Customization

Customize the look and feel of the chat widget on your storefront.

Effective Prompts

Write better system prompts to get the most out of your Shopify assistant.