Documents
Knowledge base

Documents

Upload PDFs, Word files, spreadsheets, text files, and images — Asks extracts the text, with OCR for scans and images.

Documents are files you upload directly: price lists, product manuals, policy PDFs, spreadsheets, even photos of a printed menu. Asks extracts the text and indexes it like any other knowledge. The files themselves are never shown to customers — only the agent reads them. Manage them at app.asks.app/knowledge-base/documents.

Accepted file types

TypeFormatsNotes
PDF.pdfScanned PDFs work too — pages without a real text layer are read via OCR (up to 20 pages per document)
Word.docx, .doc
Spreadsheets.xlsx, .xlsCell text is extracted
Text.txt, .md, .csv
ImagesPNG, JPEG, WebPText in the image is extracted via OCR

Each file can be up to 10 MB, uploaded one file at a time. Unsupported types are rejected at upload with an error.

Upload a document

Open the upload dialog

Click Upload on the Documents page, then drag a file into the drop zone or browse for it.

Upload Document dialog with a Choose file button and a drag-and-drop zone
Drag and drop, or click to browse. Unsupported types are rejected immediately.
Wait for extraction

Extraction runs as part of the upload — text is pulled from the file (via OCR where needed), checked against your plan's article limit (each file counts as one Knowledge Base Article), and indexed. When the dialog confirms, the document is live for the agent.

Check the result

The document appears in the list with its extracted size — how much usable text was pulled from the file — alongside the raw file size and upload date. A search box filters the list as it grows.

Documents list with a search box and rows showing each file's extracted text size, raw file size, upload date, and a delete action
Each row shows both the extracted text size and the raw file size — either way, one file is one article.

Click a document to open it: a read-only view of the extracted text with the file's details, a Download original file action, and Delete document. The extraction can't be edited — to change a document, upload a new file.

Extracted text and your article limit

Every uploaded file counts as one Knowledge Base Article against your plan's limit, regardless of file size. The extracted-size column is informational — it shows how much usable text the agent got out of the file (a 10 MB PDF full of images might extract to a few hundred kilobytes of text). One flat guardrail applies per item: a single file can hold up to 2 MB of extracted text. See Articles & limits.

Deleting a document removes it from the index and frees its article slot immediately. There is no replace flow: uploading a file again creates a new document (and uses a new article), so to update a file, delete the old version first.

For content that changes often, prefer a website source or an article over re-uploading files — websites re-sync on a schedule, and articles re-index on save.
OCR reads what's visible. Very low-resolution scans or decorative images with no readable text may extract little or nothing — an image that yields no text is stored with an extracted size near zero and skipped by indexing. Check the extracted size after upload if the agent seems unaware of a document's contents.