---
title: "What the Knowledge Engine is"
description: "A governed store of facts about your product, your competitors and your market, each one tied to where it came from."
updated: "2026-08-18"
verifiedAgainst:
  - packages/shared/src/knowledge.ts
---

The Knowledge Engine is what stops a draft describing a feature you do not ship.

It holds **facts**, each attached to an **entity** and traced to a **source**,
with a status saying how much it can be trusted. Drafting runs read from it
rather than from whatever a language model happens to remember about your
category.

## The three parts

<PropertyList>
  <Property name="Entity" type="own_product | competitor | category">
    The subject a fact is about: your own product, a competitor, or the category
    you both sit in.
  </Property>
  <Property name="Source">
    Where a fact came from. Either a web page anyone can open, or a document you
    uploaded privately.
  </Property>
  <Property name="Fact">
    One claim, with a facet (`pricing`, `features`, `integrations`, `limits`,
    `positioning` or `guidance`), a status, and the source behind it.
  </Property>
</PropertyList>

## Why the source kind matters

<Callout variant="warning" title="A private document can never become a public citation">
  A fact drawn from an uploaded document has no address a reader could follow, so
  it is never emitted as a citation in a published post. Facts from public web
  pages can be cited. Both inform writing; only one can be pointed at.
</Callout>

This is the mechanism that lets you upload an internal one pager without it
turning into a footnote on your blog.

## What it is used for

- Grounding drafts, so specifics come from your product rather than from a
  plausible guess.
- Comparisons, so competitor claims are traceable rather than invented.
- Keeping published posts honest over time, by noticing when a fact behind an
  article has gone stale.

## Where to go next

<CardGrid>
  <Card title="Product facts" href="/knowledge/product-facts">
    What Blogged knows about your product and how to correct it.
  </Card>
  <Card title="Verification" href="/knowledge/verification">
    The eight fact statuses and what each one allows.
  </Card>
  <Card title="Freshness and conflicts" href="/knowledge/freshness">
    What happens when the truth changes or two sources disagree.
  </Card>
  <Card title="Sources and documents" href="/knowledge/sources">
    Adding pages and uploading files.
  </Card>
</CardGrid>