Knowledge items & limits
Knowledge base

Knowledge items & limits

What counts as a knowledge item, what each plan includes, and what happens when you reach the limit.

Your knowledge base is measured in knowledge items — the unit the sidebar meter, the plan cards, and your subscription page show. Every item you add counts as exactly one, whatever its type:

  • an article you write — public or internal, draft or published, in any folder,
  • an uploaded file (PDF, DOCX, …) — one file is one item, regardless of file size,
  • a synced web page — one page is one item.

Importing 10 URLs and uploading 3 files uses 13 knowledge items. Your plan sets how many the knowledge base can hold, and you can add, edit, or remove them at any time — deleting an item frees its slot immediately. A document whose upload failed doesn't count, and a Shopify catalog answered live uses none at all.

Limits by plan

LimitFreeStarterBusinessPremium
Knowledge items503001,0003,000
Website re-sync frequencyWeeklyWeeklyDailyDaily
Contextual chunk indexing———Yes

Enterprise contracts set their own quotas. Need more on a paid plan? Add Extra Knowledge Items — blocks of 100 at $19/month each — from Subscription. Add-ons need a paid plan; on Free, upgrade instead. For the full plan matrix — credits, seats, and everything else — see Limits & quotas.

The re-sync frequency applies to both the auto-refresh schedule and the manual Sync button; a newly added website syncs freely for its first 24 hours while you set it up.

Operational caps

These are identical on every plan. They keep crawls fast and predictable rather than meter your knowledge:

CapValue
Extracted text per item2 MB (far more than any normal page or document)
Uploaded file size10 MB per file
Pages per website crawl2,000
Crawled pages per workspace10,000 per rolling 24 hours
Website syncs per workspace30 per hour
URLs in the review-pages picker5,000 per site
Editing an existing article or re-crawling a page you already have never uses a new knowledge item — only genuinely new items count. Uploading a file again is different: it creates a new document and uses a new item, so to update a file, delete the old version first (its slot frees immediately).

The usage meter

The bottom of the knowledge base sidebar shows a live Knowledge items meter: items used against your plan's limit. The info icon explains what counts. The bar turns amber at 80% with an Almost full — upgrade link, and red at 100% with Limit reached — upgrade; both open the Subscription page. The meter updates as you add or delete content.

Knowledge Base sidebar group (Articles, Websites, Documents) with the footer meter: a database icon, the Knowledge items label and info icon on one line, and a progress bar with the used / limit count beside it
The meter counts every article, file, and synced page.

What happens at the limit

  • New articles and uploads that would exceed the limit are rejected with "Knowledge item limit reached. Upgrade your plan or add more knowledge items." Nothing partial is stored.
  • Website syncs stop at the first new page that doesn't fit: pages indexed before that stay, and the website's page list shows Last sync stopped early — "your plan's knowledge item limit was reached" — with an Add knowledge items button. Existing pages the crawl reached before stopping are refreshed; the rest wait for the next sync.
  • Existing content keeps working. The agent still answers from everything already indexed; you only lose the ability to add more.

Asks emails the workspace owner and admins when usage passes 85% of the limit, when new content is rejected, and when a sync stops early on the limit.

To get back under the limit, delete items you no longer need (slots free immediately), upgrade your plan, or add the Extra Knowledge Items add-on.

Website re-syncs refresh the pages you already have without using new knowledge items, so a scheduled re-crawl of a stable site won't creep your usage up.
Chat on WhatsApp