Shopify File Upload: How to Add Image Upload on Product Pages (2026)

Two kinds of "upload image" on Shopify

The first two are built into Shopify. The third, often called Shopify photo upload or Shopify file upload, needs an app or custom code, and it's what most of this guide is about.

How to upload product images to Shopify (for merchants)

1. In your Shopify admin, go to Products and open the product.
2. In the Media section, drag your images in, or click to upload them from your computer.
3. Drag the images into order. The first image is the one shown on collection pages.
4. To show the right photo for each color or size, open a variant and choose its image from the product's media.
5. Click an image to add alt text, then Save.

Shopify's image requirements:

• Formats: Shopify says PNG is the best file type for most product images, followed by JPEG. It also accepts TIFF, BMP, GIF, SVG, HEIC and WebP.
• File size: under 20 MB per image.
• Dimensions: up to 5000 x 5000 px (25 megapixels). For square images, Shopify says 2048 x 2048 px usually displays best.
• Consistent shape: use the same aspect ratio for main images so they line up on collection pages.
• How many: a product can have up to 250 media items, and each variant can use one of them.
• Alt text: Shopify says alt text describes the image for customers using assistive technology and when an image can't load. It allows up to 512 characters but recommends 125 or fewer.

Why it matters: in Baymard Institute's product page research, 56% of users' first action was to start exploring the product images, and 25% of e-commerce sites had product images that weren't good enough. For personalized products, show several finished examples with different names and photos.

To add an image to a normal page (such as your About page), go to Online Store > Pages, open the page and use the image button in the content editor.

Ways to let customers upload images on product pages

Our comparison of Shopify's native file upload vs an options app goes deeper on the trade-offs.

The no-app method: a file field in your theme

Shopify's developer docs say line item properties can capture information like engraving text or let a customer upload a file. Properties are inputs named properties[...], and they must be inside the product form. A file field looks like this:

<label for="your-photo">Upload your photo</label>
<input id="your-photo" type="file" name="properties[Your photo]" accept="image/png, image/jpeg">

It works for simple needs, but know the limits before you rely on it:

• No preview. Customers can't see their photo on the product before they buy.
• No real checks. The accept attribute only filters the file picker. It doesn't check resolution, file size or whether the image will print well.
• Cart drawers can drop the file. Many themes add products to the cart with JavaScript. Developers in the Shopify Community report that some themes' cart drawers don't send the file this way, so test it with your exact theme.
• No extra charge for the upload, and no positioning, rotating or text on top of the photo.
• Theme updates can overwrite your code changes.

For anything customers pay real money for, an app is safer. Our step-by-step guide to adding photo upload to Shopify covers the code method for Dawn in more depth.

How image upload works in PIMW Product Personalizer

PIMW Product Personalizer is our Shopify app for personalized products. Its upload features are built around a visual editor:

• Canvas editor: you upload a photo of your product as the canvas background, pick an aspect ratio (free, 1:1, 4:5 or 16:9) and place areas on it. What you see is what customers see.
• Logo zones: areas on the canvas where customers upload their own image (a photo, logo or artwork) or pick one from your default library. You drag and resize the zone to the printable area.
• Accepted files: PNG, JPEG, WebP, SVG and GIF, up to 5 MB per upload.
• Default logo library: images you add for customers to choose from, such as designs, frames, icons or clipart: 5 on Basic and 20 on Pro and Unlimited.
• Text areas next to the image: 35+ Google Fonts, bold, italic, underline, alignment, colors and character limits, so a photo mug can also carry a name.
• Multi-step flows: each step is a separate view of the product (for example front and back), with its own canvas, background image, text areas and logo zones. Customers move through the steps as tabs.
• Live preview: customers see their image and text update on the product image as they go.
• Three layouts: a popup, a slide-out drawer or fullscreen, all available on every plan.
• Order management: an Orders tab shows each personalized order with the customer's text, fonts and colors, and thumbnails of uploaded images with download links.

It works with any Online Store 2.0 theme through Shopify app blocks, with no theme code to edit.

Step by step: add image upload with PIMW Product Personalizer

1. Install the app from the Shopify App Store. Customer image upload is on Pro and Unlimited, and both have a 3-day free trial.
2. Enable the app embed: in your Shopify admin, go to Online Store > Themes > Customize, click App embeds, switch on PIMW Product Personalizer and save. This is the most common reason the widget doesn't appear.
3. Create a personalizer: in the app, go to Personalizer > Create New and name it, for example "Photo mug, front and back".
4. Set up the canvas: upload a clean photo of your product as the background and choose the aspect ratio.
5. Add a logo zone for the customer's image, and drag it over the printable area.
6. Add text areas if the product also needs a name or message, with fonts, colors and a character limit.
7. Add steps for other views, such as the back of a mug or a t-shirt, each with its own background image and zones.
8. Add default images if you want customers to be able to choose a design instead of uploading one.
9. Set prices (optional): create the fee product first (see the next section), then add a price to the logo zone or the step.
10. Assign the personalizer to your products and set its status to Active.
11. Add the Personalizer block to your product template in the theme editor, and set the button label (for example "Upload your photo") and colors.
12. Place a test order, open it in the app's Orders tab and download the uploaded image to check it arrives at full size.

