Supported Formats
Images
| Format | Extension | Notes |
|---|---|---|
| JPEG | .jpg, .jpeg | Best for photographs and complex images |
| PNG | .png | Best for graphics, logos, and images with transparency |
| GIF | .gif | Supports animation |
| WebP | .webp | Modern format with excellent compression |
| SVG | .svg | Vector format, ideal for icons and logos |
Videos
| Format | Extension | Notes |
|---|---|---|
| MP4 | .mp4 | The only supported video format |
Raster images (JPEG, PNG, GIF, WebP) are automatically converted to WebP format during upload for optimized file sizes. SVGs and videos are uploaded in their original format.
File Size Limits
| File Type | Maximum Size |
|---|---|
| Images | 5 MB |
| Videos | 10 MB |
How to Upload
From the Media Panel
Open the Media Panel
Click the media icon in the builder toolbar to open the Media Panel. It appears as a side panel showing your uploaded media library.
Select your files
A file picker dialog will open. Select one or more files to upload. You can select multiple files at once.
Drag and Drop
You can also upload files by dragging them directly into the Media Panel:Drag files
Drag one or more files from your computer’s file manager and drop them into the Media Panel area.
From an Image Element
When clicking on an image element in a section, you can upload directly from the image toolbar:- Click on any image element in the canvas
- Click the upload icon in the image toolbar
- Select a file from the file picker
- The image is uploaded and immediately applied to the element
Upload Processing
When you upload a file, the following happens:- Validation — The file type and size are checked against the allowed formats and limits.
- Conversion — Raster images (JPEG, PNG, GIF, WebP) are converted to WebP format at 100% quality for optimal file size without quality loss. SVGs and videos are kept in their original format.
- CDN upload — The processed file is uploaded to Cloudflare R2 CDN.
- Database record — A record is created in your media library with the file URL, name, size, and type.
- Availability — The file immediately appears in your media library and is ready to use in any section.
WebP Conversion
EcomWize automatically converts raster images to WebP format during upload. This provides several benefits:- Smaller file sizes — WebP typically produces files 25-35% smaller than JPEG and PNG at equivalent quality
- Faster page loads — Smaller images mean faster loading times for your published Shopify pages
- No quality loss — Conversion uses 100% quality setting, so there is no visible degradation
SVG files are not converted to WebP since they are already vector-based and resolution-independent. Video files (MP4) are also uploaded in their original format.
Frequently Asked Questions
Can I upload files larger than the size limit?
Can I upload files larger than the size limit?
No. The 5 MB image limit and 10 MB video limit are enforced server-side. Files exceeding these limits will be rejected with an error message. Compress your files before uploading if they are too large.
Can I upload multiple files at once?
Can I upload multiple files at once?
Yes. Both the file picker and drag-and-drop support multiple file selection. Each file is uploaded independently, and progress is tracked per file.
Where are my files stored?
Where are my files stored?
Files are stored on Cloudflare R2, a global CDN. This ensures fast delivery regardless of where your website visitors are located.
Can I use external image URLs instead of uploading?
Can I use external image URLs instead of uploading?
Yes. When setting an image in a section, you can enter an external URL directly instead of uploading to the media library. However, uploaded files are recommended for reliability and performance.