Shopify Knowledge base: move before Jan 15
Short answer
Shopify Knowledge base is a page in your admin, under Sales channels > Agentic, where you review and publish the store facts AI agents use to answer shoppers. It replaces the Shopify Knowledge Base app, which is deprecated on January 15, 2027. If the app held 1,000 or fewer facts, your edited and added facts moved over automatically. If it held more, you must add them by hand.
By Ronen Amit, Founder, SourceVision. Published .
On this page
- What is the Shopify Knowledge Base?
- What happens to the Shopify Knowledge Base app on January 15, 2027?
- How do you set up Shopify Knowledge base?
- Does Knowledge base help your store appear in AI answers?
- How do you add your own facts to the knowledge base?
- Where can you see what shoppers ask AI agents about your store?
- Frequently asked questions
- Related guides
- Sources
Shopify Knowledge base is where you tell AI agents the facts about your store: how returns work, where you ship, how to reach you. It now lives in your admin, and the Shopify Knowledge Base app it replaces is deprecated on January 15, 2027. This guide covers what moved over, how to review and publish your facts, and what Knowledge base can and cannot do for you.
What is the Shopify Knowledge Base?
Shopify Knowledge base is a page in your Shopify admin where you review, edit and publish the facts AI agents use to answer shoppers’ questions about your store. Shopify calls those facts the source of truth for all non-product information, such as your return process, shipping timelines and brand values.
Shopify’s help page explains how it is used. When a shopper asks an AI chat about your store, the agent can query your knowledge base through the Storefront MCP. Your published knowledge base is publicly available that way, and AI channels including Shop and third-party platforms can use it.
Product details are not part of it. Those reach agents through Shopify Catalog, which our agentic storefronts guide covers. Knowledge base holds everything else, grouped by Shopify into ten categories:
- About the store, and Brand and identity
- Company policies, and Returns and warranty
- Contact, Payment and Fulfillment
- Gift services and Second hand
- Additional facts, which you write yourself
For where it fits among Shopify’s other AI features, see our overview of Shopify AI tools.
What happens to the Shopify Knowledge Base app on January 15, 2027?
The app is deprecated on January 15, 2027, and can no longer be installed. If the app held 1,000 facts or fewer, your edited and added facts moved to Knowledge base automatically and were published. If it held more than 1,000, you must add the ones you want by hand before that date.
The changelog post adds three details. Shopify published the facts it moved, so agents keep using them, and you can unpublish any of them. It emailed the stores with more than 1,000 facts directly. And if you never used the app, there is nothing to do: Knowledge base is already in your admin, with facts drafted from your storefront and left unpublished.
The limit matters for large stores. Shopify’s help page says a knowledge base holds 1,000 facts in total, counting both the facts Shopify generates and the ones you add. The changelog post words the cap as 1,000 additional facts, so plan for the stricter reading: 1,000 in all. A store over the limit cannot copy everything across. Pick the facts shoppers actually need.
One more deadline shares the date. Shopify’s developer changelog says the old Storefront MCP tool for policies and FAQs is maintained until January 15, 2027. Its replacement, a UCP tool called ask_business, answers a buyer’s question from your knowledge base and policies. If you built your own shopping agent on the old tool, tell your developer.
| Shopify Knowledge Base app | Knowledge base | |
|---|---|---|
| Where it lives | Apps > Knowledge Base | Sales channels > Agentic > Knowledge base |
| Status | Cannot be installed, deprecated January 15, 2027 | Built into the admin |
| What it drafts from | Your store's settings and policies | Your public storefront and your admin data |
| Drafted facts | Shown as default FAQs | Scanned facts wait for you to publish. Policy and contact facts publish when created. |
| Your own entries | Custom FAQs, 1 to 2 sentence answers | Additional facts: Paragraph, Yes/No or Tags |
| Shopper questions | Query log with unanswered questions | Not described on Shopify's help page |
The new page drafts from more sources, and nothing it scans goes live until you publish it.
Source: Answering customer questions with your knowledge base
How do you set up Shopify Knowledge base?
Open Sales channels > Agentic in your admin and click Knowledge Base in the Sources section. Check each category’s facts against your storefront, fix what is wrong, then publish. Facts scanned from your storefront stay unpublished until you publish them, while facts linked to your admin, such as policies and contact details, publish as soon as Shopify creates them.
-
Check your fact count
1,000 or fewer moved over and were published. More did not.
-
Open Knowledge base
Sales channels > Agentic, then Knowledge Base under Sources
-
Review each field
Check its source icon and its reference links
-
Fix or add
Switch a field to Manual, or add an additional fact
-
Publish
All facts, one category, or one field at a time
-
Keep it current
Approve or reject suggested updates, or request a rescan
Scanned facts reach no agent until you publish them, so review comes before publish.
Source: Answering customer questions with your knowledge base
Every field shows where its information came from. An icon marks it as scanned from your storefront, taken from a place in your admin, or typed in by you. Each field can also carry reference links, which are available to agents along with the field’s information, so an agent can point to where an answer came from.
Policies feed many of these answers, so fix them at the source first. Our guide to store policies covers what a return and shipping policy should say, and the free return policy generator drafts one you can edit.
Shopify keeps scanning your store. When a scan finds something new, a Suggested update appears, and you click Approve & publish or reject it. Shopify says it never changes your knowledge base without your approval. A scan can miss a change, though, and the help page says to add or edit a fact directly when it must be there. A requested rescan can take up to 48 hours.
Does Knowledge base help your store appear in AI answers?
Not by Shopify’s account. Its help page for the app says Knowledge Base improves the accuracy of AI answers but “doesn’t affect how often your store appears” in AI results. It makes the answer correct once your store comes up. It does not make your store come up.
That is still worth doing. A shopper who asks about your return window should get your real return window. How often assistants name your products depends on other signals. Shopify’s own listing insights for AI channels check things like description completeness, images and reviews on your product pages.
That part is what SourceVision measures. We report how often your products appear in assistants’ answers, with the range across repeated runs, so you can see where you stand before and after a change. We propose fixes to your product pages from facts you confirm, and nothing changes until you approve it. When we measured one of our users in September 2026, it was recommended in 1 of 225 answers (0.44%).
SourceVision is in an invite-only beta.
How do you add your own facts to the knowledge base?
In Knowledge base, go to the Additional facts section and click Add fact. Give the fact a clear title, pick a type (Paragraph, Yes/No or Tags), enter the information, add a reference link if you have one, then publish it and click Save.
The three types fit different questions:
- Paragraph for anything that needs explaining, such as how your loyalty program works or what your products are made from. The agent answers in its own words, using your text as the source.
- Yes/No for a two-answer question, such as whether you offer gift wrapping. The answer is the whole fact.
- Tags for a short list of related values, such as your materials or certifications.
A fact takes one type. If something needs an explanation and a list, add two facts. To correct a drafted field instead, switch its source to Manual and type the right answer. That removes the references the old source supplied, and you maintain that field yourself from then on, though Shopify still offers suggested updates for it.
Keep the facts and your site in step. Shopify asks that what you add here matches your storefront, with a public page as the reference. If shoppers keep asking about something your product pages never say, put it on the page too. Our guide to product page questions covers how.
Where can you see what shoppers ask AI agents about your store?
The old app had a query log listing the questions shoppers asked AI agents, which agent asked, and whether it found an answer. Shopify’s help page for the new Knowledge base does not describe a query log, so note what the app’s log shows before January 15, 2027.
The metrics page for the app describes the log. You can filter it to All, Answered or Unanswered, and each entry shows the agent, the question, what it was matched to and the date. Data appears only once your products start showing up in AI shopping conversations.
The unanswered questions, which the app gathers under Top unanswered questions, are the useful part. Each one is a question a shopper asked that your store could not answer. Turn the recurring ones into additional facts now, while you can still read them.
For signals that are documented on the new side, Shopify’s Agentic section reports sales, orders, sessions and conversion per AI channel. Its listing insights also include a shop policy completeness signal, which checks that your shipping, returns, refund and other policies are present.
Its search preview also lists Top search queries and Queries where your products appeared. Those are for testing how your products rank, and the help page does not say they include questions about your store.
Frequently asked questions
Is Shopify Knowledge base free?
Shopify's pages do not name a price for it. The changelog says it is built into your admin, and stores that never used the old app need do nothing to get it. What it takes is the time to review and publish your facts.
How do I log in to Shopify Knowledge base?
There is no separate login. Open your Shopify admin, go to Sales channels > Agentic, and click Knowledge Base in the Sources section. Staff other than the owner need the Manage and install apps and channels permission or the App and sales channel > Agentic permission, plus Products > View to open the Agentic section (without it, they can open the Knowledge base page directly). Shopify's Content permissions then decide whether they can view, edit or delete facts.
How do AI agents read my Shopify knowledge base?
Shopify says agents query your published knowledge base through the Storefront MCP, which Shop and third-party AI platforms can use. Its developer changelog adds that a newer UCP tool, ask_business, answers a buyer's question about your policies and services from your knowledge base and policies. That tool returns a written answer, not your raw facts or full policy text.
Do Knowledge base facts show on my storefront?
Not as a page. Shopify describes your published knowledge base as available to AI agents through the Storefront MCP, and its help for the old app said FAQs were not displayed directly on your storefront. Shopify also asks that what you add matches what your storefront says, with a public page as the reference.
Does Knowledge base pull information from my other apps?
Shopify's help page names two sources: what is publicly available on your storefront, and data from your Shopify admin. It does not mention third-party apps. If a detail lives only inside another app, such as a loyalty program, add it yourself as an additional fact.
What if my Shopify store is password-protected?
Then Knowledge base cannot read your online store, and it shows only information from your Shopify admin, such as your policies and contact details. Shopify scans your storefront to draft the rest, so a store behind a password gets fewer drafted facts. You can still add your own facts by hand.
Related guides
Google Merchant Center setup for Shopify
A step-by-step Google Merchant Center setup for Shopify stores: create the account, verify your site, set shipping and returns, connect and fix issues.
Shopify AI tools for merchants
What Shopify's AI tools do for your store: Sidekick, AI product descriptions, Catalog, Knowledge Base and agentic storefronts, and what they cannot show.
A Shopify SEO checklist for AI search
A store checklist for AI search on Shopify: crawler access, structured data, llms.txt, products, policies, Catalog eligibility, and where to check each.
Sources
- Answering customer questions with your knowledge base, Shopify Help Center, accessed .
- Knowledge base is now built into your admin, Shopify Changelog, accessed .
- Shopify Knowledge Base, Shopify Help Center, accessed .
- Managing your store FAQs using the Shopify Knowledge Base app, Shopify Help Center, accessed .
- Understanding your store FAQ metrics using the Shopify Knowledge Base app, Shopify Help Center, accessed .
- Managing agentic storefronts, Shopify Help Center, accessed .
- Storefront MCP policies and FAQs tool is being deprecated in favor of UCP MCP Ask tool, Shopify Developer Changelog, accessed .