What is a file?
A file is anything you’ve uploaded to your business. Each file:- Belongs to your business, optionally inside a folder.
- Has metadata — filename, content type, size, tags, description.
- Has an indexing status that tracks whether it’s searchable yet.
.docx), PowerPoint (.pptx), and OpenDocument text and
presentations (.odt, .odp), plus the images PNG, JPEG, and
WebP — alongside Markdown and other plain-text formats. Spreadsheets
and other formats can still be uploaded and shared via public links — they
aren’t indexed for search.
Folders
Files can be grouped into folders, for two reasons:- Grouping. Keep related files together.
- Agent access control. Each file (and each folder) carries an Agent access flag. Turn the flag off on a folder and your agents will not see anything in it, even if a query would otherwise match. This is how you separate, say, public sales collateral from internal HR documents in the same business.
From upload to searchable
An uploaded file appears in your file list immediately and is indexed for search automatically. Its indexing status walks throughpending → indexing → indexed. If a file can’t be indexed (unsupported
format, too large, or its text couldn’t be read) the status ends in skipped,
excluded, or failed — visible on the file’s detail view so you know it’s
not searchable.
How agents search files
Search matches both meaning and exact terms: an agent finds the right passage whether the question is “what’s the refund policy?” or an exact part number, and the best-matching passages inform its answer. Two guarantees are enforced on every search:- Only content from the agent’s own business is ever returned.
- Files (and folders) with Agent access turned off, files that aren’t fully indexed, and files that have been deleted are excluded.
What it costs
File usage is metered through two of your account’s consumables:- Storage — the total bytes in your file library, counted against your tier’s storage allowance.
- LLM Tokens — indexing a file consumes tokens from the same allowance your agents and automations use.
Related topics
Upload files
How to add files in the web app
RAG indexing
Re-index files, exclude folders, troubleshoot