> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vinmake.com/llms.txt
> Use this file to discover all available pages before exploring further.

# The other lane: uploading a document

> Most documents are not composed, they arrive. The upload lane joins the same path at the same intake queue.

# The other lane: uploading a document

Most documents are not composed.
They arrive.
A supplier emails a PDF; someone photographs a receipt.

That is the upload lane, and it joins the golden path at the same intake queue, with the same two gates.

## Put the file on the Clerk's desk

From the landing, open the **Clerk** - from the *Chat with* picker, the agent roster, or the
**Upload** card under *Apps*, which goes straight there.
Its workspace has three tabs; **Upload** is the one that starts an intake.

There are two drop zones, and picking the right one is the only decision you make.

| Zone                       | Accepts                              | Produces                     |
| -------------------------- | ------------------------------------ | ---------------------------- |
| **A document**             | PDF · JPEG · PNG · WebP, up to 25 MB | one file, **one** intake row |
| **A list of transactions** | JSON only, up to 5,000 rows          | **one intake row per row**   |

<Frame caption="The Clerk's Upload tab. Two typed drop zones above, the live intake feed below.">
  <img src="https://mintcdn.com/vinmake/-Vh9mkHXk4f1Knq6/images/greatbook/guides/95-clerk-upload.png?fit=max&auto=format&n=-Vh9mkHXk4f1Knq6&q=85&s=3296585d685d1d43b5dbc19be637287e" alt="The Clerk's upload tab with its document and transaction-list drop zones and the intake feed" width="1440" height="900" data-path="images/greatbook/guides/95-clerk-upload.png" />
</Frame>

<Warning>
  **Typing the contents of a document into the chat does not start an intake.**
  Only a file on this tab, or a file dropped onto the composer, does.
  A pasted table is a conversation; an intake row exists because a file arrived.
</Warning>

<Note>
  A spreadsheet is stored in **Files** but not parsed.
  Export it as JSON for the list lane, or hand it to the **Typewriter**, whose job is turning a list
  into schema-valid JSON.
</Note>

You can still drag a PDF straight onto the composer on the **Chat** tab and add a one-line
instruction such as *"Please process this supplier VAT invoice."*
Both surfaces use the same attachment builder.
At the current web and backend source revisions, that builder stores the Files row but drops the server-minted upload authority the Clerk requires to adopt it, so this browser handoff is not claimed end to end.
[Upload to posted journal entry](/greatbook/technical/upload-to-ledger) separates the intended storage and Clerk contracts from this current source-boundary gap.

<Frame caption="The composer menu: attach, switch agent, hide tool calls, in one place.">
  <img src="https://mintcdn.com/vinmake/-Vh9mkHXk4f1Knq6/images/greatbook/guides/84-composer-menu.png?fit=max&auto=format&n=-Vh9mkHXk4f1Knq6&q=85&s=5ed46c7970ee7c3a66b5b9f338112834" alt="The composer plus-button menu showing upload, switch agent and tool call options" width="1440" height="900" data-path="images/greatbook/guides/84-composer-menu.png" />
</Frame>

## Read what the Clerk did with it

The Clerk replies with what it decided and, crucially, **what it was not sure about**.

It states the classification, how many items it flagged, who it staged the row for, and the status it left it at.
Then it stops.

<Frame caption="An upload-lane conversation. PDF attached, classified as supplier_vat_invoice, 3 items flagged, staged as flagged in the intake queue.">
  <img src="https://mintcdn.com/vinmake/-Vh9mkHXk4f1Knq6/images/greatbook/guides/82-clerk-thread.png?fit=max&auto=format&n=-Vh9mkHXk4f1Knq6&q=85&s=e590eeed7c649ec32e31d437f1c9405f" alt="A Clerk conversation showing a classified upload, the flags raised, and the resulting queue status" width="1440" height="900" data-path="images/greatbook/guides/82-clerk-thread.png" />
</Frame>

<Note>
  "I don't fix or approve, so it waits for a human" is the Clerk describing its own boundary accurately.
  It never edits a document and it never approves one.
  Its whole job is to read, classify, link, check for duplicates, and name what it could not settle.
</Note>

## What just happened underneath

The Clerk is a LangGraph graph in its own lane.
It classifies the document against your SOPs, extracts the fields the document type declares, links related documents, checks for duplicates against the existing queue, and stages a row.

Two properties are worth knowing.

**It writes to the queue, never to the ledger.**
There is no path from the Clerk to a journal entry that does not pass through both gates.

**Confidence is calibrated, not decorative.**
On a legible document the Clerk's field confidences run high.
On a degraded fax they drop, and when they drop far enough the **money fields come back empty rather than guessed** and the document is flagged.
A blank field you can see is worth far more than a plausible number you cannot check.

## Watch it land, without leaving the tab

Under the drop zones, the **intake feed** fills in as the Clerk works: the file, the derived name it
gave the document, the doc type it decided on, and the state it left the row at.

The link at the end of a row says whether there is anything left to do: **Open in review →** while
the row is still actionable, **View review record →** once it is posted or rejected.
There is an **Open the review inbox →** link above the table too.
They all go to the same place, because the feed is a view onto the queue rather than a second queue.

## Then continue exactly as before

Go to **Books → Review**.
Rows drafted by `clerk` sit alongside rows drafted by `typewriter` in one inbox, with the same tabs and the same two gates.

From here the path is identical to [gate 1](/greatbook/guides/intake-gate) onwards.

<Note>
  One difference worth knowing.
  A **flagged** row can be sent back to the agent for another extraction pass.
  A Typewriter-composed row, which arrives unflagged, cannot: there is no agent extraction to redo.
  See [Working the review inbox](/greatbook/guides/review-inbox).
</Note>

## Where uploaded files are listed

**Files** in the left rail is every file stored in GreatBook, **including the ones intake does not
parse**: the file, where it came from, who uploaded it, its size, when it arrived, its status, and
the classification the **Actions** pipeline gave it.
You can also drop files here directly - **any** business file up to 25 MB, whether or not the Clerk
can read it, because this page stores rather than parses.

The **Timeline** view includes direct and chat-borne uploads in newest-first order.
The **Folders** view keeps unfiled evidence visible at the root and reports the read-only Drive reconciliation state separately from GreatBook's canonical upload record.
See [Files: Timeline and Folders](/greatbook/features/files) for the two views and their unavailable states.

## Actions: the work an agent says needs a person

**Actions** is the run ledger for agentic work, including failed, blocked, stale and legitimate no-change outcomes.
It is separate from **Audit → Actions**, the human worklist over Assurance findings.
See [Actions agent-run inbox](/greatbook/features/actions-inbox) for the distinction.

## Related

* [4 · Gate 1, the intake approval](/greatbook/guides/intake-gate) - where this lane rejoins the golden path
* [Working the review inbox](/greatbook/guides/review-inbox) - reject, send back and revise
* [Known rough edges](/greatbook/guides/troubleshooting)
* [Upload to posted journal entry](/greatbook/technical/upload-to-ledger) - every artifact, store, identity, refusal and human gate
