Shopify has taken a big step toward streamlining AI‑driven support by embedding the Knowledge Base directly into the admin under Sales channels > Agentic > Knowledge base. The standalone Knowledge Base app will disappear after January 15, 2027, and all store owners now have a single, native place to review, edit, and publish the facts that power Shopify’s AI agents. In this post we break down exactly what changed, who is affected, and the concrete steps you should take right now to stay ahead of the transition.
What the new Knowledge Base looks like
The built‑in Knowledge Base is a single-page interface that lists “facts” – discrete pieces of store information such as contact details, gift‑wrap policies, or shipping FAQs. Shopify automatically drafts facts from any publicly published storefront page and links each fact back to its source. Drafted facts stay hidden from AI agents until you explicitly publish them, giving you full control over what the bots can say on your behalf.
Why the change matters for merchants
For merchants, the biggest benefit is a tighter workflow. You no longer need to juggle a separate app, manage separate login credentials, or worry about app deprecation. All knowledge‑management tasks live where you already handle sales channels, orders, and theme settings. This reduces friction when updating facts after a policy change, a new product launch, or a seasonal promotion. Plus, the native UI aligns with Shopify’s design system, making it easier for non‑technical staff to adopt.
Impact on developers
Developers who built custom integrations with the old Knowledge Base app will need to adjust. The app’s API endpoints are being retired, so any webhook listeners, custom UI extensions, or private apps that fetched or pushed facts must migrate to the new Admin API schema. Shopify now exposes facts via the GraphQL Admin API under the "agenticKnowledgeBase" field. Below is a minimal query to list published facts:
graphql
query GetPublishedFacts {
agenticKnowledgeBase {
facts(first: 100, published: true) {
edges {
node {
id
title
sourceUrl
}
}
}
}
}
If you previously used REST endpoints, replace them with the GraphQL equivalents and update authentication scopes to include "read_agentic_knowledge_base" and "write_agentic_knowledge_base". The new scopes are required for any app that creates, updates, or publishes facts.
Migration path for existing app users
Shopify has already migrated facts for stores with fewer than 1,000 entries. Those facts are now live in the admin and automatically published, so no action is needed. For stores with more than 1,000 facts, only the first 1,000 were moved. The remaining facts were left in the old app and will be inaccessible after the deprecation date. If you fall into this category, you should:
graphql
mutation CreateFact($input: KnowledgeBaseFactInput!) {
knowledgeBaseFactCreate(input: $input) {
knowledgeBaseFact {
id
title
published
}
userErrors { field message }
}
}
Example $input:
{
"title": "Return Policy",
"content": "We accept returns within 30 days.",
"sourceUrl": "https://yourstore.com/pages/return-policy",
"published": false
}
Best practices for managing facts
• Keep facts concise (one‑sentence or short paragraph) so AI agents can surface them quickly.
• Tag facts with clear titles that match common customer queries (e.g., "shipping times", "gift wrapping").
• Regularly audit unpublished drafts – they may become outdated after promotions end.
• Use the sourceUrl link to trace back to the original page; if the page changes, update the fact accordingly.
• Leverage version control: export facts via the GraphQL "knowledgeBaseFactExport" query and store them in Git for change tracking.
Next steps and resources
The Knowledge Base is live today in every Shopify admin. To get started:
By consolidating knowledge management into the core admin, Shopify makes it easier for merchants to keep their AI assistants accurate and for developers to build reliable integrations. Take advantage of the new UI today, and ensure your store’s facts stay fresh, searchable, and compliant before the January 15, 2027 deadline.
Ready to optimize your AI‑driven support? Log in, publish your first fact, and let Shopify’s agents start delivering better answers tomorrow.
