Add a file upload to a Squarespace product
A photo for a cake topper, a logo to engrave, artwork to print on a mug. Lots of personalized products need a file from the customer. Squarespace’s product pages can’t ask for one. Here’s why, the three ways around it, and how to put an upload box right on the product page.
Written for Squarespace 7.1, the version nearly all newer sites use. Updated October 2026.
Why the product page can’t take a file
Squarespace has two kinds of forms:
- Form blocks, the forms you put on a page, like a contact form. These have a File upload field. It takes up to 5 files, at most 10 MB each, and the files reach you by email, with a link to each one.
- Add to cart forms (a short form that opens when the customer clicks Add To Cart, with questions like “Name to engrave”). These can’t have a file upload field. Neither can the checkout form.
So Squarespace can take a file on a page, but not with a product the customer is buying. The file and the order never meet.
1. Ask for the file after the order
Write on the product page: “After you order, we’ll email you to collect your photo.” Then email each customer and wait for the reply.
Good: free, nothing to set up. Limits: it’s work on every order, and some customers never reply. Orders sit waiting, and a wrong or blurry photo turns up only once you’ve chased it.
2. A form block next to the product
Add a form block with a File upload field to the product’s description, or to a page you link to from it. Ask for the customer’s name and email in the same form, so you can match the file to the order later.
- Edit the product page (or a new page) and add a Form block.
- In the form’s fields, add File upload, and choose the file types and how many files.
- Add Name and Email fields, and a line like “Use the same email as your order.”
Good: free and built in. Limits: it’s a separate step, and customers can skip it or send it after paying. The file arrives in your email, not on the order, so you match them up by hand. You can’t charge for it, and you can’t make it required before Add To Cart.
3. A file upload on the product (plugin)
A plugin (extra code you add to your site) can put an upload box on the product page itself, among the product’s other options. OptionKit does this inside Squarespace’s own cart and checkout.
The customer drops a photo on the box, or taps Choose a file (on a phone, that opens their photos or camera). The file uploads straight away, with a progress bar, while they finish choosing. Add To Cart waits until it’s done. The order then shows the file’s name and a private link to it, on the item it belongs to, with a short code (like Item: PEAR-58A short code, like “Item: MANGO-42”, that OptionKit gives each personalized item. Its Personalization line lists the paid options it was charged for, under “Charged separately”, so you can see which paid options belong to which item.) that ties it to that item.
Good: the file comes with the order, every time, and you can make it required. It can cost extra: a set price, or a price per file. It works with the product’s other options, like a photo box that appears only when “Photo topper” is checked. Limits: it’s a paid plugin, $12 a month or $120 a year per store. It’s free on your site’s squarespace.com web address (URL), and there’s a 14-day free trial on your own domain. Files are kept 90 days, then deleted, so download the ones you need to keep.
Which one to use
| Ask after the order | Form block | Upload on the product (plugin) | |
|---|---|---|---|
| File arrives with the order | No, by email later | No, by email | Yes, linked on the order |
| Can be required before checkout | No | No | Yes |
| Can cost extra | No | No | Yes |
| Files at a time | Any | Up to 5, 10 MB each | Up to 10, 25 MB each |
| Work for you on each order | Email and wait | Match file to order | None |
| Cost | Free | Free | $12 a month |
- A few custom orders a month? Asking after the order is fine.
- Files that don’t belong to one purchase, like a quote request? A form block.
- A photo or logo that has to come with each order? An upload on the product.
How to add a file upload in OptionKit
- Connect your store in the builder’s Setup tab first. File upload keeps customers’ files online with your store. Get started shows how.
- Open the OptionKit builder. On the Options tab, press + Add an option and pick File upload. Or start from the Custom cake template: its photo topper already asks for the photo.
- Change the Label to what customers see, like “Your photo” or “Your logo”.
- Under Which files, check what you take: Photos (JPG, PNG, HEIC, WebP, GIF), PDF, Design files (SVG, AI, EPS, PSD) or Documents (Word and plain text).
- Set how many files (up to 10) and how big each one can be (up to 25 MB).
- Optional: check Required, give it a price, or make it show only when another option is chosen (Shows when).
- Press Update (Publish, the first time). The upload box is on your products within about a minute.
All the details are in Kinds of option › File upload.
Where the files are: on each order, as a link, and in the builder’s ⋯ menu › Files from customers, where you can download or delete them.
Questions
Can customers upload a photo from their phone?
Yes. On a phone, Choose a file opens their photo library or camera. iPhone photos (HEIC) are accepted when you check Photos.
Where do I find the files?
Each order in Commerce › Orders shows the file’s name with a link to it, on the item’s Personalization line (a $0 line that carries what the customer chose). The builder also lists every file in the ⋯ menu › Files from customers, to download or delete.
How long are the files kept?
90 days after the item goes in the cart, then they’re deleted. A file that never makes it into a cart is deleted after 7 days. Download the ones you need to keep.
Can I charge for a file upload?
Yes: a set price, or a price per file, like $5 for each photo. Or charge for the thing it’s for, like a $12 photo topper, and keep the upload itself free.
Can I see the photo on the product before ordering?
Not yet. Customers see their file’s picture in the upload box. Live preview is coming soon: customers will see it on your product photo. Notify me at launch
