# Upload and Process Documents

### Overview

This guide walks you through uploading documents to Docspire, processing them with AI extraction, and viewing the results. You can upload single or multiple documents and process them individually or in batches.

### Supported File Formats

Docspire accepts the following file formats:

•       PDF

•       Text (TXT, RTF)

•       Excel (XLS, XLSX)

•       CSV

•       Images (JPG, PNG)

•       Word (Docx)

•       EDI

### Step 1: Upload Documents

<figure><img src="https://3990462849-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fgjpo1gyiI3QKDSNO9maQ%2Fuploads%2FEivOXL0w7N9nsXunxNgw%2F10%20-%20Upload.gif?alt=media&#x26;token=1e045b05-4c12-46f5-9f14-2842c4df8a1b" alt=""><figcaption></figcaption></figure>

1\.    From the Home dashboard, click Upload Documents. The Upload Documents dialog opens.

2\.    (Optional) Enter a Business ID to tag documents with your internal reference (e.g., PROJECT-123).

3\.    (Optional) Select a Document Type from the dropdown. If left empty, Docspire will auto-detect the document type.

![](https://3990462849-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fgjpo1gyiI3QKDSNO9maQ%2Fuploads%2FNYDjT2m7KJzAjpOymqKH%2F11%20-%20Upload%20Options.png?alt=media\&token=bb41bd9b-2fda-480f-8cc2-d934d583427c)&#x20;

4\.    Click or drag files into the upload area, or click to browse your computer.

Selected files appear below the upload area with a count (e.g., "2 file(s) selected").

<figure><img src="https://3990462849-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fgjpo1gyiI3QKDSNO9maQ%2Fuploads%2FJAo5JPBfL6DsxYDGeyhO%2F12%20-%20attach%20documents.png?alt=media&#x26;token=31853401-6320-48ea-bd3f-a0f418d63f36" alt=""><figcaption></figcaption></figure>

5\.    Click Upload Documents to upload the files. You will be redirected to the Document Queue screen.

### Step 2: View in Document Queue

After uploading, your documents appear in the Document Queue with a Pending status.

6\.    Locate your uploaded documents in the list. Latest ones appear on top. Manually uploaded files show "Manual Upload" as the Source.

<figure><img src="https://3990462849-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fgjpo1gyiI3QKDSNO9maQ%2Fuploads%2FOcMNyAONgkxyxKO7xQaI%2F13-%20shown%20in%20document%20queue.png?alt=media&#x26;token=42721ce6-4bf7-43e0-a00d-601984955a47" alt=""><figcaption></figcaption></figure>

### Step 3: Process the Document

7\.    In the Document Queue, locate the document you want to process.

8\.    Click the Process button in the Actions column.

<figure><img src="https://3990462849-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fgjpo1gyiI3QKDSNO9maQ%2Fuploads%2FbDYqEgc9wgmuOAla6QE3%2F14%20-%20Process%20Button.png?alt=media&#x26;token=15fddc00-0a87-47c1-bfae-56e95728921d" alt=""><figcaption></figcaption></figure>

The status changes to Running while Docspire extracts data from your document, and you are redirected to Document Tracking screen.

<figure><img src="https://3990462849-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fgjpo1gyiI3QKDSNO9maQ%2Fuploads%2FoMjcKC8W8DgNITcpEeIo%2Fimage.png?alt=media&#x26;token=4c6a0b4d-05be-4d67-a38e-5ca19c1f0eb3" alt=""><figcaption></figcaption></figure>

### Step 4: Track Processing

You can monitor document processing in real-time.\
An info panel in the top-right corner shows "Processing Document" while extraction is in progress.

<figure><img src="https://3990462849-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fgjpo1gyiI3QKDSNO9maQ%2Fuploads%2FxEZcRQeIe71yMRNMTfV9%2F15%20-%20Process%20begins.png?alt=media&#x26;token=0ffbcb70-3f4e-4c53-87b3-f124e00a73c8" alt=""><figcaption></figcaption></figure>

The tracking view displays:

•       Fields Extracted – Number of fields successfully extracted

•       Validations Passed – Number of validation rules passed

•       Validations Failed – Number of validation rules that failed

•       AI Extraction Accuracy – Confidence percentage for extracted data

### Step 5: View Results

Once processing completes, the document status changes to Success.

9\.    In the Document Queue, click View Results for the processed document.

<figure><img src="https://3990462849-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fgjpo1gyiI3QKDSNO9maQ%2Fuploads%2FaxEPpE4Zph6iY6O2XRPj%2Fimage.png?alt=media&#x26;token=1ee6deab-d5fd-4a49-9220-0d09a70d0cd1" alt=""><figcaption></figcaption></figure>

The Results view opens, showing the original document alongside the extracted data.

#### Refined View

The default Refined View displays extracted data in a structured format:

•       Header fields appear at the top (e.g., Total Volume, Total Gross Weight, Loading Port)

•       Table data appears in a structured grid with columns matching the source document

•       The original document is displayed on the left for side-by-side comparison

<figure><img src="https://3990462849-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fgjpo1gyiI3QKDSNO9maQ%2Fuploads%2FuTrBhZmSYrNnERujvvPy%2F17%20-%20View%20Results.png?alt=media&#x26;token=cb04cd10-2473-4555-b2d3-cfdc5daed5f1" alt=""><figcaption></figcaption></figure>

#### JSON View

10. Click JSON View to see the extracted data in JSON format. This is useful for:

•       Reviewing the exact data structure

•       Copying data for use in other applications

•       Verifying field names for API integration

<figure><img src="https://3990462849-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fgjpo1gyiI3QKDSNO9maQ%2Fuploads%2FNjNeNgCn8Zcx1dek3qP1%2F18%20-%20Json%20View.png?alt=media&#x26;token=61f6165e-31dc-4945-8a7e-0a7869af2e23" alt=""><figcaption></figcaption></figure>

### Step 6: Download Results

Export extracted data in your preferred format:

11\.    Click the Download as JSON dropdown in the top-right corner.

<figure><img src="https://3990462849-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fgjpo1gyiI3QKDSNO9maQ%2Fuploads%2FhfX3O9bB6SntXonWqVEW%2F19%20-%20Download%20Output.png?alt=media&#x26;token=4b6ecc3e-bdb6-4d20-b2a3-48e4e23ad9b8" alt=""><figcaption></figcaption></figure>

12\.    Select your preferred format:

<table data-header-hidden><thead><tr><th valign="top"></th><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Format</td><td valign="top">Description</td></tr><tr><td valign="top">JSON</td><td valign="top">Structured data format for API integration and development</td></tr><tr><td valign="top">CSV</td><td valign="top">Comma-separated values for spreadsheet applications</td></tr><tr><td valign="top">Excel</td><td valign="top">Microsoft Excel format with formatted columns</td></tr></tbody></table>

The file downloads to your computer.

### Document Statuses

<table data-header-hidden><thead><tr><th valign="top"></th><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Status</td><td valign="top">Description</td></tr><tr><td valign="top">Pending</td><td valign="top">Document is uploaded and waiting to be processed</td></tr><tr><td valign="top">Running</td><td valign="top">AI extraction is in progress</td></tr><tr><td valign="top">Success</td><td valign="top">Processing completed successfully</td></tr><tr><td valign="top">In Review</td><td valign="top">Document requires human review (validation failed or low confidence)</td></tr><tr><td valign="top">Error</td><td valign="top">Processing failed due to an issue with the document</td></tr></tbody></table>

### Available Actions

Depending on document status, the following actions are available in the Document Queue:

<table data-header-hidden><thead><tr><th valign="top"></th><th valign="top"></th><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Action</td><td valign="top">When Available</td><td valign="top">Description</td></tr><tr><td valign="top">Process</td><td valign="top">Pending</td><td valign="top">Start AI extraction on the document</td></tr><tr><td valign="top">Track</td><td valign="top">Running, Success</td><td valign="top">View detailed processing status and metrics</td></tr><tr><td valign="top">View Results</td><td valign="top">Success, In Review</td><td valign="top">See extracted data alongside the original document</td></tr><tr><td valign="top">Reprocess</td><td valign="top">Success, In Review</td><td valign="top">Run extraction again with optional feedback</td></tr></tbody></table>

### Tips for Best Results

•       Use clear, high-quality scans – Better image quality improves extraction accuracy.

•       Specify document type when known – Selecting the correct type helps the AI extract the right fields.

•       Use Business IDs for tracking – Tag documents with your internal reference numbers for easier searching.

•       Process sample documents first – Test with a few documents before bulk processing.

•       Review accuracy scores – Documents with lower accuracy may need manual review.

### Related Features

**Document Configuration** – Customize extraction fields for your document types.

**Validation Rules** – Set up automatic data quality checks.

**Integrations** – Connect email or webhooks for automated document ingestion.

**Human Review** – Review and correct documents flagged for attention.
