Upload Your Assets

Evolve Image Search requires two types of assets to be uploaded to the system in order to operate.

1. Product images
2. Data files that maps products to images

This page documents the general procedure on how to upload files to the Evolve Image Search platform.

Image Requirements

Product images uploaded for indexing must meet the following requirements:

Requirement	Details
Supported formats	JPEG, PNG
Maximum dimensions	2,048 × 2,048 px (larger images are automatically downscaled during indexing)
Maximum file size	25 MB per image

warning

Only JPEG and PNG images can be indexed. Images in other formats (such as GIF, WebP, BMP, TIFF, or HEIC) are not supported and are skipped during indexing — they appear in the import job's failedMap (or in errorFiles when using the single-product index API).

Pre-Requisite Software

In order to connect to the file server, an SFTP client application is needed. You may use any one that you like, but here are some free recommendations:

• FileZilla
• Cyberduck
• WinSCP (Windows only)

Procedure

tip

SFTP credentials and the canonical host/port are listed on Common URLs & Credentials.

1. Log into your Dashboard at https://dashboard-<tenant>.evolvestorefront.com to retrieve your SFTP credentials

2. Using your preferred SFTP client, connect to the Evolve file server with the following connection information:

   • Protocol: SFTP
   • Hostname: sftp.evolvestorefront.com
   • Port: 22
   • Username: <your username>
   • Password: <your password>

3. Upload your images and data files with any desired directory structure.

tip

While you may upload all your files into a single directory, you will find that a directory structure of product categories will help with organization and file management.

/
├─ data
|  ├─ 20250101_full_load.csv
|  └─ 20250215_delta_load.csv
├─ diningroom
|  └─ image01.jpg
├─ kitchen/
|  └─ appliances/
|     └─ image02.jpg
|     └─ image03.jpg
|...

warning

Note that depending on your subscription level, you may be subject to storage space limits. It is your responsibility to ensure old and unused images are removed as necessary to stay within limits and to avoid potential overage charges.