> ## Documentation Index
> Fetch the complete documentation index at: https://docs.layest.com/llms.txt
> Use this file to discover all available pages before exploring further.
# File Management: Upload and Manage Files in Layest
> Upload, organize, and share files within Layest. Attach files to objects, use them as agent knowledge sources, or share them in AI assistant conversations.
File management in Layest covers everything related to uploading, organizing, and using files across your workspace. Files can serve several purposes: they can be attached to data objects as structured records, ingested as knowledge sources that ground your agents in specific documents, or shared directly in AI assistant conversations to provide in-context reference material. Understanding how files flow through Layest helps you design agents that work with real-world documents, spreadsheets, images, and more.
## Uploading Files
You can upload files from the dedicated **Files** section in the Layest sidebar. This central file library stores all files that have been uploaded directly — separate from files attached to data objects, which are managed within the object's detail panel.
**To upload a file:**
In the left sidebar, click **Data → Files**. You will see your file library with any previously uploaded files.
Click the **Upload** button in the top-right corner, or drag and drop files directly onto the file library view.
Choose one or more files from your local filesystem. You can upload multiple files in a single operation.
Layest uploads and processes the file. Text-based files are indexed for search and made available to agents as knowledge. A progress indicator shows upload and indexing status.
Once uploaded, drag the file into a folder or right-click and select **Move to Folder** to keep your library organized.
## Supported File Types and Size Limits
Layest accepts a broad range of common file formats. Support varies slightly depending on how you intend to use the file.
| Category | Supported Formats |
| ------------- | ------------------------------------------------------ |
| Documents | PDF, DOCX, DOC, TXT, MD, RTF |
| Spreadsheets | XLSX, XLS, CSV |
| Presentations | PPTX, PPT |
| Images | PNG, JPG, JPEG, GIF, WEBP, SVG |
| Code | JSON, YAML, XML, HTML, and most common code extensions |
**Size limits per file:**
* Standard plans: up to **25 MB** per file
* Growth and Enterprise plans: up to **100 MB** per file
Files that exceed the size limit for your plan are rejected at upload time with a clear error message. If you need to work with larger files, contact support to discuss Enterprise options.
## Attaching Files to Data Objects
Files can be attached directly to objects in a data collection using a **File** attribute. This associates a specific document, image, or resource with a structured record — for example, attaching a signed contract PDF to a `Deal` object or a profile photo to a `Contact` object.
**To attach a file to an object:**
1. Open the object's detail panel in any collection.
2. Locate the File attribute field (your collection must have a File-type attribute configured — see [Attributes](/data/attributes)).
3. Click **Attach File** and either select a file already in your library or upload a new one.
4. Click **Save** to confirm the attachment.
Agents with write access to the collection can also attach files to objects during their workflows when given the appropriate instructions. Agents reference attached files by the file's name or the object's attribute value.
## Using Files as Knowledge Sources for Agents
One of the most powerful uses of files in Layest is as knowledge sources for agents. When you add a file as a knowledge source, the agent can search and cite the document's contents when answering questions or completing tasks.
**To add a file as an agent knowledge source:**
1. Open the agent you want to configure in **Agents**.
2. Click the **Knowledge** tab.
3. Click **Add Source → File**.
4. Select one or more files from your library, or upload new files directly from this dialog.
5. Click **Add to Knowledge**. Layest indexes the file contents and makes them available to the agent at runtime.
Once a file is indexed as a knowledge source, the agent can quote from it, summarize it, and answer questions about its contents. The agent cites the file name in its responses so you can trace the source of any information.
## Sharing Files in AI Assistant Conversations
You can share files directly in any AI assistant conversation in Layest to give the assistant immediate, in-context access to a document.
* Click the **Attach** icon (paperclip) in the conversation input bar.
* Select a file from your library or upload a new one.
* Send your message. The assistant reads the file contents and uses them to inform its response.
Files shared in conversations are scoped to that conversation — they do not automatically become part of an agent's persistent knowledge base. To make a file permanently available to an agent, add it as a knowledge source through the **Knowledge** tab instead.
## Organizing Files in Folders
As your file library grows, folders help you keep everything navigable. Create as many folders and sub-folders as you need to mirror your team's structure — for example, organizing by project, client, or document type.
**To create a folder:**
* Click **New Folder** in the Files section toolbar.
* Enter a name and click **Create**.
**To move files into a folder:**
* Drag and drop files onto the folder, or
* Select one or more files (hold Shift or Cmd/Ctrl to multi-select), right-click, and choose **Move to Folder**.
**To rename or delete a folder:**
* Right-click the folder and select **Rename** or **Delete**. Deleting a folder moves all files inside it to the root of the file library — it does not delete the files themselves.
File storage limits vary by plan. Free workspaces include 500 MB of total file storage. Starter plans include 5 GB, Growth plans include 50 GB, and Enterprise plans offer custom storage quotas. When you approach your limit, Layest displays a warning banner in the Files section. You can free up space by deleting unused files or upgrade your plan to increase your quota.