> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.cxplanner.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Upload Files and ZIP Archives to the File Module

## Overview: upload files and ZIP archives

The File module upload lets you add single files, multi-file bulk uploads, and ZIP archives with optional automatic extraction into the folder structure, which is used when centralising project documents, drawings, reports, and supporting materials in CxPlanner.

Storage monitoring and license limits are covered briefly here; see the linked storage article for more detail.

* Your role must include upload (write) access on the target folder. **Admin** always has access. Other roles need folder permission first.
* You can find the menu at File module - folder with a blue plus - **Upload**.
* This changes the file repository, folder structure, and global license storage usage.

|| Only users with upload permissions for a folder can use this feature. You must be granted access to a folder first. Users with the role **Admin** always have access.

## Requirements for uploading files

| Requirement | Description |
|---|---|
| Folder access | Write or upload permission on the target folder |
| Folder indicator | A blue plus on the folder means you can upload |
| Max file size | 5 GB per individual file |
| Storage | Shared across all projects under your license |

## How to upload files

1. Navigate to the **File** module.
2. Click a folder that shows a **blue plus** symbol. This indicates you have upload rights.
3. Click **Upload**.
4. Drag files into the upload field, or click to browse and select files.
5. Click **Upload** to begin.

![Screenshot: Upload Files and ZIP Archives to the File Module - Steps to upload files:](https://storage.crisp.chat/users/helpdesk/website/ea2cfd7bb6130800/image_jp4m5b.png)

![Upload many files](https://storage.crisp.chat/users/helpdesk/website/ea2cfd7bb6130800/image_sxpvnm.png)

## How to upload and extract a ZIP file

1. Open the **Upload** dialog as above.
2. Add a ZIP file.
3. When the yellow message box appears, tick **Extract ZIP**.
4. Complete the upload so CxPlanner creates subfolders and files matching the ZIP structure.

## Results: file and ZIP upload

| Upload method | Result |
|---|---|
| Single file upload | Uploads one file at a time |
| Multi-file upload | Uploads multiple files in a single action |
| ZIP file upload | Uploads the archive as-is unless extraction is selected |
| ZIP file with extraction | Creates subfolders and uploads contents according to the ZIP structure |
| Folder without permission | Upload button is hidden |
| Folder with permission | Upload button is visible, indicated by a blue plus icon |

* Maximum file size is 5 GB per file
* There is no separate project storage cap; usage is cumulative on the license

### Monitor storage use

||| Only the company **Administrator** can open company agreement storage.

1. Click your **avatar** in the top-right corner.
2. Go to **Company profile** - **Company agreement**.
3. View current storage and request additional space if needed.

See [help page here](https://help.cxplanner.com/en-us/article/company-settings-for-the-platform-administrator-1fkf4pn/) on the topic.

## Troubleshooting: upload files and ZIP archives

| Problem | Cause | Solution |
|---|---|---|
| Upload button not visible | Your user or group lacks write access on the folder | Ask a project **Manager** or **Admin** to grant write access on that folder |
| ZIP file not extracted | **Extract ZIP** was not ticked | Re-upload the ZIP and tick **Extract ZIP** |
| Upload fails | File exceeds 5 GB | Split the file into parts under 5 GB, or compress differently, then retry |
| Reached storage limit | License storage cap reached | Open **Company profile** - **Company agreement** as company **Administrator**, or ask that person to request more storage |