Fix 21 of 60 · Support

How do I control what AI shopping agents say about my store?

When a shopper asks an AI agent about your returns or delivery, the answer can come from facts Shopify collected about your store. Shopify's knowledge base lets you check those facts, fix them and publish them. Here is what to review before Black Friday.

Published Updated By Kishore, Axioprax5 min read
A knowledge base list where a scanned return window waits for review, shipping details are published from the admin, and a holiday cutoff fact still needs to be added.

What is Shopify's knowledge base, and why should I care?

Shoppers can ask an AI agent questions like "Can I return this after Christmas?" or "Do they ship to Ireland?" before they ever open your site. Shopify keeps a knowledge base of facts about your store for exactly these questions, and says: "These facts are the source of truth for AI agents for all non-product information about your store."

Shopify builds most of it for you. It scans your public storefront and pulls in admin data such as your policies and delivery settings. The catch is the scan. Facts Shopify generates from your storefront "are unpublished until you publish them", and a scan can pick up an old FAQ page or a banner from last year. If nobody reviews them, agents may be working from gaps or stale details during your busiest weeks.

This used to be a separate app called Shopify Knowledge Base. It now lives in the admin under Sales channels > Agentic.

How do I know my store facts need attention?

  • You have never opened the Knowledge base page, so scanned facts may still be unpublished.
  • You changed your return window or shipping countries this year.
  • Customers ask about holiday delivery dates and nothing on your store states them in one place.
  • You used the old Knowledge Base app and have not checked what moved across.

If any of these sound like your store, set aside time for a full review before Black Friday.

How do I fix it? (step by step)

Work through it with your Shopify admin open, and tick each step as you go.

0 of 6 done

  1. Open your knowledge base.

    From your Shopify admin, go to Sales channels > Agentic and, in the Sources section, click Knowledge Base. You need to be the store owner, or a staff member with the App and sales channel > Agentic permission or the App development > View apps developed by staff and collaborators permission.

  2. Work through the suggested updates.

    For each suggested update from a store scan, click Approve & publish if it is right. If it is wrong, click the thumbs-down icon, choose a reason, click Submit, then click Save.

  3. Correct your return window.

    Open the Returns & warranty category and read the return window and refund details. If the source icon points to your admin, such as Policies, fix it there; otherwise change the source to Manual, edit the field and click Save.

  4. Check where you ship.

    Open the Fulfillment category, which covers the types of shipping and delivery your store offers. Make sure the countries you ship to, and any you do not, are stated clearly.

  5. Add your holiday cutoff dates.

    In the Additional facts section, click Add fact, give it a clear title such as Holiday order cutoff dates and choose Paragraph. Enter your last order dates per shipping method, hover over Unpublished, click Publish, then click Save.

  6. Publish what you have checked.

    Scanned facts stay unpublished until you publish them. Click Publish all on each category you have checked, or use Status > Published facts for everything, then click Save.

Flow from left to right: Shopify scans your storefront and admin, you approve or correct the facts in Sales channels, Agentic, Knowledge Base, you add holiday cutoffs as an additional fact, then publish so AI channels such as Shop can use them.
Scanned facts wait for you. Facts linked to your admin, like policies and contact details, are published as soon as Shopify creates them.

How much control do I really have?

You control the facts, not the final sentence. Shopify says knowledge base content "is never changed without your approval", and you choose what is published. But the agent still writes its own answer, so you cannot script its exact words. Keep facts short and plain: one return window, one list of countries, one set of dates. That leaves the least room for a muddled answer.

After the holidays, unpublish the cutoff fact or update it, so agents are not quoting December dates in February.

When is this not the right fix?

If your store is password-protected, Shopify says the knowledge base cannot access your online store, so it only shows admin data. Custom storefronts and stores on the Agentic plan can add only additional facts. And if the problem is a product's size, price or description, the knowledge base will not help, because it covers non-product information. Fix the product listing instead. There is also a ceiling: the knowledge base holds a total of 1,000 facts, counting both the facts Shopify generates and the additional facts you add.

What does it cost?

Shopify's knowledge base help page does not list a charge, and the Knowledge Base app it replaces was listed as free in the Shopify App Store. The real cost is time: a first review takes the longest, then a quick check whenever your policies or delivery change.

Do it yourself, or have it done?

Done for you

We set it up in your store through a collaborator account, and tell you what it takes before you pay anything.

Frequently asked questions

Which AI agents use my knowledge base?

Shopify says the published knowledge base is publicly available through the Storefront MCP and can be used by AI channels including Shop and third-party platforms. The help page does not list every agent by name.

I used the Knowledge Base app. Do I lose my FAQs?

If the app had 1,000 or fewer facts, Shopify transfers your overrides and added facts automatically and publishes them in the new knowledge base. If it had more, you need to add the extra ones by hand before the app is deprecated on January 15, 2027.

I updated my shipping page. Why has the fact not changed?

Shopify scans your store regularly and offers new information as a suggested update. To pick up a change sooner, request a rescan from the Knowledge base page, which Shopify says can take up to 48 hours, or edit the fact directly.

Does this change what agents say about my products?

No. The knowledge base covers non-product information like policies, contact details and delivery. Product details come from your catalog, so fix those on the product itself.

Get the week's fixes by email

One email a week with the new fixes and their checklists. No sales emails. Unsubscribe any time.

Got a store problem we haven't fixed yet? Send it to us and it may become a future fix.

All fixes