๐Ÿ’ฌ
Commerce Ace ยท App Guide

Shopping & Support Agent

A storefront concierge that answers product questions, recovers carts, and closes the sale โ€” powered by Claude AI, right inside your storefront chat widget.

Step 0

Before you start

A few things need to be in place before the Shopping & Support Agent can run. Skim both lists โ€” the second one saves support tickets later.

Requirements
  • โœ“An active Shopify plan with the Shopping & Support Agent installed.
  • โœ“A published storefront theme โ€” the chat widget loads through Shopify's App Embeds system.
  • โœ“Your product catalog synced in Shopify with accurate titles, descriptions, and prices.
  • โœ“A Commerce Ace Growth or Pro plan for order status lookup and advanced features.
Out of scope
  • ร—The agent answers from your catalog โ€” it does not invent products, prices, or availability.
  • ร—It won't process refunds, cancel orders, or edit any order details โ€” it hands those off to your support team.
  • ร—It replies in storefront chat only โ€” not over email, SMS, or social media.
  • ร—Sensitive payment details stay in Shopify checkout โ€” the agent never sees card numbers.
Setup

Step-by-step setup

Four steps from install to live chat on your storefront. Screenshots coming soon.

01

Install on Shopify

From the Commerce Ace listing, click Install. The Shopping & Support Agent embeds inside your Shopify admin under Apps โ€” no separate login required.

Tip No theme code edits needed โ€” the widget loads through Shopify's app embed system.
Screenshot coming soon
02

Open the app in Shopify Admin

After install, open the app in Shopify Admin at least once. This step is important โ€” it activates the connection between the app and your store so the widget can start responding.

Tip If the widget ever stops responding on your storefront, opening the app in Admin once will wake it back up.
Screenshot coming soon
03

Configure Settings

In the app, go to Settings. Fill in your store description, welcome message, assistant name, and brand tone. This is what Claude reads to answer questions in a way that sounds like your brand.

Screenshot coming soon
04

Enable in Theme Editor โ†’ App Embeds

In Shopify Admin, go to Online Store โ†’ Themes โ†’ Customize. In the Theme Editor, click App Embeds in the left panel and toggle on the Commerce Ace Shopping Agent. Save the theme. The chat widget will now appear on your storefront.

Tip The widget only shows on the storefront after you enable it in App Embeds โ€” this is a required Shopify step.
Screenshot coming soon
Settings

Configuration guide

Every setting lives under Shopping Agent โ†’ Settings. These are the ones that most affect response quality.

SettingWhat it doesRecommended
Store description What Claude reads to understand your store, products, and services. Used in every response. 2โ€“4 sentences, accurate to your actual inventory
Assistant name The name shown in the chat widget header. Match your brand โ€” e.g. "Guided Shopping Agent"
Welcome message The first message customers see when they open the chat. Short and inviting โ€” ask what they're looking for
Tone The voice Claude uses โ€” friendly, professional, playful, etc. Matches your store's existing copy
Primary color The accent color used in the chat widget header and buttons. Your store's primary brand color
Order lookup Allows customers to ask about their order status by providing their email or order number. Pro plan only. On (Pro plan)
Max products Maximum number of product cards shown per recommendation response. 3โ€“5
Restrict to catalog When on, Claude only discusses your products and store. When off, it can answer general questions. On
Best practices

Merchant recommendations

What we tell every Commerce Ace merchant on their onboarding call.

โœฆ

Fill in your store description thoroughly

The store description is the single most impactful setting. Include your product categories, brand story, target customer, return policy, and any services you offer.

โœฆ

Keep product titles and descriptions accurate

Claude answers from your live Shopify catalog. If products have vague titles or empty descriptions, the agent's recommendations will be generic.

โœฆ

Test in an incognito window

The widget persists conversation history for 8 hours. Always test in incognito or clear localStorage to see what a first-time visitor experiences.

โœฆ

Enable order lookup on Pro

Order status questions are the most common support request. Pro plan includes live order lookup โ€” customers get answers instantly without emailing you.

โœฆ

Set a clear support message

In Settings, add a support message for when customers ask about things the agent can't handle โ€” like cancellations or address changes. Point them to your support email.

โœฆ

Growth plan unlocks header color customization

On Growth and Pro plans, you can fully customize the widget header color, button colors, and close button to match your storefront exactly.

FAQ

Frequently asked

Why isn't the widget showing on my storefront?

The most common cause is the App Embed not being toggled on. Go to Online Store โ†’ Themes โ†’ Customize โ†’ App Embeds and make sure the Commerce Ace Shopping Agent is enabled. Save the theme after toggling it on.

The widget opened but doesn't respond to messages โ€” what's wrong?

Open the app in Shopify Admin first. The app needs to load in admin at least once to activate the connection. After opening admin, go back to the storefront and try again.

Can the agent process refunds or cancel orders?

No โ€” those actions stay in Shopify. The agent can look up order status (Pro plan) and explain your return policy, but it directs customers to your support team for order changes.

How does the agent know what products to recommend?

It pulls your live Shopify catalog on every conversation. Products with detailed titles and descriptions get recommended more accurately than ones with sparse information.

How long does conversation history persist?

8 hours. After that, the session resets and the customer starts fresh. This prevents stale conversations from carrying over between shopping sessions.

Can I use this on multiple stores?

Yes โ€” install the app on each store separately. Each store has its own settings, catalog, and conversation history.