> ## Documentation Index
> Fetch the complete documentation index at: https://watermelon.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Files

> Learn how to upload, manage, and test files using the Files source so your AI Agent can use large files as part of its knowledge.

Using **Files** as a source lets you quickly add large, detailed files to your AI Agent’s knowledge without copying content manually. When you upload a file, the system **scans** the text and integrates the information directly into your AI Agent. This helps your Agent answer questions more accurately and reduces the effort needed to maintain your knowledge base.

<Info>
  Files is available in all plans. Limits differ per plan, for more information, check our [Pricing page](/help-center/plans-pricing/pricing-overview).
</Info>

## **Adding Files as a Source**

<Steps>
  <Step title="Open your AI Agent">
    Go to **Agents** in the main menu and select the relevant AI Agent.

    <Frame>
      <img src="https://mintcdn.com/watermelon/rJwaFjhasZdP-MKj/images/features/files/files-menu.png?fit=max&auto=format&n=rJwaFjhasZdP-MKj&q=85&s=19e292bdc6757642b8e0444f9f49aff7" alt="Files Menu" width="2922" height="1390" data-path="images/features/files/files-menu.png" />
    </Frame>
  </Step>

  <Step title="Navigate to Files">
    <Frame>
      <img src="https://mintcdn.com/watermelon/UDqE2p5S3jWG66de/images/navigate-to-files.png?fit=max&auto=format&n=UDqE2p5S3jWG66de&q=85&s=73cbc69b8482eb0cd3b1713e7fcfb0e0" alt="Files Settings" width="2880" height="1460" data-path="images/navigate-to-files.png" />
    </Frame>
  </Step>

  <Step title="Upload a file">
    Upload a .docx, .txt or .pdf file by dragging the document into the box.

    <Warning>
      If you reach the size limit of your Agent, you'll need to remove sources to crawl.
    </Warning>
  </Step>

  <Step title="Crawl Agent">
    Click **Crawl** on the right hand side to add the information of your document to your Agent.

    <Frame>
      <img src="https://mintcdn.com/watermelon/UDqE2p5S3jWG66de/images/crawl-files.png?fit=max&auto=format&n=UDqE2p5S3jWG66de&q=85&s=6e82ac71057014cac2b51c5df0b5a612" alt="Files Synchronize" width="2880" height="1460" data-path="images/crawl-files.png" />
    </Frame>
  </Step>
</Steps>

## **Adding a file**

You can upload any **.docx, .txt, or .pdf** file you want your AI Agent to learn from. Once uploaded, the system immediately **starts scanning** the file and extracting its content.

**Supported details:**

* Maximum file size: **20 MB per file**

During scanning, you’ll see:

* The **scanning status**
* The **last scanned date**

Larger files may take more time to complete.

## **Managing your files**

Each uploaded file includes options for easy management:

* **Edit** — Replace the file with an updated version
* **Download** — Retrieve the stored file
* **Delete** — Remove the file and all scanned knowledge

<Frame>
  <img src="https://mintcdn.com/watermelon/UDqE2p5S3jWG66de/images/manage-files.png?fit=max&auto=format&n=UDqE2p5S3jWG66de&q=85&s=fec2ac12f424ef11ce01278b2f81d30c" alt="Files Options" width="2878" height="1460" data-path="images/manage-files.png" />
</Frame>

<Danger>
  Deleting a **file** **permanently** removes all knowledge the AI Agent learned from that file. The Agent will no longer use information from it.
</Danger>

## **Testing the AI Agent with file knowledge**

After your Agent finishes crawling, open the [**Playground**](/help-center/build-your-agent/test-your-agent) to confirm how your AI Agent uses the content.

Try asking questions directly related to the file to check:

* Whether the Agent **uses the correct information**
* Whether the **sources list** shows your file
* Whether the answers match your **expectations**

<Note>
  If information inside the **file** **conflicts with your Instructions or Personality**, the AI Agent will **always prioritize your written instructions** over scanned content. This ensures consistency, tone, and accuracy based on your settings.
</Note>