---
title: "Files in Pigment | Pigment"
slug: "files-in-pigment"
description: "Learn how to store and manage files in Pigment Applications, control file access with permissions, and monitor file storage usage across your Workspace."
updated: 2026-10-22T10:48:08Z
published: 2026-10-22T10:48:08Z
canonical: "kb.pigment.com/files-in-pigment"
---

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

# Files in Pigment

Files let you store and manage documents directly within an Application. Depending on your permissions, you can upload, view, download, rename, and delete files.

This article explains how Members can work with files and send them to AI Chats.

## Before you begin

### Access and Permissions

- Workspace Admins and those with the [Manage files permission](/v1/docs/roles-permissions-access-rights#permissions) can upload and manage files. For more information, see [Manage Files in an Application](/v1/docs/manage-files-in-an-application).
- Members need the [Read files permission](/v1/docs/roles-permissions-access-rights#permissions) to view and download files and share them with AI Chats.

## Work with files

With **Read files** permission you can view and download files as follows:

1. In your Application, select **Files** in the left sidebar above your Application name.
2. In the panel that opens, you can view all the files uploaded to this Workspace, grouped by Application.
3. To download a file, hover over it, and select **Download** from the three-dot menu that appears.

With **Manage files** permission you can also:

- Upload files from here. Select **+ Upload new files** at the bottom of the panel.
- Perform the following additional tasks on files in step 3 of the above flow:
  - Rename
  - Delete

The panel shows all the files uploaded to the current Workspace. However, you may have **Read files** permission in some Applications in your Workspace, and **Manage files** permission in others. As a result, the ability to view or manage files as described above varies according to your permissions in each Application.

## Use files in AI Chats

You can choose to allow Pigment Agents to read from everything you store in Files, and you can send files to AI Chats individually. Files must meet the criteria for files attached to AI Chats. For more information, see [Attach files to AI Chats](/v1/docs/upload-files-to-the-agents#file-types-and-upload-constraints).

### Allow Agents general access to Files

The files you store in Files can be made visible to the Agents, so long as they pass the [automatic security check](/v1/docs/upload-files-to-the-agents#malicious-file-checking) and comply with the [other criteria](/v1/docs/upload-files-to-the-agents#file-types-and-upload-constraints). Any file that does not meet the criteria appears in Files but is not able to be read by the Agent. You can ask it to list and give context on files that it cannot read.

To allow Agents general read access to Files (requires [Security Admin or Primary Owner account types](/v1/docs/manage-member-accounts-pigment)):

1. In your Application, open Settings, the three-dot menu at the bottom of the left sidebar.
2. Select **Security**.
3. Under **AI data access**, select **Activate** by **Enable AI Agents access to Application Files**.
4. Select **Activate** in the confirmation pop-up that follows (see **Important** note below).

> [!WARNING]
> ⚠️ Important
> 
> - This action is permanent and cannot be reversed. It lets Agents perform indexing and semantic searches on all files uploaded to Pigment.
> - To stop Agents having this access, switch it off at Application level:
>   1. Open Settings as above and select **Files**.
>   2. At the top of the main pane, select the slider symbol by **AI access: Enabled** (see below).
>   3. Select **Disable**.
> 
> ![](https://cdn.document360.io/e47cfe35-dc28-40c7-a083-6cf003073d8e/Images/Documentation/image(381).png?sv=2026-02-06&spr=https&st=2026-11-01T03%3A32%3A51Z&se=2026-11-01T04%3A32%3A51Z&sr=c&sp=r&sig=OP0wIAfLAFejZQRhzFBrcG2AE42Qz3OD7bSItJ%2B%2B4ew%3D)

### Send files to AI Chats individually

To send files to AI Chats individually:

1. In your Application, select **Files** in the left sidebar above your Application name.
2. In the panel that opens, hover over the file you want to send. Select **Add to AI chat**.

## File storage

The assets stored in Files contribute to your file storage. For more information, see [Manage File storage limits](/v1/docs/manage-file-storage-limits).