◬
Get Started

Files & Storage

Magus lets you attach files to conversations so your agents can read and reference them. You can also access files from previous conversations, share files within a folder or workspace, and manage your overall storage from account settings.

Uploading Files

In Chat

The easiest way to upload a file is directly in a conversation:

  • Drag and drop: Drag a file from your desktop into the chat window and drop it anywhere in the message area
  • File picker: Click the attachment icon (paperclip) in the message input area and select a file from your device

The file will be attached to your message. Once the message is sent, the agent can access the file and reference its contents in its response.

Via the Files Tab

For files you want to use across multiple conversations, upload them from the Files tab in an agent’s settings or in the sidebar:

  1. Open the Files tab
  2. Click Upload File
  3. Select your file
  4. Choose a scope (see below)

Files uploaded here are available immediately and persist beyond any single conversation.

File Scopes

Every file has a scope that controls who can access it and in which conversations.

Scope Who can access it
Chat Only the current conversation
Folder All conversations inside the same folder
Workspace All members of your workspace (team access)
Global All your conversations, across all agents

Choose the right scope based on how broadly you need the file to be available. For sensitive documents, Chat scope keeps the file isolated to one conversation. For reference material your whole team uses, Workspace scope makes it available everywhere.

Downloading Files

To download a file:

  • In a conversation, click the file attachment to expand it, then click the Download button
  • In the Files tab, find the file and click the Download icon next to it

Agent-generated files (such as images generated by an image model or outputs from code execution) appear in the conversation and can be downloaded the same way.

Supported File Types

Magus can extract text from a wide range of file formats:

  • Documents: PDF, Word (.doc, .docx), RTF, EPUB, OpenDocument (.odt)
  • Spreadsheets: Excel (.xls, .xlsx), CSV, OpenDocument (.ods)
  • Presentations: PowerPoint (.ppt, .pptx)
  • Images: JPEG, PNG, GIF, WebP, TIFF, BMP, SVG (text extraction via OCR)
  • Web and data formats: HTML, XML, JSON, YAML, Markdown
  • Plain text: .txt and other text-based files

Large files are processed in chunks for semantic search. After uploading, there may be a brief processing period before the file is fully available to your agent.

Storage Limits

Your available storage depends on your subscription plan:

  • Free plan: Limited storage included
  • Paid plans: More storage, with higher per-file upload limits

You can see your current storage usage in Account Settings under Storage. The display shows how much you’ve used and how much your plan allows.

If you reach your storage limit, you’ll need to delete files or upgrade your plan before uploading more.

Managing Storage

Viewing Storage Usage

Go to Account Settings and look for the Storage section. You’ll see a breakdown of how much space your files are using.

Deleting Files to Free Up Space

To delete a file:

  1. Open the Files tab in your agent settings or the sidebar
  2. Find the file you want to remove
  3. Click the Delete icon (trash can) next to it
  4. Confirm the deletion

Deleting a file removes it permanently and frees up the storage it used. If the file was attached to existing messages, those messages will note that the attachment is no longer available.

Workspace Files

If you’re on a team workspace, files with Workspace scope are shared among all members. Only the person who uploaded a file (or a workspace admin) can delete it.

File Processing Status

After uploading, files go through a processing step where Magus extracts text, creates chunks for semantic search, and stores the content. You can see the file’s status in the Files tab:

  • Pending: Upload received, processing hasn’t started yet
  • Processing: Being indexed for semantic search
  • Ready: Fully available to your agent
  • Error: Processing failed. Try deleting and re-uploading the file.