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

# File Upload Monitoring

> Syteca File Upload Monitoring: detect when users upload files to web services, cloud drives, or external destinations from Windows and macOS Clients - log path, filename, extension, and destination URL.

## See what's leaving the endpoint, before it's gone

The most common way sensitive data leaves an organization isn't email anymore - it's a file dragged into Google Drive, uploaded to a personal Dropbox, attached to a Slack message, or pushed to a code repository the security team doesn't know about. Most monitoring tools catch this only in retrospect, by reviewing screen captures after the fact. Dedicated endpoint DLP products catch it in real time - at the cost of a parallel agent on every endpoint, a parallel policy engine, and a parallel set of alerts.

**Syteca File Upload Monitoring** sits between the two. The Syteca Client you've already deployed for session recording also watches for file upload operations - the process performing the upload, the path of the file, its name, its extension, and (for browser-based uploads) the destination URL. Every upload is logged on the **File Upload Monitoring** tab, and you can configure [alerts](/docs/session-monitoring/alerts) to notify, warn, or block when uploads match defined patterns. No second agent.

<Info>
  **Use File Upload Monitoring when you need to:**

  * Detect **data exfiltration via web uploads** - files going to personal cloud drives, file-sharing sites, code repositories, or social platforms.
  * Track **shadow IT usage** - what unsanctioned cloud services your users are actually uploading work files to.
  * Satisfy **PCI DSS data movement controls**, **HIPAA file disclosure tracking**, **ISO 27001 incident detection**, or **SOC 2 data handling evidence** by recording every upload event.
  * **Alert and block** in real time on high-risk uploads (large files, restricted file types, sensitive paths) without deploying an endpoint DLP product alongside Syteca.
  * **Investigate insider threats** by reconstructing what files an employee uploaded and where, alongside the session video that captured the act.

  **Pair it with [Alerts](/docs/session-monitoring/alerts)** - File Upload Monitoring tells you *what* uploaded; alerts tell you *when to care*. Together they cover detection + notification + (optional) automatic blocking.
</Info>

<Warning>
  Currently supported on **Windows** and **macOS** Clients only. Not supported on Linux Clients.
</Warning>

<Note>
  Viewing the File Upload Monitoring tab requires the [administrative Viewing Monitoring Results permission](/docs/administration/users/administrative-permissions).
</Note>

## Enable file upload monitoring

File upload monitoring is enabled per Client (or per Client group) on the **File Monitoring Parameters** tab when editing a Client.

<Tabs>
  <Tab title="Windows">
    Open the **Editing Client** (or **Editing Client Group**) page → **Monitoring \[Windows]** tab → **File Monitoring Parameters** section → select **Enable file upload monitoring**.
  </Tab>

  <Tab title="macOS">
    Open the **Editing Client** (or **Editing Client Group**) page → **Monitoring \[macOS]** tab → **File Monitoring Parameters** section → select **Enable file upload monitoring**.
  </Tab>
</Tabs>

Once enabled, every file upload operation is recorded - both the events in the session recording itself (Metadata grid) and the aggregated grid on the File Upload Monitoring tab.

## The File Upload Monitoring tab

<Frame caption="The File Upload Monitoring tab - every file upload detected on Windows and macOS Clients, with the destination URL captured for browser-based uploads.">
  <img src="https://mintcdn.com/syteca/FKrkO8bEqEQ6WSgs/images/session-monitoring/file-upload-monitoring-tab.png?fit=max&auto=format&n=FKrkO8bEqEQ6WSgs&q=85&s=5c3c33dffa64dab4a05515a5cb1fec0d" alt="File Upload Monitoring tab grid showing upload events with Process Name, Path, File Name, File Extension, and Details (destination URL) columns" width="1497" height="654" data-path="images/session-monitoring/file-upload-monitoring-tab.png" />
</Frame>

Open the Management Tool, click **Activity Monitoring**, then select the **File Upload Monitoring** tab.

### The grid

| Column             | Shows                                                                                                                                                          |
| ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Play** *(icon)*  | Open the corresponding session in the [Session Viewer](/docs/session-monitoring/player/overview), paused at the exact moment of the upload.                         |
| **Risk Level**     | If any alerts triggered in the session - the **highest-risk** alert determines the icon color. **Red** for Critical, **orange** for High, **blue** for Normal. |
| **Time**           | Date and time when the upload was detected.                                                                                                                    |
| **User Name**      | The user logged into the Client when the upload happened.                                                                                                      |
| **Client Name**    | The Client computer where the upload happened.                                                                                                                 |
| **Process Name**   | The application that uploaded the file (browser, FTP client, custom application).                                                                              |
| **Path**           | Where the file lived on the Client computer before upload.                                                                                                     |
| **File Name**      | Name of the uploaded file.                                                                                                                                     |
| **File Extension** | File extension (`.docx`, `.csv`, `.zip`, etc.).                                                                                                                |
| **Details**        | The destination URL - *only available for browser-based uploads*.                                                                                              |

<Note>
  In Multi-Tenant mode, users only see file upload operations from Clients in their own tenant.
</Note>

### Filter, search, and sort

| Action     | How                                                                                                                     |
| ---------- | ----------------------------------------------------------------------------------------------------------------------- |
| **Filter** | Click **When**, **Who**, **Where** at the top, or **More criteria** for additional filtering. Multiple filters combine. |
| **Search** | Enter a keyword in the **Search** box.                                                                                  |
| **Sort**   | Click any column header. The sort arrow indicates direction; click again to reverse.                                    |

## Alert on file uploads

File Upload Monitoring data is most powerful when paired with alerts. Configure a **File Upload alert** (on the [Alerts page](/docs/session-monitoring/alerts)) to trigger when a file upload matches your criteria - for example, any `.zip` upload, any upload from a payroll user, any upload to a non-corporate domain. When the alert triggers, you can:

A new Alert Rule can now be created using the with **File upload** parameter, which allows the uploading of files to specific URLs to be detected and prevented, and works with the following applications:

* **Line messenger** (desktop and web versions)
* **Mozilla Firefox**
* **Google Chrome**
* **Opera**
* **Internet Explorer**
* **Microsoft Edge**

| Response                                                                | Effect                                                                                                                                       |
| ----------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| **Send email notifications**                                            | Notify the security team in real time.                                                                                                       |
| **Show pop-up warning** *(Windows only, via Syteca Tray Notifications)* | Notify the user on the endpoint.                                                                                                             |
| **Show on-screen warning message**                                      | Display a custom message on the Client's screen.                                                                                             |
| **Block the user** *(via Additional Actions)*                           | Automatically [block the user](/docs/session-monitoring/block-on-alert#block-automatically-when-an-alert-triggers) on the current or all Clients. |

## Related

<CardGroup cols={2}>
  <Card title="Alerts" icon="bell" href="/docs/session-monitoring/alerts">
    Define and assign File Upload alerts to specific Clients.
  </Card>

  <Card title="Block on alert" icon="ban" href="/docs/session-monitoring/block-on-alert">
    Automatically block users when a File Upload alert triggers.
  </Card>

  <Card title="USB Devices" icon="usb" href="/docs/session-monitoring/usb-devices/overview">
    The complementary capability for the physical data-exfiltration channel.
  </Card>

  <Card title="Sensitive Data Masking" icon="shield-off" href="/docs/session-monitoring/masking/sensitive-data">
    Mask sensitive data on screen - different problem, related compliance story.
  </Card>
</CardGroup>
