Short answer: Squarespace product pages can’t collect files on their own. The Add to Cart form you can attach to a product supports fields for text and choices, but not file uploads. To take a file with the order you either use a workaround that happens outside the order, or add an uploader with an extension. CartDocket is the second kind: it puts an uploader on your product pages, just above Add to Cart, and attaches each file to its order. You don’t need to build a product form.
Why product pages don’t take files
Squarespace saves each product form answer as a short piece of text on that line of the order. That works for an engraving or a color choice, but a file needs storage, size limits, security checks and eventual deletion. So there’s no file field, and merchants selling custom prints and personalized gifts have asked for one on the Squarespace forum for years:
- Is it possible to let customers upload pictures?
- Adding an upload form option for a product
- Allow customers to upload images in the product form at checkout (commissions and custom orders)
- How to allow customers to upload a high-resolution photo as part of their order information
The common workarounds, and where they break
- “Email us your file after you order.” Easy to set up, but files arrive late or not at all, land in an inbox separate from the order, and you match every attachment to an order by hand.
- A separate upload form linked from the product page. The file isn’t tied to the purchase. Some customers upload and never buy; others buy and forget to upload.
- A Dropbox or Google Drive link typed into a text field. Confusing for many customers, and links often have the wrong permissions or expire.
- Other upload scripts. Check the maximum file size, where files are stored, and whether each file is matched to its order or just emailed to you.
What a proper product-page upload needs
- It happens before Add to Cart, so the file is part of the purchase and can be required for that product.
- It handles real files: print-ready PDFs of hundreds of megabytes, and iPhone photos in HEIC format.
- It tells the customer when a file is too small to print well at the size they’re buying, before they pay.
- It lands on the right order and line item, even when one cart holds two personalized items.
- It keeps files private and deletes them once you no longer need them.
How CartDocket adds a file upload to product pages
You tick the products that take files in CartDocket, and the uploader appears on those product pages, just above Add to Cart, with
drag and drop, file browsing and the phone camera. Each upload gets a short code such as CD-7K2QXM, which stays with the
item in the shopper’s browser when they add it to the cart. After checkout, a snippet on Squarespace’s order confirmation page sends
the codes with the order number and email, CartDocket checks both with Squarespace through the Orders API, and the file lands on that
order and line item.
Your cart, checkout and order emails stay exactly as they are. For a product marked Required, Add to Cart waits until the file has finished uploading. If a product already has a Squarespace Add to Cart form, the uploader appears inside that form instead.
Step by step
- Sign in at app.cartdocket.com with your Squarespace account and approve read access to orders and products.
- On the Install page, click Open Code Injection and paste your code into the Footer box and the same code into the Order Status Page box, then save (Squarespace Core plan or higher). The dashboard detects it on its own.
- Tick the products that take files, and turn on Required if every order of a product needs a file.
- Set the file rules: which file types, how many files, the largest size and, on Pro and Studio, a print size and minimum DPI.
- Open a product on your live site and check the uploader sits above Add to Cart.
- Place a test order with a file, then download it from the order in your dashboard.
The install guide covers each step in detail, with troubleshooting for the common snags.
Tips for fewer follow-up emails
- Say what you need in the product description: file type, minimum size, and whether you check files before printing.
- Require the upload only when you can’t start without the file. Otherwise keep it optional and point customers to your post-checkout upload page.
- Use print checks on large formats. A photo that looks sharp on a phone may be far too small for a 24-inch poster.