# Bulk Upload Images via Zip File

> Source: https://service.handbid.com/image-import-feature

### Article Index: 

*To skip ahead click on a link below*

1.  [Zip File Requirements](/image-import-feature/#zip-file)
2.  [How to Upload Zip File](/image-import-feature/#upload-zip-file) 
3.  [Email Notifications / Error Handling](/image-import-feature/#email-notifications)

### **Zip File Requirements**

**Prior to uploading images via a zip file, please make sure you have manually [Added your Items](/instructions-video-adding-silent-and-live-auction-items/) or [Imported your Items into Handbid](/importing-items-into-handbid/).** 

**Please review the following requirments prior to creating your zip file.** 

-   **Archive Format**: The archive must be a .zip file containing images.
-   **Image Formats Supported**: .png, .jpg, .jpeg, .avif, .webp
-   **Naming Convention**: Images must be named using the format \[item\_code\].\[extension\]. If multiple images for the same item are being uploaded, an additional suffix can be used, such as - or \_ followed by any string, which serves as a unique identifier or "iterator".
-   **File Size**: Each image file must not exceed 2MB.
-   **Directory Check**: Item images must be in the root directory of the zip file (not in a sub folder).  If a sub directory is found, an error is recorded, and any images in the sub directories are ignored. 

### **How to Upload Zip File**

Prior to uploading a zip file, please make sure your archive file follows the [Zip File Requirements.](/image-import-feature/#zip-file)

1.  Navigation to the Items -> Import option on the left navigation.
    
    ![](https://ucarecdn.com/c4dd7b45-779a-49c1-b06f-e490c4a8c276/)
    
2.  Click the "Choose a File" under the **Import Images** section and select from Zip File to upload. 
    
    If the "**Replace existing images**" checkbox is checked, any files with the same name will be replaced. If you do not wish to replace existing images you will need to uncheck this box. 
    
    ![Screenshot 2024-11-26 at 2.57.31 PM](https://ucarecdn.com/1e7ff4c6-9302-4a0d-9435-1840f5f4f397/)
    
3.  Once uploaded, we will attempt to read the archive file.  If the file is successfully read, a success message is displayed, and the images will be processed in the background and an email will be sent to you once the processing is complete. 
    
    *NOTE:  The file is processed in the background, so you do not need to stay on this screen.*
    

![Screenshot 2024-11-26 at 3.01.34 PM](https://ucarecdn.com/7d712fd8-15d0-479d-a694-ef77de6eaf6e/)  
If we were unable to read the file, you will receive an error message, and the process will be terminated.  You will need to fix the file and re upload the file. 

![Screenshot 2024-11-26 at 2.58.52 PM](https://ucarecdn.com/538b6193-4598-43be-be88-977d51f8e67e/)

This success message indicated the upload succeeded.  There could still be errors while processing your images.  You will be notified of the errors via email. 

### **Email Notifications / Error Handling**

After the file is processed an email will be sent summarizing the results:

You can have partial uploads.  The images that succeed will be added to your items and you will be sent an email with information on the images that failed. 

#### Example email format and error messages. 

Your image upload job to Handbid for the XYZ Auction is complete with the following results:

"#123.png" - Successful

"#123-1.png" - Successful

"#123-2.png" - Successful: File successfully replaced

"somedir" - Failed: Directories are not supported. Please set your images in the archive's root directory.

"#321.txt" - Failed: Unsupported file type.

"#321.png" - Failed: Could not match file name with any item code.

"\_\_MACOSX" - Failed: Directories are not supported. Please set your images in the archive's root directory.

"#555.png" - Maximum image size is 2 MB.

**"xxxx.zip" -**  Could not open zip file, please check if the file is not corrupted and is not password protected.