Frequently asked questions
Clear answers for installing, configuring, testing, and managing your AI shopping assistant.
Will a shopper lose the chat when opening a product?
No. View product opens in a new tab, and the assistant restores up to 40 recent messages for 30 days in the same browser. The shopper can use New chat to clear the saved conversation.
How do I install and set up GreatsHub AI Shop Assistant?
Install the app from the Shopify App Store, open it from Shopify Admin, complete Assistant settings, choose a plan, and enable the theme app embed. Then open your storefront and send a test message.
Why does a product search sometimes show no results?
Confirm that the product is active, published to Online Store, has complete title, price, image, variants, and available inventory. Then test with the exact product title.
How do I enable the assistant on my storefront?
Open the app setup guide and select Enable theme app embed. In the Shopify theme editor, turn on GreatsHub AI Shop Assistant under App embeds and save the theme. Also confirm Enable assistant is switched on in Assistant settings.
Why is the assistant not visible on my storefront?
Confirm the assistant and theme app embed are enabled, the correct theme was saved, and your current plan is active. Then refresh the storefront without cache. If it is still missing, send support your myshopify.com domain and the affected storefront URL.
Can I customize the chat window and launcher?
Yes. Depending on your plan, you can customize the assistant name, greeting, colors, launcher icon, header icon, send icon, position, spacing, background, support links, and other storefront design options.
How does the assistant recommend products?
The assistant searches the store catalog using the shopper request, such as product type, color, size, use case, or budget. It returns matching published products with current storefront information and available actions.
How does the assistant understand what a shopper is searching for?
The assistant identifies useful details in the shopper request, including product type, budget, color, size, material, style, and intended use. It sends those requirements to Shopify catalog search and displays only products returned by the store catalog.
Which Shopify product information affects assistant search results?
Results depend on the information available in the Shopify storefront catalog, including product titles, descriptions, product types, tags, prices, options, variants, colors, sizes, inventory availability, and publication to the Online Store sales channel.
Can the assistant invent products, prices, stock, or product links?
No. Product claims must be verified through the live Shopify catalog. If Shopify does not return a verified match, the assistant should ask the shopper to clarify the request, report that no verified match was found, or offer the configured human-support option.
How can I improve the accuracy of product recommendations?
Keep product titles and descriptions specific, add accurate product types, tags, colors, sizes and variants, maintain prices and inventory, and publish products to the Online Store channel. Test common customer phrases and use conversation analytics to identify missing catalog information.
Can shoppers add products to their cart from the chat?
Yes, when cart tools are included in the active plan. The assistant presents a product and variant, asks for confirmation where required, and performs the cart action through the storefront.
Does the assistant follow the language selected on my Shopify storefront?
Yes. The theme extension detects the active Shopify storefront locale and uses it as the assistant’s default language. If a shopper writes in another language or explicitly requests one, the assistant follows the shopper’s language. Product titles and descriptions use translations available through Shopify; the assistant does not invent missing product translations.
Does the assistant support Shopify Markets and multiple currencies?
Yes. The assistant receives the shopper’s active Shopify market country and currency, searches with that market context, and displays verified contextual prices returned by Shopify. A request such as “products under 500” uses the currently selected storefront currency. Shoppers should change the Shopify market selector before searching in another currency.
What do Products recommended, Add to cart, and Checkout clicks mean?
Products recommended counts product cards shown by the assistant. Add to cart counts tracked assistant cart actions, and Checkout clicks counts tracked checkout links opened from the assistant. These figures are assistant activity, not all Shopify store orders.
Why do assistant analytics not match my total Shopify orders?
Assistant analytics only include actions attributed to the chat experience. Orders or cart actions completed elsewhere in the storefront are not included, so the totals can be lower than Shopify Analytics.
Where can I see what customers searched for in the chat?
Open the app in Shopify Admin and select Analytics. The Conversations section shows shopper questions, assistant replies, recommended products, conversation date and language, and tracked add-to-cart or checkout activity. Data is separated by store.
What happens when my monthly AI limit is reached?
Paid AI generation is stopped to protect costs. When available, the assistant can continue in limited catalog mode using store data without an AI response. The merchant sees usage warnings and can upgrade or request a custom plan.
When do conversations, messages, and token limits reset?
Every plan allowance is counted by calendar month and renews automatically on the first day of the next month. No cron job or manual reset is required. Unused conversations, AI messages, and protected tokens do not roll over. Historical usage remains available for analytics. If a merchant upgrades during the month, the higher limits apply immediately while usage already consumed remains counted. After a downgrade, existing usage also remains counted; if it meets or exceeds the lower allowance, additional AI requests wait until the next monthly reset. Starting a new chat does not reset usage, and the app stops protected AI requests when an applicable limit is exhausted.
How will I know when my store is close to a usage limit?
The app displays warnings as usage approaches the configured thresholds, including near-limit and exhausted states. The app owner can also review merchant usage alerts from the administration panel.
How do plan free trials work?
Each paid plan may have its own introductory trial period. Shopify shows the applicable trial and billing terms before approval and determines eligibility. Switching, cancelling, or reinstalling does not guarantee a fresh trial. The trial shown in the app must match Shopify App Pricing.
How do I upgrade, downgrade, or cancel a plan?
Open Plans and billing inside the app and choose the required plan. Shopify displays the charge or plan change for approval. Billing access and cancellation are managed through Shopify Admin.
Can I request a private high-volume plan?
Yes. Contact support with your expected monthly conversations, messages, tokens, and required features. A private plan can be created for your store and will only appear for eligible shop domains.
How do I configure WhatsApp or human support?
Add your WhatsApp number, button label, and default message in Assistant settings. Save the settings and test the handoff from the storefront. Enter the number with its country code and without spaces or symbols.
How is merchant and shopper data protected?
The app scopes store data by shop, validates Shopify requests, limits paid AI usage, and avoids exposing private access tokens to the storefront. Merchants should review the app privacy policy for the full data handling and retention details.
What happens to my data when I uninstall the app?
The uninstall webhook marks the installation as removed and starts the app data cleanup process. Required Shopify privacy webhooks handle shop and customer deletion requests. A minimal uninstall audit may be retained for security and operational records.