Uploading Files

Uploads let you bring external files into your workspace — images, PDFs, spreadsheets, code, audio, video, and more. Saltare automatically categorizes each file, extracts searchable text when possible, and makes every upload available to AI agents.

Uploading Files

Drag and Drop

Drag files anywhere onto a folder page in the data tree. Saltare creates the upload inside that folder automatically.

File Picker

Click New > Upload from any folder's HUD bar, then select one or more files from your computer.

From Chat

Ask an agent to work with a file you've already uploaded:

@Assistant summarize the PDF I uploaded called "Q2 Report"

Supported File Types

Uploads are automatically categorized by content type:

Category	Examples
Image	PNG, JPEG, GIF, WebP, SVG, AVIF
PDF	PDF documents
Spreadsheet	CSV, TSV, Excel (.xlsx, .xls)
Video	MP4, WebM, QuickTime
Audio	MP3, WAV, OGG, AAC, FLAC
Text / Code	Plain text, Markdown, HTML, CSS, JavaScript, JSON, XML, YAML
Archive	ZIP, GZIP, TAR, 7z, RAR
Design	Photoshop (PSD), PostScript
Office Document	Word (.docx, .doc), OpenDocument Text
Presentation	PowerPoint (.pptx, .ppt), OpenDocument Presentation

Each category gets a type-specific viewer — images render inline, PDFs display with a document viewer, code files show syntax-highlighted previews, audio and video have playback controls.

Automatic Processing

When you upload a file, two things happen in the background:

Categorization

Saltare detects the file's content type and assigns a category (image, PDF, spreadsheet, etc.). This powers the type-specific viewer and determines what operations are available.

Text Extraction

For PDFs, spreadsheets, and text-based files, Saltare extracts the text content automatically. Extracted text is:
- Indexed for search — find uploads by their content, not just their filename
- Available to agents — agents can read and analyze the extracted text without downloading the file

CSV-to-Database Conversion

Spreadsheet uploads (CSV, TSV, Excel) can be converted into a full Saltare database with one click:

1. Open the upload in the data tree
2. Click Convert to Database
3. Saltare infers the column schema automatically — detecting text, numbers, dates, and booleans
4. Rows are imported in the background

The new database appears in the same folder as the original upload. Column names come from the CSV header row, and types are inferred from the data. Once imported, you can query the data with natural language, have agents analyze it, and add new rows manually or via agents.

This is especially useful for:
- Importing vendor lists, contact databases, or inventory sheets
- Converting exported data from other tools into queryable databases
- Bulk-loading research data for agent analysis

Embedding Uploads

Reference uploads in documents, messages, and task descriptions using embed syntax:

Inline Embed

Check the latest mockups [[upload:homepage-redesign-v3]]

Renders as a compact chip with the upload's icon and title.

Block Embed

![[upload:q2-financial-report]]

Renders as a rich card showing the file type, size, and a download link.

The embed autocomplete picker ([[) suggests matching uploads as you type.

Searching Uploads

Uploads are searchable from the command palette (Cmd+K) and from full-page search. Search matches against:
- Upload title
- Original filename
- Extracted text content (for PDFs, spreadsheets, and text files)

Agents can also search uploads using their built-in tools:

@Assistant find all uploads related to "brand guidelines"

AI Agent Tools

Agents have two upload-specific tools:

• get_upload — Retrieve an upload's metadata, extracted text, and file details
• search_uploads — Search across all uploads by title, filename, or extracted content

These tools let agents reference and analyze uploaded files as part of any workflow:

@Analyst review the uploaded "Competitor Pricing.csv" 
and compare it against our current pricing in the Pricing database

Storage Quotas

Each plan includes a storage allowance:

	Starter	Pro	Business	Enterprise
Storage	100 MB	5 GB	50 GB	500 GB
Max file size	5 MB	100 MB	500 MB	2 GB
Upload limit	5 files	Unlimited	Unlimited	Unlimited

Your current storage usage is visible in Settings > Billing. When you approach your quota, you'll see a warning. Deleting uploads frees up storage immediately.

Tips

• Use descriptive titles — Rename uploads to something meaningful so agents and search can find them easily
• Convert CSVs early — If you plan to query the data, convert spreadsheets to databases right away rather than referencing the raw file
• Embed in documents — Use [[upload:slug]] to create a single document that references all related files for a project
• Let agents extract insights — Agents can read extracted text from PDFs and text files, so ask them to summarize, compare, or analyze uploaded content