Skip to content
CartDocket

Add a file upload to Squarespace product pages

Updated · by the CartDocket team

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:

The common workarounds, and where they break

  1. “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.
  2. 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.
  3. A Dropbox or Google Drive link typed into a text field. Confusing for many customers, and links often have the wrong permissions or expire.
  4. 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

  1. Sign in at app.cartdocket.com with your Squarespace account and approve read access to orders and products.
  2. 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.
  3. Tick the products that take files, and turn on Required if every order of a product needs a file.
  4. Set the file rules: which file types, how many files, the largest size and, on Pro and Studio, a print size and minimum DPI.
  5. Open a product on your live site and check the uploader sits above Add to Cart.
  6. 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.

Frequently asked questions

Can Squarespace product pages accept file uploads on their own?

No. The form you can attach to a product (the Add to Cart form, which Squarespace calls a product form) has fields for text and choices but no file upload field. To take a file with the purchase you need an extension such as CartDocket, or a workaround outside the order.

Do I need a developer or a product form?

No. You paste one piece of code into two Code Injection boxes and tick the products that take files in CartDocket. There’s no Squarespace product form to build, and nothing in your template changes.

Which Squarespace plan do I need?

Core or higher, because the uploader loads through Code Injection. On the Basic plan you can still collect files after checkout with CartDocket’s post-checkout upload page (Maker, Pro and Studio plans).

How large can uploaded files be?

It depends on your CartDocket plan: Free up to 25 MB, Maker up to 100 MB, Pro and Studio up to 500 MB per file. Large files upload in parts straight to storage, so they don’t time out.

What if a customer doesn’t have their file yet?

Leave the upload optional for that product. On Maker, Pro and Studio plans the customer can add the file later on your store’s upload page with their order number and email, and it attaches to the same order.

Stop chasing files by email

Connect your store, paste one piece of code and tick the products that take files. Every new store gets Pro free for 14 days, then stays on the Free plan unless you choose to upgrade.