> For the complete documentation index, see [llms.txt](https://help.brieftech.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.brieftech.ai/how-to-guides/upload/upload-documents.md).

# Upload documents

Add documents to a matter by drag-and-drop, the Upload button, or dropping whole folders.

In the <img src="https://2262431129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlnHu06wl3NH457iwjBmr%2Fuploads%2Fgit-blob-30913153ebd9cc9194606c644922feb649ae10a5%2Ftab-files.svg?alt=media" alt="Files tab" data-size="line"> tab, drag your files onto the file table.

## Drag-and-drop files or folders

1. Open the matter and go to the <img src="https://2262431129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlnHu06wl3NH457iwjBmr%2Fuploads%2Fgit-blob-30913153ebd9cc9194606c644922feb649ae10a5%2Ftab-files.svg?alt=media" alt="Files tab" data-size="line"> tab.
2. Drag files or folders from your computer onto the file table. The area highlights when it accepts the drop.
3. Release to drop. The **Upload Manager** opens with your files staged under **Gather Files For Upload**.
4. Review the list, then click <img src="https://2262431129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlnHu06wl3NH457iwjBmr%2Fuploads%2Fgit-blob-bc1505a9f57ad0de97978c9022bfe3c48e9a56d3%2Fbtn-upload-now.svg?alt=media" alt="Upload Now" data-size="line"> to start.

{% hint style="success" %}
**Tip:** You can also drop files or folders somewhere other than the file table:

* Drop directly onto a folder in the folder tree on the left to upload into that folder. BriefTech recreates any nested folder structure automatically.
* Drop straight onto the <img src="https://2262431129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlnHu06wl3NH457iwjBmr%2Fuploads%2Fgit-blob-8f18f06a78c4d0bf6e51eac54ec7d3e5d2cdb8a2%2Ftab-review.svg?alt=media" alt="Review tab" data-size="line"> tab to add them at the top level of the matter.
  {% endhint %}

## Use the Upload button

1. On the <img src="https://2262431129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlnHu06wl3NH457iwjBmr%2Fuploads%2Fgit-blob-30913153ebd9cc9194606c644922feb649ae10a5%2Ftab-files.svg?alt=media" alt="Files tab" data-size="line"> tab toolbar, click <img src="https://2262431129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlnHu06wl3NH457iwjBmr%2Fuploads%2Fgit-blob-b190e06d317a1b26f7d43dfd4dbc5d172fc99fa1%2Fbtn-upload.svg?alt=media" alt="Upload" data-size="line">.
2. Choose **Upload Files** to pick individual files, or **Upload Folder** to pick a whole folder (the structure is preserved).
3. Select your files in the system picker. The **Upload Manager** opens with them staged.

## Start from an empty matter

If a matter has no documents yet, the <img src="https://2262431129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlnHu06wl3NH457iwjBmr%2Fuploads%2Fgit-blob-30913153ebd9cc9194606c644922feb649ae10a5%2Ftab-files.svg?alt=media" alt="Files tab" data-size="line"> tab shows a large drop zone reading **Drop files or folders here for upload**. You can:

* Drag files or folders onto it, or
* Click <img src="https://2262431129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlnHu06wl3NH457iwjBmr%2Fuploads%2Fgit-blob-8fb0db73f10e5ba0926bea47de89141576f6bf4f%2Fbtn-select-files.svg?alt=media" alt="Select files" data-size="line"> to pick them from your computer, or
* Click **Just exploring? Load sample files to try BriefTech now.** to preload a set of sample documents and see how BriefTech works without using your own files.

{% hint style="info" %}
**Note:** If <img src="https://2262431129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlnHu06wl3NH457iwjBmr%2Fuploads%2Fgit-blob-bc1505a9f57ad0de97978c9022bfe3c48e9a56d3%2Fbtn-upload-now.svg?alt=media" alt="Upload Now" data-size="line"> is missing from the Upload Manager, the dialog is waiting for a choice:

* If some of your files match documents already in the same folder of the matter, BriefTech asks whether to skip the duplicates or upload them anyway — pick one and the button returns.
* If you have unticked any item in the Files to Upload list, click **Apply Selection** to confirm your choice and continue.
  {% endhint %}

## Track uploads in progress

Once an upload starts, you can keep working — uploads run in the background.

* Click the <img src="https://2262431129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlnHu06wl3NH457iwjBmr%2Fuploads%2Fgit-blob-81649e98b454973c25f13c51d6200489826e0bce%2Ficon-upload.svg?alt=media" alt="upload status" data-size="line"> button in the top bar to open the upload monitor, where you can track progress, retry failures, and cancel or clear files. For a full description of statuses and actions, see [Upload monitor](/reference/upload-monitor.md).
* In the upload monitor, each file moves through **Pending → Uploading → Uploaded**.
* Once a file reaches **Uploaded**, the server begins processing it in the background. You can track this in the file table: under **Views** in the left panel, select <img src="https://2262431129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlnHu06wl3NH457iwjBmr%2Fuploads%2Fgit-blob-f3cebd618a2f549a69636754c752d5896e471fd3%2Fview-processing.svg?alt=media" alt="Processing" data-size="line"> to see files still being processed, or <img src="https://2262431129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlnHu06wl3NH457iwjBmr%2Fuploads%2Fgit-blob-9def91ecd328a1e04b609ef3bef98b17609764eb%2Fview-processed.svg?alt=media" alt="Processed" data-size="line"> to see files that are ready.
* A file that **fails to upload** shows **Error** in the upload monitor. It stays listed there until you retry it, and because it never finished uploading it does not appear in your document lists.
* A file that **uploads but then fails to process** appears in the <img src="https://2262431129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlnHu06wl3NH457iwjBmr%2Fuploads%2Fgit-blob-37d644760a5ee6e01339e95d7c53eb14f0b99bb4%2Fview-exceptions.svg?alt=media" alt="Exceptions" data-size="line"> view, marked with a red icon. The reason is shown in that view's **Exception** column, and hovering the icon shows it too — see [Reprocess a failed document](/how-to-guides/process/reprocess-failed-document.md).

{% hint style="warning" %}
**Wait for a file to appear under** <img src="https://2262431129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlnHu06wl3NH457iwjBmr%2Fuploads%2Fgit-blob-9def91ecd328a1e04b609ef3bef98b17609764eb%2Fview-processed.svg?alt=media" alt="Processed" data-size="line"> **before you run AI analysis on it.** Files still under <img src="https://2262431129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlnHu06wl3NH457iwjBmr%2Fuploads%2Fgit-blob-f3cebd618a2f549a69636754c752d5896e471fd3%2Fview-processing.svg?alt=media" alt="Processing" data-size="line"> are not yet ready for AI analysis.
{% endhint %}

Your documents are now in the matter: each file moves from **Pending** through **Uploading** to **Uploaded** in the upload monitor while you keep working, and once the server has processed it, it appears under <img src="https://2262431129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlnHu06wl3NH457iwjBmr%2Fuploads%2Fgit-blob-9def91ecd328a1e04b609ef3bef98b17609764eb%2Fview-processed.svg?alt=media" alt="Processed" data-size="line"> and is ready for AI analysis.

## Related

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Upload monitor</strong></td><td>Track upload progress, retry failures, and clear finished files.</td><td><a href="/reference/upload-monitor.md">Upload monitor</a></td></tr><tr><td><strong>Supported file formats</strong></td><td>Which file types BriefTech can ingest and process.</td><td><a href="/reference/supported-file-formats.md">Supported file formats</a></td></tr><tr><td><strong>File size and storage limits</strong></td><td>Per-file and per-account upload limits.</td><td><a href="/reference/file-size-and-storage-limits.md">File size and storage limits</a></td></tr><tr><td><strong>Organise documents into folders</strong></td><td>Structure uploaded files once they're in the matter.</td><td><a href="/how-to-guides/organise/organise-documents-into-folders.md">Organise documents into folders</a></td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.brieftech.ai/how-to-guides/upload/upload-documents.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
