File Uploads

← Back to Documentation Index

Sources can have file attachments — uploaded documents, images, or text files that provide the raw evidence backing your claims.

Supported File Types

The system accepts most common file types:

• Documents: PDF, DOCX, TXT, RTF
• Images: PNG, JPEG, GIF, WebP
• Data: CSV, JSON, XML
• Archives: ZIP (contents are extracted)
• Media: MP4, MP3, WAV

Maximum individual file size is determined by the server configuration. Contact your administrator for the current limit.

Uploading Files to a Source

From the Source Detail Page

1. Navigate to the source's detail page (/sources/[sourceId]).
2. Scroll to the Source Files section.
3. You will see the File Upload Zone:

Drag and drop:

1. Drag one or more files from your file system.
2. Drop them onto the upload zone (the dashed border area).
3. A progress bar appears for each file being uploaded.
4. When complete, the file appears in the file list below.

Click to browse:

1. Click the upload zone (or the browse button within it).
2. Select one or more files from the file picker dialog.
3. Progress bars appear during upload.
4. Files appear in the list when complete.

What you'll see: The upload zone displays a dashed border with an upload icon and "Drop files here or click to browse" text. During upload, each file shows a progress bar. Completed uploads appear as file rows with download links.

Upload Validation

• If a file exceeds the size limit, the upload is rejected with an error message.
• If a file with the same checksum already exists in your account, the upload is blocked to prevent duplicates (checksum deduplication).
• If the upload fails due to a network error, a toast notification appears with the error details.

The File List

Below the upload zone, the Source Files panel lists all files attached to this source.

Each file row shows:

• File icon — based on the file type
• Filename — the original filename
• File size — formatted (KB, MB)
• Upload date — when the file was added
• Download button — click to download the file

Click Download to retrieve the file to your local system.

Checksum Deduplication

Every uploaded file is hashed (SHA-256) on the server. Before accepting a new upload, the system checks whether a file with the same checksum already exists in your account.

If a match is found:

• The upload is rejected.
• A toast notification: "This file has already been uploaded."
• This prevents storing duplicate copies of the same file across multiple sources.

The checksum is also visible on the source detail page (under the metadata cards) for integrity verification. Anyone with access to the source can verify that a downloaded file matches the checksum recorded at upload time.

Storage Quota

Each account has a 1 GB storage quota for file uploads. The quota is enforced at the account level — all users in the account share the same quota.

If the quota is exceeded:

• New uploads are rejected.
• A toast notification: "Storage quota exceeded. Please free up space or contact your administrator."

To manage quota:

• Delete unneeded files from sources.
• The quota usage is tracked server-side. Contact your administrator for a current usage report.

Read-Only Sources

Sources that are part of demo/sample datasets (marked with the amber "sample" badge) do not support file uploads. The upload zone is replaced with a message:

"File uploads are not available for sample records."

File Security

• Uploaded files are stored server-side, not in the browser.
• Files are served through authenticated download endpoints — only users with access to the source can download its files.
• Download URLs are proxied through the backend and are not directly exposed to the client.

Next: Search and Export →