Charging for photo and logo uploads

Uploads take work: checking the file, setting it up and sometimes printing a second side. PIMW Product Personalizer lets you charge for it in four ways:

Set it up once: on the app's Dashboard, click Create Fee Product. The app creates a hidden $0.01 draft product and configures Shopify's Cart Transform function. Prices won't apply until this shows as Active.

What customers see: prices update as they make choices, and in the cart the product and the add-on fee appear as one line item with the fee shown as a separate detail. That keeps the cart clean.

Show the upload only when customers want it

Not every customer wants to upload a photo. With conditional logic (Pro and Unlimited), you can add a switch such as "Would you like to add your logo?". The Upload your logo field appears only when the customer turns it on, so the page stays simple for everyone else. You set it in the field's Condition settings, choosing which field triggers it and whether any value or one specific choice shows it.

PIMW Product Personalizer plans for image upload

Every plan includes unlimited custom orders with no per-order fees, the live preview, all three layouts and priority support. Yearly billing saves 20%, and the Free plan needs no credit card.

Which plan do you need?

• Names, monograms and engraving only: Free or Basic.
• One photo or logo per product (photo mug, canvas, pet portrait, logo apron): Pro.
• Front and back uploads, collages or a large catalog: Pro for up to 3 upload steps and 20 images per personalizer, Unlimited for more.

Use cases: products that sell with image upload

Our product guides go into each one: selling custom canvas prints, custom t-shirts, custom blankets, personalized aprons, personalized picture books and custom rubber stamps, plus our ranking of the best print-on-demand mugs.

Photo quality: get files that print well

Low resolution is the biggest cause of disappointed customers. Here is what the main print-on-demand providers ask for:

Do the pixel math. Pixels needed = print size in inches x DPI.

Phone photos are usually big enough, screenshots aren't. Apple says iPhone 15 Pro introduced a 24-megapixel default for photos, and recent iPhones can capture 48 MP. A full-size phone photo easily covers a mug or a t-shirt front. The problem is copies: screenshots, photos saved from social media or messaging apps, and heavy crops. Tell customers to upload the original photo.

File formats:

• PNG supports full transparency, so it's best for logos on colored products. Printful recommends PNG because a JPEG without a transparent background may print with a white box.
• JPEG is fine for photos but doesn't support transparency.
• SVG is a vector format, ideal for logos because it scales without losing quality.
• iPhone HEIF photos: Apple's High Efficiency format saves space, but it isn't in PIMW Product Personalizer's accepted list (PNG, JPEG, WebP, SVG, GIF). Apple says photos shared by email or Messages may be converted to a more compatible format like JPEG, and customers can switch the camera to Most Compatible in Settings > Camera > Formats. Mention this in your help text.

Our guide to the file formats to accept for custom uploads has the full list, and our list of the most common photo upload mistakes covers the rest.

Privacy and copyright for customer uploads

Customer photos can be personal data. Under UK GDPR, personal data is any information relating to an identified or identifiable person, so a photo of a customer's family is likely to count. The ICO's storage limitation principle says you must not keep personal data longer than you need it. Set a retention period for uploaded photos (for example, delete them a few months after the order ships, once returns and reprints are done), say so in your privacy policy, and delete files on schedule.

Customers need the right to use the image. The US Copyright Office says a work is under copyright as soon as it's created and fixed in a tangible form, and that copyright belongs to the author, not to whoever owns a copy. A photo a customer found online usually belongs to someone else. So:

• Add a line next to the upload field: "By uploading, you confirm you own or have permission to use this image."
• Refuse orders with obvious brand logos, characters or celebrity photos.
• Know the process: Shopify complies with the Digital Millennium Copyright Act (DMCA) and generally removes content after a valid infringement notice, and it can close stores for repeated or willful infringement.

Our guide to handling copyright on customer-uploaded images explains the details.

Troubleshooting image upload

Your Shopify image upload checklist

1. Upload your own product photos: PNG or JPEG, under 20 MB, about 2048 x 2048 px for square images, with alt text.
2. Decide which products need customer uploads and where the image prints.
3. Install PIMW Product Personalizer and choose Pro or Unlimited for customer uploads.
4. Enable the app embed and build a personalizer with a logo zone on a photo of your product.
5. Add text areas, steps for other sides and default images where useful.
6. Create the fee product and set per-logo or per-step prices.
7. Use conditional logic to show the upload only when customers want it.
8. Add help text: accepted formats, original photos only, and a copyright line.
9. Set a retention period for uploaded photos in your privacy policy.
10. Place a test order and download the file from the Orders tab.

A photo upload turns a standard product into a gift only your customer could have made. Set it up once, test it with a real order, and every product page can become a personalized one.

Keep exploring

How to add logo upload to Shopify products

Best Shopify personalizers with photo upload

Best Shopify personalizers with photo upload

How to add product options in Shopify

• Tool for selling personalized gifts on Shopify