Shopify Knowledge Base for AI Agents: What to Check Before They Quote Your Store

,

Shopify Knowledge base flow: drafted facts, checked against source pages, published only when correct

Shopify now drafts the facts AI agents use to answer questions about your store, mostly from your own pages. Returns, shipping, gift services, payment methods and contact details all sit in one admin page, and the facts linked to your admin, such as your policies and contact details, are already live without any approval from you.

The page is Knowledge base, under Sales channels > Agentic in your Shopify admin. Shopify announced it on October 26, 2026, and it replaces the standalone Knowledge Base app, which will no longer be available after January 15, 2027.

The most useful thing you can do is read the page the way a customer would and fix whichever store page is wrong. That is a review, not a project. This guide gives you the order to work in, which fields are live first, and what to do if you used the old app.

Key Takeaways

  • The Knowledge base page holds the non-product facts AI agents get about your store. Shopify drafts them from your published pages and admin settings, and each fact links to its source.
  • Facts from a scan of your storefront wait until you publish them. Facts linked to your admin, such as policies and contact details, are published when Shopify creates them.
  • Read Company policies and Contact first, because Shopify names them as already live. Then check every field that shows an admin source icon.
  • If you used the old Knowledge Base app, the cutoff is January 15, 2027. Stores with 1,000 or fewer facts were moved over. Larger stores need to re-add what they want to keep.
  • The sources we reviewed do not say the page shows what ChatGPT, Gemini or Copilot actually say. Test that yourself and repeat monthly.

What the Knowledge base page does and what is already live

The Knowledge base is a single page where you review, edit and publish the facts AI agents receive about your store. The changelog says: “Nothing Shopify drafted reaches AI agents until you publish it.” That holds for scanned facts. The Help Center adds one important distinction, and it is the idea this article rests on.

Facts generated from a scan of your storefront stay unpublished until you publish them. Facts linked to your admin, such as your store policies and your contact details, “are published when Shopify creates them.” So your policies and contact details can already be reaching agents today.

Agents query the published knowledge base through the Storefront MCP, and it is publicly available to channels including Shop and third-party platforms (Shopify Help Center). It is part of Shopify’s agentic storefronts, which are active by default for eligible stores across ChatGPT, Google AI Mode and Gemini, Microsoft Copilot and Meta.

The page has ten categories, and where a field comes from decides how you fix it:

CategoryWhere the facts come fromLive without approval?
Company policiesYour admin Policies settingsYes
ContactYour admin contact detailsYes
FulfillmentScan or admin settings, depending on the fieldCheck the field’s source icon
About the Store, Brand and Identity, Gift services, Payment, Returns & warranty, Second handScan, admin or manual, depending on the field. Check each icon.Scanned fields: No, unpublished until you publish. Any field with an admin source icon: Yes
Additional factsEntered manually by youOnly after you publish

Each field in every category shows a source icon, so check the icon rather than assuming the category. The Help Center says admin-linked facts are published when Shopify creates them, and lists Shipping and delivery settings as one admin source. If a Fulfillment field shows an admin icon, treat it as live and confirm on the field’s status.

What changes on January 15, 2027

What you need to do depends on how much you stored in the old app. Shopify describes three cases.

You used the app and have 1,000 or fewer facts

The facts you wrote or edited moved over and were published, so agents can keep using them. You can unpublish any fact at any time and no action is required. Read them once anyway, because they are live now.

You used the app and have more than 1,000 facts

Your facts did not move. Add the overrides and additional facts you want to keep before January 15, 2027. Shopify says it emailed these stores directly. Pick the facts customers actually ask about, not everything the old app held.

Shopify’s two documents describe the limit differently. The changelog says the page “holds up to 1,000 additional facts,” while the Help Center says 1,000 in total, generated facts included. Plan for the lower, total figure. They also word the boundary differently: “fewer than 1,000” in one, “1,000 or fewer” in the other. At exactly 1,000, check your admin.

You never used the app

Nothing is required. Facts drafted from your storefront wait unpublished until you publish them. Policies and contact details are the exception, as above.

The nine-step review, in order

The order follows what is already live first and what waits second. Steps 1 to 8 come from Shopify’s documented controls. Step 9 is our practice, not a Shopify requirement.

Step 1: Check who can publish

You need to be the store owner, or have the Manage and install apps and channels or Agentic permission. Facts are stored as metaobject entries, so non-owners also need Content permissions: Entries > Create and edit lets staff add, edit and publish facts (Shopify Help Center). Decide who owns the page. If your store is password-protected, the scan cannot reach it and the page shows only data from your admin.

If you run a custom storefront or are on the Agentic plan, you can add only Additional facts, so Steps 3 to 5 do not apply to you.

Step 2: Confirm your policy pages are complete

Every AI channel requires a completed Terms of service, Privacy policy and Return and refund policy under Settings > Policies. The Company policies category also flags any policy marked Missing.

Step 3: Read Company policies and Contact first

Read each field as a customer would. Is the return window right? Does the phone number still ring? Fix errors at the source in your admin, because that is where the field reads from.

Step 4: Read each scanned category against its source page

Open Returns & warranty, Payment, Fulfillment, Gift services, Second hand, About the Store and Brand and Identity. Each fact links to the page it came from, so click through. Publish only what matches reality. If a fact is wrong, unpublish it, correct the source page, then use Request rescan, which can take up to 48 hours.

Step 5: Use Manual when you need the exact answer

Click a field’s source icon, switch it to Manual and type the answer agents should use. A scan “doesn’t always detect a change” you make to your storefront, so adding the answer directly is the reliable route. Manual fields stop reading from the page, so you maintain them yourself. It is also the only way to add reference URLs to a field.

Step 6: Add Additional facts for the gaps

Additional facts are manual only. Each has a title and a type: Paragraph, Yes/No or Tags. Use them for what the other nine categories do not cover. In our view the first candidates are cancellation, order changes, exchanges, lead times and anything your support team answers every week. That list is our inference, because Shopify does not publish a recommended list.

Step 7: Handle suggested updates

Later scans can propose changes, shown as Suggested update. You can Approve & publish or reject with a reason. Shopify says “Knowledge base content is never changed without your approval.” Set a recurring reminder so these do not pile up.

Step 8: Watch the 1,000-fact cap

Generated and additional facts share one limit. It matters mainly if you are migrating a large set from the old app before January 15, 2027.

Step 9: Ask the agents yourself

Ask ChatGPT, Gemini and Copilot your ten most common customer questions, log what comes back, and compare it with your page. Repeat monthly. If ChatGPT is the agent you worry about most, our guide to claiming your business in ChatGPT covers the ChatGPT side of this.

Where conflicts hide

The scan reads your public pages, so any page that disagrees with your policy is a place a wrong fact can come from. This is where we would look first. It is inference from how the scan works, not a record of failures we have observed.

  • Return window. The policy page says one thing, a product page, FAQ or footer says another.
  • Shipping times. The shipping policy says 3-5 days and a promo banner promises faster.
  • Seasonal banners. A holiday cutoff or sale message still sits on a page months later.
  • Contact details. The footer phone or email differs from the one in your admin.
  • Trade terms. Public wholesale pages with different terms could be read as consumer policy.

The fix is rarely the Knowledge base itself. It is usually one inconsistent page.

The cancellation gap

Buyer-phrased questions are where answers tend to go missing, and the best evidence we have is a test reported by Search Engine Journal’s Hunt. It probed 122 top Shopify merchant stores in 2026. Of the 88 stores that had a policy tool, 70 gave a usable answer to the return-window question. Asked “Can I cancel an order after placing it, and by when?”, 8 of 88 returned something and 2 of 88 returned a usable answer. Two stores answered with their shipping FAQ.

Treat those numbers as a signal, not a benchmark. The stores were top merchants, not a random sample. The report does not define “usable.” The test also queried each store’s own policy tool, not the Knowledge base, and the new Knowledge base page did not exist yet.

Two other questions fared no better: shipping cost to an address was usable for 0 of 88 stores, and used or open-box returns for 5 of 88. Whether an Additional fact changes those results is our inference, because the test predates the Knowledge base and we have not run it. It is still the one place Shopify lets you state the answer yourself. Add a Paragraph fact titled something like “Can I cancel or change an order after placing it?” and answer it the way your support team does, with the real time window and how to reach you.

What the page cannot do

The sources we reviewed do not say the page shows what an agent says in a chat. It shows what Shopify holds and has published. That gap is why Step 9 exists.

Two limits are worth stating:

  • No visibility promise. Shopify said of the old app that it improves accuracy but “doesn’t affect how often your store appears in AI platform results”. That statement is about the old app. Treat the new page as an accuracy tool, not a ranking lever.
  • Metrics are unconfirmed. The old app showed question volume and which questions AI could answer. We could not confirm the new page keeps those. Check your admin.

If you are also deciding on checkout, our guide to Google AI Mode and Gemini checkout covers that setting. Whether AI recommends your store at all is a separate problem, covered in why ChatGPT recommends Wayfair and not your store.

Frequently asked questions

Does Shopify’s Knowledge base publish anything automatically?

Yes, for admin-linked facts. Shopify says facts linked to your admin, such as store policies and contact details, are published when Shopify creates them. Facts from a storefront scan stay unpublished until you publish them. Each field shows a source icon, so check the icon rather than assuming the category.

What happens to the Shopify Knowledge Base app on January 15, 2027?

It stops being available. Stores with 1,000 or fewer facts had their written and edited facts moved over and published. Stores with more than 1,000 need to add the facts they want to keep before the date, and Shopify says it emailed those stores directly.

Do I have to do anything if I never used the old app?

No action is required, but the page is worth a quick check. Facts drafted from your storefront wait there unpublished until you publish them. Policies and contact details linked to your admin are already live, so read those first and fix any page that is wrong.

How do I correct a wrong fact?

Unpublish it, fix the source page on your store, then click Request rescan, which can take up to 48 hours. If you need the answer corrected sooner, switch the field to Manual and type it in. You then maintain that field yourself, and it stops reading from your pages.

Can I see what AI agents say about my store?

Not that we could confirm. The Help Center describes what Shopify holds and has published, and we found no mention of agent answers. To see them, ask ChatGPT, Gemini and Copilot your top ten customer questions each month, log what comes back, and compare it with your page.

The bottom line

  • Read Company policies and Contact today, because Shopify names them as already live. Then review each scanned category against its source page and publish only what is right.
  • Add Additional facts for the questions your support team answers every week, such as cancellation. If you used the old app with more than 1,000 facts, re-add what you want to keep before January 15, 2027.

Want a second set of eyes? Our paid Shopify Store Audit reviews your agentic channel settings and is a good place to start if you want to know how your store is set up for AI channels before a customer asks.

Need a dedicated Shopify partner?

We’re an Atlanta-based Shopify agency helping growing merchants across the US with custom design, complex migrations, and conversion rate optimization. Book a free discovery call to discuss your goals, walk through clear timelines and pricing, and see how we can elevate your site, no commitment required.