---
title: "Attachments"
space: "Framework"
url: "https://docs.frappe.io/framework/user/en/desk/attachments"
updated: "2026-02-17"
---

Frappe allows attachment of files to documents. Users with **Read** permissions on a particular document will also be able to access the files attached to it. Users can also access the File Manager from the sidebar.

![attachments-sidebar](/files/attachments-sidebar.png "attachments-sidebar.png")  


How to Attach a New File
------------------------

There are several ways to attach a file to a document.

### Select File

![attach-from-disk](/files/attach-from-disk.gif "attach-from-disk.gif")  


### Drag and Drop

![2023-08-28 13.28.01](/files/2023-08-28 13.28.01.gif "2023-08-28 13.28.01.gif")  


### Uploaded File

Attach a file a that was previously uploaded, to a different document.

![2023-08-28 13.33.07](/files/2023-08-28 13.33.07.gif "2023-08-28 13.33.07.gif")  


### Web Link

If you use a separate server for files or use online services like Dropbox or Docs, you can attach a file by providing a link to it.

![2023-08-28 13.34.48](/files/2023-08-28 13.34.48.gif "2023-08-28 13.34.48.gif")  


### Camera

Attach Images by taking a photo using your device's camera.

![Camera](/files/file_uploader_camera.gif)  


File Manager
------------

All the attached files are listed in the File Manager. You can access these by navigating here:

**Home > Tools > Files**

![Screenshot 2023-07-31 at 8.01.55 PM](/files/Screenshot 2023-07-31 at 8.01.55 PM.png "Screenshot 2023-07-31 at 8.01.55 PM.png")  


Import Zip
----------

You can also bulk import multiple files at once using the Import Zip feature.

1. Go to **File List > Menu > Import Zip**.
2. Upload a zip file.
3. After the zip file is uploaded, it's contents will be extracted and each file will be created as a new File record.

![Importing files from zip](/files/import_zip.gif)  



> Note: Hidden files (files starting with `.`) are not extracted when importing from a zip file.
> 
> 

Export as Zip
-------------

You can also bulk export multiple files at once using the Export as Zip feature.

1. Go to **File List**.
2. Select multiple files.
3. Click on Actions > Export as zip.
4. After the zip file is downloaded, you can import it in another site using Import Zip feature or send it across via email.

![Export files as zip](/files/export-as-zip.png)  


Cropping Images
---------------

You can crop `.jpeg` and `.png` images by clicking on the crop icon.

![Cropping images on upload](/files/crop_image.gif)  


Optimizing Images
-----------------

Images can be optimized to reduce their file size. Currently optimizing an image does the following:

1. Resizes it to fit a max-width of 1920px and a max-height of 1080px, while preserving the aspect ratio
2. Uses optimal encoder settings
3. Reduces the quality to 85%

**Toggle optimization during upload**

![Toggle image optimization](/files/toggle_image_optimization.gif)  


**Optimize an already uploaded image**

![Optimize saved image](/files/optimize_saved_image.gif)  


Limits
------

A limit of 10MB is applicable on file size per attachment by default. For self-hosted users, this can be changed by setting `max_file_size` in your site's configuration file.

### Attachments per Document

You can limit how many files can be attached to a specific document.

#### Step 1: Navigate to Customize Form


> Home > Customization > Customize Form
> 
> 

#### Step 2: Select Document Type

Select the document type for which you'd like to set this limit.

![Select Document Type](/files/select_document_type.png)  


#### Step 3: Set Limit

Set the value of **Max Attachments** to the maximum number of attachments allowed for this document type.

![Set Limit](/files/set_max_attachments.png)  


Once you're satisfied with the changes, click the **Update** button. That's it! The maximum number of attachments per document will now be validated every time a new attachment is added to a document of this type.