Before you start
- A Squarespace site (7.1 or 7.0) on the Core plan or higher. CartDocket’s uploader is added with Code Injection, which Squarespace includes from Core upwards. Trial sites can use it. On Basic, see the Basic plan note below.
- Admin access to the site, so you can approve the connection and edit Code Injection.
- At least one product you want to collect files for, such as a custom print, a photo gift or a commission.
- Checkout on your own domain. Squarespace does this automatically: checkout runs at
yourdomain.com/checkoutfor a custom domain with SSL, or at your built-insquarespace.comaddress. See the note below if your checkout address starts withsecure.squarespace.com.
Step 1: Sign in with Squarespace
Go to app.cartdocket.com and choose Connect with Squarespace. Squarespace asks you to pick the site and approve access. CartDocket asks only to read your orders and products, which it needs to match files to orders and to list your products in the dashboard. There’s no separate password: your Squarespace login is your CartDocket login.
Once you approve, you land on the dashboard’s Install page. New stores start with a free trial of every Pro feature, with no card needed.
Step 2: Paste your code into Code Injection
On the Install page, click Open Code Injection. CartDocket copies your code and opens Squarespace’s Code Injection page in a small window. If Squarespace asks which site, pick yours.
- Paste into the Footer box (⌘V or Ctrl+V). Leave anything already there in place.
- Scroll down and paste the same code into the Order Status Page box. It’s still on your clipboard.
- Click Save.
The Install page turns green on its own as soon as Squarespace loads the script, usually right after you save. You don’t need to confirm anything. Your code includes your store’s key and looks like this (copy yours from the dashboard, not from this page):
<script src="https://cdn.cartdocket.com/v1/cartdocket.js" data-key="pk_live_…" data-order="{orderId}" data-email="{customerEmailAddress}" defer></script>
Keep {orderId} and {customerEmailAddress} exactly as they are. On the order confirmation page,
Squarespace replaces them with the order number and the customer’s email. Everywhere else they stay empty and the code simply
shows the uploader.
Why paste it twice? Footer code runs on every page of your site, so the uploader is there whichever way a
shopper reaches a product, even when Squarespace swaps pages without a full reload. Squarespace doesn’t run Footer code on
checkout, so the same code also goes in the Order Status Page box, which runs on the confirmation page after a purchase. That’s
how CartDocket learns which order the shopper’s files belong to. It loads with defer, so it never holds up your pages.
Step 3: Pick the products that take files
New stores start with uploads off, so nothing changes on your site until you choose. In CartDocket, on the Install page or under Products:
- Choose Only products I pick and switch uploads on for the products that take files. Search by name and filter by On or Off.
- Or choose All products to show the uploader on every product, including ones you add later, and switch off any that shouldn’t have it.
- Set Required for products you can’t make without a file. Add to Cart then waits until the shopper has attached one.
- To change many products at once, select them and click Edit: turn uploads on or off, make them required or optional, set the uploader’s label and description, or change their file settings in one go.
The uploader appears on those product pages, just above Add to Cart, with drag and drop, file browsing and the phone camera. There’s no Squarespace product form to set up. Give it a label and description that fit the product, such as “Upload your artwork” and “PDF or PNG, at least 300 DPI”, in the default file settings or per product.
Default file settings apply to every product: which file types, how many files, the largest file and, on Pro and up, a print size and minimum DPI. Open a product to give it its own settings.
Already use a Squarespace Add to Cart form? You can keep it. On products with a form, the uploader appears inside the form instead of on the page. If the form has a Text field named like your CartDocket field label (under Default file settings → Advanced), CartDocket also writes the upload’s code into it, so the code shows on the order in Squarespace. That part is optional.
Step 4: Place a test order
- Open a product you picked on your live site. The uploader sits above Add to Cart.
- Attach a file, add the product to the cart and check out.
- Within about a minute, the order shows in CartDocket with its file, and the Install page’s last step turns green. That also confirms the Order Status Page snippet works.
On a Squarespace trial, checkout only takes test orders: turn on Test mode in Squarespace’s payment settings,
add a shipping or pickup option, and pay with card 4242 4242 4242 4242, any future date and any CVC. Trial sites are
private, so test in the browser where you’re signed in to Squarespace.
Signed in to Squarespace? Opening your site’s address sends you to the editor. Add ?noredirect to
the address, for example https://your-site.squarespace.com/?noredirect, to see the live site instead. Links from the
CartDocket dashboard already do this.
After you install
- Share your post-checkout upload page (Maker, Pro and Studio plans). Your store has a page at
cartdocket.com/u/your-storewhere customers can add a file after ordering with their order number and email. Link it from your order confirmation email or product description. - Turn on order alerts (Pro and Studio) to get an email or Slack message for each order that includes files.
- Tell shoppers what you need in the product description: file type, minimum size, and whether you’ll check it before printing.
Troubleshooting
The uploader doesn’t show on a product page
- Check the product is ticked in CartDocket (Products, filter On).
- Check your code is in the site-wide Footer box under Code Injection, not in a single page’s code injection or a code block, and that you clicked Save.
- Check your site is on Squarespace Core or higher; see the Basic plan note.
- Add
?cartdocket_debug=1to the product page’s address and open your browser’s developer console. CartDocket logs every step it takes. Send us that output if you’re stuck.
The Install page doesn’t turn green after I save
- Make sure the code went into Footer, not Header, and that you clicked Save.
- If the Squarespace editor shows “Scripts have been disabled on your site preview”, click Enable Scripts in Preview.
- Open any page of your site. The Install page checks every few seconds and turns green once the script has loaded there.
An order shows no file
- Check the same code is also in the Order Status Page box, with
{orderId}and{customerEmailAddress}unchanged. - The upload is kept in the shopper’s browser until checkout. If they added the item on one device or browser and paid on another, CartDocket can’t link the file. They can send it on your upload page, or you can send a re-upload request from the order (Pro and up).
- If the upload was optional and the shopper skipped it, the order is marked as awaiting a file.
Files normally appear within a minute of the order.
My checkout address starts with secure.squarespace.com
Squarespace moves checkout onto your own domain automatically when your custom domain has SSL set to Secure. If your checkout
still runs on secure.squarespace.com, the confirmation page there can’t see the uploads saved on your site, so files
won’t attach on their own. Turn on Secure SSL for your domain in Squarespace, or ask customers to use your post-checkout upload page
(Maker, Pro and Studio plans).
My site is on Squarespace’s Basic plan
Squarespace’s Basic plan doesn’t include Code Injection, so the uploader can’t load on your product pages. You have two options:
- Upgrade your Squarespace plan to Core (or higher) and follow the steps above.
- Use the post-checkout upload page (Maker, Pro and Studio plans). It doesn’t need Code Injection: customers upload at
cartdocket.com/u/your-storeafter ordering, and the file attaches to their order.
Some shoppers don’t see the uploader
A few ad blockers and privacy extensions block scripts from other domains, so those shoppers see your product page without the uploader. To make sure they can still send a file, link your post-checkout upload page in the product description, and watch for orders marked as awaiting a file in your dashboard. On Pro and Studio you can send those customers a re-upload request in one click.
A shopper’s file was rejected
The uploader shows the reason. The usual ones are a file type the product doesn’t allow, or a file above your plan’s size limit (Free up to 25 MB, Maker up to 100 MB, Pro and Studio up to 500 MB). If the message says uploads are paused, your store has reached its monthly upload limit; upgrading resumes uploads straight away.
My site uses a Squarespace 7.0 template
CartDocket works on 7.0 as well as 7.1. If the uploader doesn’t show on a 7.0 product that has no Add to Cart form, add a form to that product (the uploader then appears inside it) and email us the product link so we can support your template’s layout.
Still stuck? Email support@cartdocket.com with your site address and the product link, and we’ll take a look.