How to upload images
Whether you are adding your first batch of product photos or updating seasonal images, uploading files to PixelFiddler takes just a few clicks. This guide walks you through every step, from opening your media library to seeing your freshly uploaded images ready for use.
Before you start
Section titled “Before you start”Make sure you have:
-
A PixelFiddler account — every new account comes with a hosted storage ready to use
-
One or more image files saved on your computer in a supported format (see the list below).
Open your media library
Section titled “Open your media library”Your media library is where all uploaded images live. To get there:
- Log in to the PixelFiddler dashboard.
- Open the Storage section in the left sidebar.
- Select the storage you want to upload images to.
You will land on the file browser for that storage, which shows every image and folder already stored there.

Upload your images
Section titled “Upload your images”PixelFiddler gives you two ways to upload. Pick whichever feels more natural.
Option A: Drag and drop
Section titled “Option A: Drag and drop”- Open a file explorer window on your computer and locate the images you want to upload.
- Select one or more files.
- Drag them directly onto the file area in your browser.
- Release the mouse button to start the upload.

Option B: Use the Upload button
Section titled “Option B: Use the Upload button”- Click the Upload button near the top of the file browser.
- A standard file picker will open.
- Browse to the folder on your computer that contains your images.
- Select one or more files and click Open.
Uploading multiple files at once
Section titled “Uploading multiple files at once”Both methods support multi-file uploads. You can drag an entire selection of images in one go, or select a batch of files in the file picker dialog. There is no limit on how many files you can include in a single upload session, so feel free to add your full product catalog in one batch.
Track upload progress
Section titled “Track upload progress”Once your upload begins, a progress widget appears in the bottom-right corner of the screen. It shows you:
- The name of each file being uploaded.
- A percentage indicator for every individual file.
- The overall progress of the entire batch.

You can continue browsing your media library or other sections of the dashboard while the upload runs in the background. The progress widget stays visible so you always know where things stand.
Supported file formats
Section titled “Supported file formats”PixelFiddler accepts the most widely used image formats for e-commerce and web content:
| Format | Common file extensions | Best for |
|---|---|---|
| JPEG | .jpg, .jpeg | Product photos and lifestyle images |
| PNG | .png | Images that need transparency, logos, graphics |
| WebP | .webp | Modern web-optimized photos and graphics |
| AVIF | .avif | Next-generation format with excellent compression |
| GIF | .gif | Simple animations and animated product previews |
The maximum file size for any single image is 10 MB.
Handle filename conflicts
Section titled “Handle filename conflicts”When you upload a file that has the same name as one already in the library, PixelFiddler will ask how you want to handle it. A dialog appears with three options:
- Overwrite — The new file overwrites the existing one. The old version is permanently removed. Use this when you are updating a product photo and want to keep the same filename.
- Keep both — PixelFiddler automatically renames the new file by appending a number (for example,
product-photo (1).jpg). Both the original and the new file remain in your library. - Skip — The upload for that particular file is cancelled. The existing file stays untouched and the new file is not added.

Batch uploads with conflicts
Section titled “Batch uploads with conflicts”If you are uploading many files at once and several have conflicting names, you do not have to choose individually for each one. Check the Apply to all remaining conflicts option in the conflict dialog, and PixelFiddler will apply your selection to every remaining conflict in the current batch. This saves time when replacing an entire set of updated images.
What happens after upload
Section titled “What happens after upload”Once a file finishes uploading:
- Thumbnail generation — PixelFiddler creates a preview thumbnail so you can visually identify the image in your library. This usually takes just a few seconds.
- The file appears in your library — It shows up in the file browser at the location you uploaded it to, ready for use.
- Immediate availability — Your image is instantly accessible for transformations. You can start using it in your store right away.
Tips for naming your files
Section titled “Tips for naming your files”A little thought about filenames now will save you a lot of time later when searching for specific images.
- Be descriptive. Instead of
IMG_4392.jpg, use something likeblue-cotton-t-shirt-front.jpg. You will thank yourself when your library has hundreds of products. - Use lowercase letters. This keeps URLs clean and avoids case-sensitivity issues across different systems.
- Separate words with hyphens. Names like
leather-wallet-brown-open.pngare easier to read thanleatherwalletbrownopen.pngand are also friendlier for search engines. - Include relevant details. Consider adding the product color, angle, or variant to the name. For example:
running-shoe-red-side-view.jpg. - Avoid special characters. Stick to letters, numbers, and hyphens. Spaces, accents, and symbols can cause issues in URLs.
Troubleshooting common issues
Section titled “Troubleshooting common issues”Upload seems stuck at 0% Check your internet connection. Try refreshing the page and uploading again. If the problem persists, try a smaller file first to rule out file-size issues.
File does not appear after upload completes Refresh the file browser. Thumbnail generation may take a moment for very large images. If the file still does not show, check that it is in a supported format.
“Format not supported” error Make sure your file is a JPEG, PNG, WebP, AVIF, or GIF. Some image formats like TIFF, BMP, or RAW are not currently supported. Convert them using any image editor before uploading.
Next steps
Section titled “Next steps”Now that your images are in the library, learn how to keep them organized and find what you need quickly: