Skip to main content
Your business’s agent does better work when it starts from your real material: a brand kit, a pricing PDF, a CSV of leads, a folder of reference docs. The Files tab on your business dashboard (left rail, under System) is where you drop off that material so your agent can read it. Files are shared between you and your agent. You upload material for it to work from, and your agent keeps its own files there too: print-ready artwork, full-size renders, archives, drafts, data exports, anything too big or too bulky for your website’s code. Everything shows up in the Files tab. Your website’s code stays in its code repository, as always.
Files are not the same as Documents. Documents are notes your agent writes and maintains (mission, playbooks, knowledge bases), and they are listed in their own DOCUMENTS panel at the top of the Files tab. Files are the material you and your agent keep: what you provide, and what your agent makes that does not belong in your website’s code.

What you can upload

Almost anything your agent might need to read:
  • Brand assets: logos, fonts, color references, image libraries.
  • Documents: PDFs, slide decks, spreadsheets, CSVs, Markdown, plain text.
  • Folders: drop a whole folder and its structure is kept.
When you upload a folder, common junk (node_modules, .git, __pycache__, .venv, .DS_Store) is skipped for you.

Upload files

1

Open the Files tab

On your business dashboard, click Files in the left rail. The top of the tab is a large drop zone.
2

Add files or a folder

Drag files or folders onto the drop zone, or click Browse files or Or a folder.
3

Wait for the upload to finish

Files upload a few at a time. Each one shows a row with its status, then Uploaded with its size. Larger files take longer.
Each uploaded file appears in the FILES panel with its path and size. The panel header shows how many files you have and their total size, for example 47 · 213 MB. Uploading to a path that already exists replaces the previous file.

Attach files in the chat

You can also attach files straight from the chat with your agent. Click + in the message box, paste a file, or drop files anywhere on the chat column, then send your message. You can attach up to 10 files per message. Files attached this way are saved to your business’s files automatically and show up in the Files tab, exactly as if you had uploaded them there. Your agent can use them again later.

How your agent uses your files

Your files stay in your business’s file store. Your agent does not copy them all into its workspace: at the start of each turn it gets a short summary of what you have (how many files, the main folders, what is new since its last turn), and it downloads the files it needs when it needs them. So you can ask things like:
  • “Use the logo in brand/logo-dark.svg on the new landing page.”
  • “Summarize the contract in legal/agreement.pdf and email me the key terms.”
  • “Clean up data/leads.csv and load it into our database.”
When your agent edits a file it fetched, it works on its own copy. Your original changes only if the agent saves a new version back to the same path.

Files your agent makes

Your website’s code keeps only what the site needs: code, settings, and web images of at most 5 MB. Everything else your agent makes goes to Files: print masters, full-size renders, zip archives, design source files (.psd, .ai, .fig), TIFF images, drafts, datasets, and anything over 5 MB. That keeps your website quick to update and your agent quick to start. Your agent can also rename, move and delete files to keep them organized. Ask it whenever you want a file removed or your files tidied up.

Files you attach to a message

Files you attach to a chat message are ready for your agent before it reads that message. They are named alongside your message, and the agent reads them before acting on it. You can send files without typing anything: the agent reads them and works out what to do. If your agent is busy when you send, your message and its files wait in line and go out with its next turn. Uploading a file alone does not send anything or interrupt your agent: it only reaches the agent when you press send. If a file you attached is deleted, or cannot be fetched, before your agent starts on your message, the turn stops and the chat names the file it could not attach. Attach it again and resend.

When new uploads become visible

Right away. Because your agent looks up your files when it needs them, a file you upload mid-conversation is available on its next look. Just mention it, or attach it to your message.
Your agent’s start time does not depend on how many files you store. Only files attached to the message it is answering are fetched before it starts, so a very large attachment can still take a moment.

Download a file

Click a file’s row in the FILES panel to download it. This is handy for checking exactly what your agent received, or for sharing with support if an agent misread something. Downloads are one file at a time; there’s no folder download yet.

Delete files

The Files tab has no delete button. To remove a file, ask your agent in the chat: it can delete, rename or move any file for you. Uploading a file to the same path replaces the old one.

Limits

These limits apply on every plan, including free. There is no plan gating on file uploads. The per-file cap leaves out raw video by design; for very large media, link to it from a document instead. Files belong to one business. If several businesses need the same material, upload it to each of them.

Privacy and security

  • Your files are stored privately and are never served on a public URL.
  • Downloads work only for people who can access your conglomerate, through a short-lived, signed link. When an agent fetches a file on demand it gets the same kind of short-lived link, and only for files belonging to the business it is working on.
  • Your agent runs in an isolated sandbox and only ever reaches your business’s files, never another business’s.
  • Your business’s agent can add, rename and delete files in your business’s store, and nobody outside your account can.

Troubleshooting

  • An upload failed: the row for the file shows the reason and a Try again link. The usual causes are a file over 200 MB (it is refused before upload) or hitting your business’s storage quota.
  • Something didn’t upload from a folder: common junk folders like node_modules are skipped on purpose.
Still stuck? Open the in-app Support chat, or email support@nanocorp.so.