Skip to content
Documentation

Uploading documents

Uploading is the one step that reads your documents, and the one step charged by the page. Everything after it — building tables, adding columns, rerunning — works against documents that have already been read.

What ingestion does

Drop files into a workspace and each one is read, split into pages, and indexed so that a question can find the passages that answer it. That is charged at one credit per page, once per document — not once per table, and not again when you add a column later.

The consequence is worth planning around: upload everything relevant up front. A workspace holding all forty leases costs the same to read whether you ask one question of them or thirty, and a table you build next quarter will find them already indexed.

Formats

FormatNotes
PDFThe main path, including scanned documents. Pages are read as page images, which is what makes a citation a page you can look at.
DOCX and DOCWord documents, including long contracts with schedules. Legacy .doc is accepted; a page is a page.
PPTXSlide decks. One slide reads as one page.
XLSXSpreadsheets, laid out before they are read — see below. Legacy .xls is not accepted.
JPEG, PNG and WebPSingle images — a photographed page, a screenshot, a scanned certificate. One image is one page.

Audio and video are not supported, and nor is anything else — a format that is not in the list above is rejected at upload rather than accepted and then failed.

Images are a page, not a document

An image is already what every other format is converted into: a page picture. So it skips the conversion entirely and is stored as a one-page document, normalised to the same size and quality a PDF page is rendered at. One image costs one credit to read.

The one difference you will notice is in the citations panel: a page of a PDF can be downloaded as a PDF, and an image cannot, because there was never a PDF to cut it out of. The page picture and the highlighted quote work exactly as they do everywhere else.

A picture can also be an answer rather than only a source. An image column fills its cells with the page — or the part of a page — that shows what you asked for, whether that page came from a PDF, a slide deck or an uploaded image. Nothing about uploading changes for it; the reading is the same reading.

Spreadsheets are laid out before they are read

A slide is a page and a Word page is a page, but a sheet is an unbounded grid with no intrinsic page — so a spreadsheet is rewritten before conversion rather than left to a converter’s default print settings. Each sheet is fitted to one page wide in landscape, its header row is repeated on every page, its name is printed on every page, and a sheet too wide to stay legible is split into column groups that each repeat the label column.

This matters for three reasons that are easy to hit and hard to diagnose: a row torn across two pages loses the thing a spreadsheet means, a page with no sheet name on it cannot answer “which sheet did this come from?”, and an invented pagination inflates the page count — which is both what you are charged and what the per-document limit is measured against.

What a file is doing while you wait

An upload moves through a short set of states, and the panel names each one rather than showing an undifferentiated spinner:

StateWhat it means
PendingUploaded, waiting to start.
QueuedWaiting for a free processing slot. Your organisation processes a set number of files at once, by tier, and the rest wait their turn — see tiers and limits.
ProcessingBeing read, split and indexed.
ReadyIndexed. A table can ask questions of it.
FailedAccepted but could not be read. See below.

Queued and Failed are the two worth telling apart, because only one of them needs you. A queued file is waiting and will run — dropping fifty documents at once is a perfectly reasonable thing to do, and the queue is what makes it safe rather than something to avoid. Nothing was refused, and nothing needs uploading again.

Two limits to know about

Pages per document. One ingest job may contain up to a fixed number of pages, which starts at 100 and rises with lifetime spend. A document over the limit does not ingest. This is a cap on how large a single job can get, not a billing gate: every page is charged at the same rate at every tier.

Upload size. The largest single file starts at 1 MB and rises the same way. A scanned PDF hits this well before a text one does. Both numbers are in tiers and limits.

The files panel

The panel beside a table lists every document in the workspace, with a bundles column beside it. From there you can select several files at once, preview one without leaving the table, open a document full-screen, and drag files onto table rows or into bundles. Deleting a document removes it from the workspace and from the rows that pointed at it.

Uploading does not require a table. A workspace can hold documents that no table asks anything of, which is the normal state of a workspace early on.

When a document fails to ingest

Failed documents surface on your home page rather than going quiet in a list — the same place failed and stale cells are collected. The usual causes are a page count or file size over the tier’s limit, a file that is corrupt, or a PDF that is a container for something else. See troubleshooting.

A document that fails has not been indexed, so no table can ask anything of it. Fix the file and upload it again rather than expecting a retry to behave differently.