FAQ

What can Knoku index?

Knoku can index Markdown/MDX/RST files, crawled HTML pages, GitHub Discussions, GitHub Issues and PRs, Notion pages, Confluence pages, Jira issues, OpenAPI operations, Zendesk Help Center articles, and uploaded files. See Sources.

What file uploads are supported?

Uploads support PDF, DOCX, Markdown, and plain text. PDFs need an embedded text layer; scanned PDFs without extractable text are rejected. DOCX page counts are estimated and may need confirmation before indexing.

Which documentation platforms work?

Docusaurus, VitePress, MkDocs, Nextra, Mintlify, Sphinx, Read the Docs, and custom websites all work. See Doc platforms.

How does Knoku answer a question?

Knoku searches the project’s index, reads the most relevant chunks and pages, then generates a cited answer. The answer should stay grounded in indexed sources. When the sources do not cover the question, Knoku should say that instead of inventing details.

How do I keep content current?

It depends on the source:

GitHub repo sync follows the configured branch.
Website crawl can be rerun; Business+ projects can use automatic crawl refresh.
Connected sources such as Notion, Confluence, Jira, OpenAPI, and Zendesk Help Center support manual sync and background refresh.
Uploads are static until replaced or deleted.

Where can users ask questions?

Users can ask from the website widget, support form deflector, Slack, Discord, MCP clients, and the Public API.

What is public vs internal content?

Public content is available to visitor-facing surfaces such as the widget, support form deflector, MCP, and public-scope API keys. Internal content is reserved for team/support surfaces and API keys configured with internal corpus scope. See Source groups.

Yes. Use the widget builder, script attributes, or the @knoku/widget npm package. Start with Widget, then use Attributes, Component styles, Icons, and Runtime API.

Yes. The default auto theme follows <html class="dark">, <html data-theme="dark">, and the browser’s prefers-color-scheme. You can also force light or dark. See Attributes.

Can one project power multiple sites?

Yes. Add each host under Domains. See Embed on multiple sites.

Is data private?

Knoku indexes only the sources you connect. Use source groups to keep private repositories, internal wikis, support runbooks, and uploaded files away from public visitor-facing answers.

Can Knoku be self-hosted?

Not today.

The site stops creating widget sessions. The project, indexed documents, analytics history, API keys, and other integrations remain until you disable or delete them from the dashboard.

FAQ