import FeatureAvailability from '@site/src/components/FeatureAvailability';

Context Documents

<FeatureAvailability/>

Context Documents let you capture tribal knowledge in DataHub. With Context Documents, you can create runbooks, FAQs, process guides, decision logs, and more to capture curated organizational context.

Once created, documents can be published to become visible to your team and AI assistants like Ask DataHub to provide grounded, consistent answers.

<p align="center"> </p>

Highlights

Context Documents are first-class citizens in DataHub. You can:

• Classify by type — Runbook, FAQ, Policy, Decision Log, and more
• Organize with metadata — Domains, Tags, Glossary Terms, Owners, and Structured Properties
• Link related assets — Connect to the Datasets, Dashboards, and Charts they describe
• Control visibility — Publish to share with your organization and AI agents, or keep as draft
• Track version history — See changes over time and restore previous versions

Creating a Document

Create documents from the Documents section in the left navigation.

1. Click + New to create a new document.
2. Choose a parent document (optional) to nest it in your hierarchy.
3. Enter a title and write your content using the rich text editor.
4. Add metadata (Type, Owner, Tags, Domain) as needed.

<p align="center"> </p>

Publishing a Document

Documents can be in Draft or Published states. Draft documents are only visible to you - the owner. Published documents are visible to everyone else.

Toggle Published in the document header to publish or unpublish your documents.

<p align="center"> </p>

:::info Context Documents are created in Published state by default. :::

Moving a Document

Reorganize your document hierarchy at any time.

1. Open the document or use the context menu in the directory tree.
2. Select Move.
3. Choose a new parent (or move to top-level).

Searching for Documents

Find documents using DataHub's primary search bar alongside your data assets, and within the Documents tab accessible from the left navigation bar.

Document History

Track changes, view previous versions, and restore document contents by visting the document history timeline.

<p align="center"> </p>

Change types include:

• Document is created
• Document title is changed
• Document contents are changed
• Document is published or unpublished
• Related assets are updated

Context Documents in Ask DataHub

When you ask a question in Ask DataHub, the AI searches your published documents alongside your metadata graph. If relevant context is found, Ask DataHub cites the document in its response.

<p align="center"> </p>

Note: Ask DataHub is available in DataHub Cloud only.

Programmatic Access

Context Documents are accessible via:

• Python SDK: Create, update, and retrieve documents programmatically. See the Documents API tutorial.
• MCP Server: Expose documents to AI agents and external tools. See the DataHub MCP Server.

What's Next

We're actively expanding Context Documents:

• External document connectors: Bring in documentation from tools like Notion and Confluence while keeping the source of truth external.