What Check my store looks at

looks at your store the way a customer’s browser sees it, right there in the (the OptionKit page where you set up your options). No tab opens. It runs by itself after Publish or Update, and each step of the Setup guide checks its own part again when you come back to the builder from Squarespace, or when you select Check now in the step. This page lists each thing the check looks at, what a problem means, and how to fix it. In the builder, what it found shows in the step it belongs to, or as its own row in the Setup guide.

Updated October 2026 · Squarespace 7.1

Running it

  1. Select the first time, then . The builder then says Checking your store…, and step 4 of the Setup guide says ✓ Live on yourstore.com · checked just now when everything is right. To check everything again at any time, select Check now in step 4, or Check my store where a step offers it (step 1, when the code isn’t found). A step’s own Check now checks just that step.
  2. Your site is private (not public yet, or behind a password)? Only your own browser can see it. So Check my store first shows a box, Check my store: “Checks your site code, the products for your paid options, and where your options appear. It runs on your store, in a new tab.” Select Start check, log in to Squarespace or type the site password if your store asks, wait until your store says it’s done, then select Back to the builder. The tab closes and the result shows in the builder. The builder says why it checked that way, like “Your site is private, so only your own browser can see it: checking it in a new tab instead.” It does the same with an older OptionKit install code on the page.
  3. No answer in about 15 seconds? The builder says Your store didn’t answer. Most often the code isn’t saved in Footer yet. with Open step 1. Other reasons lists the rest: a private site, an older install code to replace with , and pasting the check results instead.
  4. To paste the results instead, open ⋯ › Paste a report from my store… in the top bar. Log in to Squarespace in this browser, then open any page of your store. In the address bar at the top of your browser, select the very end of the address and type ?optionkit=diagnose, then press Enter. For example, yourstore.com/shop becomes yourstore.com/shop?optionkit=diagnose. Select Copy report, paste it into the builder, and select Read the report.

Once your options are on your store, Setup says ✓ OptionKit is running on yourstore.com. When no page of your store has loaded OptionKit in the last day, or a check since didn’t find it, the panel’s green Live badge becomes No recent activity (point at it for the time) and Check store under it checks again. Setup also checks once by itself when you open it.

Check my store looks from your own browser, where you may be logged in to Squarespace. The steps’ own checks, when you come back to the builder, read your site from outside, as customers do. When the two disagree about a paid option or your Add-ons page, the step follows the newest look. It says when Check my store found it and that the read from outside didn’t, like “… found “Gift box” at 3:21 PM. Read from outside your site just now, it isn’t there.” The hint under it says “Customers see your site from outside. Check the page is enabled and the site is public.” In View all, that paid option is ✗ Missing, with the same sentence.

The report starts with what matters, in plain words (like “Your options are on the store (updated Oct 4, 9:49 PM).”). Version numbers and ids are under Details for support: include them when you email us.

If an address already has a question mark in it, type an ampersand (&) instead of the question mark. For example, yourstore.com/shop?category=mugs becomes yourstore.com/shop?category=mugs&optionkit=diagnose.

The check finds your store’s currency and each product’s categories. With Connect with Squarespace, Browse products lists your store’s products from Squarespace, by name, without a check. Without it, the check lists them. After it, the builder shows prices in that currency. In the live preview, Preview settings › Preview on can then show one of your own products, with its name, price and photo.

Your site code

What it saysWhat to do
Your site code isn’t on your site yet (the code that switches OptionKit on) isn’t in , or the site hasn’t saved it. Paste it at the end of the Footer box in Pages › Custom Code › Code Injection, and save. See Add OptionKit with Code Injection. Saved it already? Wait a minute and select Check now. Until the check sees it, step 1 is to do again.
Your store has the old install code, not your site codeOnly the older install code (the one with your whole setup in it) is in Code Injection. Replace it with your site code from step 1, Add OptionKit to your site, and save.
OptionKit is on your site. Your options aren’t on your store yetThe code is in, but your options aren’t on your store yet. Select in the builder, step 4 of the Setup guide.
OptionKit isn’t on your cart page, so the cart isn’t checkedThe code is only on some pages (a page’s own Code Injection, for example), so customers could remove a paid option’s price in the cart. Put your site code in Code Injection › Footer (Pages › Custom Code), which covers the whole site, and delete it from the page.
Two OptionKit codes are on this pageAn older install code (the one with your whole setup in it) is still in Code Injection next to your site code. The old one wins, so changes from the builder don’t show. Delete the old code, everything from <script>window.OptionKitConfig to </script>. Until it’s gone, step 1 says so, and the line under Update reads “Remove the old install code first, as step 1 shows. Until it’s gone, your store keeps the old options.”
No product is tagged engravable yet, so no product shows these optionsA group of options shows on products with a tag or a category, and no product in your store has it yet. Add the tag (or category) to a product in Squarespace, under Products › Organization, or choose the products in the builder instead (Show these options on › Products I choose). The builder’s own note on that group says the same: “We didn’t find a product with the tag … in your store, so these options may not show anywhere.”
A newer version is online now; the next page load uses it.You updated your store a moment ago. Refresh the page and the new version shows.
This site runs Squarespace 7.0Squarespace has two site versions, 7.0 and 7.1. OptionKit works on 7.1 only. On 7.0 it stays switched off, so your store keeps working as it is.
Subscription: Free on this squarespace.com address / Trial until Oct 16 / Active / Ended: working until …This is your store’s plan, as OptionKit sees it. Free, Trial or Active: nothing to do. Ended: OptionKit keeps working until the date shown. Subscribe again before then, in Settings › Subscription. See Billing and your subscription.
OptionKit is off on this storeIts trial or subscription ended, or a payment failed. Your setup is kept for 90 days. Setup’s red bar says the one thing to do, and its Check now and Update use the same word: Subscribe or Renew, in your Subscription window. OptionKit is back within a couple of minutes. Deleted after those 90 days, the line reads “Your setup was deleted on Jan 15, 90 days after your plan ended.”
We didn’t find your site code on yourstore.comThe code that was on your site isn’t there any more. Paste it back at the end of the Footer box in Code Injection, save, then select Check now.
Open yourstore.com so OptionKit can confirm it’s installed.You published on your own domain, and no page of your site has loaded OptionKit yet. Open any page of your store and the row is checked off by itself. A private site can’t be seen from outside: the row then says Connect with Squarespace so your free trial can start on yourstore.com, with the button. Squarespace tells us the site is yours.
OptionKit doesn’t run on this domain with the install code in the pageThis only applies to the older install code, the one with your whole setup inside it. On your own domain it doesn’t run without a license key, so customers see your store as it is. Switch to your site code (Add OptionKit to your site, on the builder’s Setup tab) and subscribe. Or, if you have that code’s license key, enter it in Settings › Advanced › For developers, under Copy code without hosting. On your it runs without one.

Your paid options in Squarespace

Squarespace can only charge for products. So each has a , on your Add-ons page. There’s also one at $0.00. It carries what the customer typed or chose, so it shows on the order. The check finds each of these products. OptionKit then remembers each product by Squarespace’s own number for it. So if you rename a product later, nothing breaks.

What it saysWhat to do
✗ Missing / Not in your store yetStep 3, Activate your options, counts them under Create option products, like “4 of 6 ready · ⚠ 2 to fix”, and View all lists each one. There’s no product with that name on your Add-ons page, or it isn’t published. Connected with Squarespace, OptionKit creates the missing ones; set up manually, select Download import file and import it in Squarespace: it holds only the missing ones. Named it differently? Choose which product it is with It’s called something else. See Activate your options.
“Laser engraving” isn’t at /add-ons/p/laser-engravingIts product isn’t at that address, or isn’t visible. Open Products in Squarespace and check the product exists, isn’t hidden, and its URL is the address the message names. Then press Check now.
✗ Recreated in SquarespaceThe product was deleted and made again in Squarespace, so Squarespace gave it a new number. Your store shows that paid option as Unavailable until you select Update. Until then it counts under “to fix”.
The product for “Engraving” moved to …Squarespace gave it a different web address. (It adds a number, like engraving-2, when a name was used before.) The builder uses the address the check found. Select Update.
No page at /add-ons yetThere’s no page with the URL Slug add-ons. In Squarespace, select the gear beside your Add-ons page and check URL Slug says exactly add-ons, then select Save. Step 3 checks again when you come back to the builder.
The page at /add-ons isn’t a store pageThe page at that address is another kind of page. Create one in Pages: select Products, then Store.
Your site is password protectedYour whole site has a password, as every Squarespace trial site does, so OptionKit can’t see the page or the form from outside. Select Check my store, then enter the site password in the new tab.
The page at /add-ons asks for a passwordRemove the password in the page’s settings, or select Check my store and enter it in the new tab.
! Price doesn’t matchThe product’s price in Squarespace isn’t the one in the builder. View all asks Which price do you want to use?, with Squarespace $12.00 and OptionKit $9.00: select the price that’s right. Until then it counts as “to fix”.
Personalization costs $5.00 in Squarespace. It must cost $0.00, or customers pay more than the product page shows.Set its price to $0.00 in Squarespace. Until you do, OptionKit won’t add personalized items to the cart.
Sold outSet the product’s stock to unlimited. A sold-out paid option can’t be chosen. A sold-out Personalization product stops personalized items being added at all.
! No details formThe Personalization product doesn’t have the OptionKit details form yet. Step 3’s last part, Add a form to Personalization, has the seven steps, and Show me how the pictures. See Add a form to Personalization.
No Personalization productImport it with the rest: it’s in the import file. Without it, two identical products with different choices look the same in the cart and on the order.
Customers can’t add products with these options to the cartThe Personalization product isn’t ready in Squarespace, so your store turns away every item with these options. This red line is at the top of the Setup guide, once a page of your store has loaded OptionKit. It says why: “… was recreated in Squarespace: select Update.”, “… is sold out in Squarespace: set its stock to Unlimited.”, or that it must be in Squarespace with its OptionKit details form, at $0.00. Open step 3, at its end, opens the step.

Store settings

What it saysWhat to do
Skip cart page (Express Checkout) is on sends customers straight to payment. Turn it off in Settings › Selling › Cart. See Turn off Skip cart page.
No group of options applies to this productCheck which products each group of options is for. You can choose all products, products with a certain , or products one by one. You’ll find it on the Options tab, under the group’s name, Change, then Show these options on.

The cart

If you run the check with items in your cart, it also reports:

  • Cart: 1 paid option line whose product is no longer in the cart: its item is gone. Opening the cart page fixes this by itself.
  • Cart: 2 lines need fixing; the cart page does this when it opens. These were half-added. Nothing to do.
  • Cart: 1 personalized item needs the customer’s attention: its details changed or can’t be read. Checkout waits until the customer sorts it out.

What the check never sees

It reads your setup and your store’s public product data. It doesn’t read or send what customers typed. It doesn’t read their names or their orders either.

Questions

Everything is ✓ but an option says Unavailable on my store.

Its product in Squarespace couldn’t be read when that page loaded. Maybe:

  • the Add-ons page is disabled or has a password, or
  • the product was just unpublished.

Fix that, refresh the page, and select Check now.

Setup says No recent activity. What happened?

It means no page of your store has loaded in the last day. That’s normal for a quiet store. Select Check store under the badge. If it still says No recent activity, your site code may have been taken out: paste it back at the end of the Footer box, save, and select Check store again.

Setup says a paid option was found, then that it isn’t there. Which is right?

The newest look. Check my store looked from your own browser, where you may be logged in to Squarespace. The step’s own check reads your site from outside, as customers do. A page still turned off in Pages, a password on the site, or a domain that hasn’t finished moving shows your browser one thing and customers another. Fix that, then select Check now.

Do I need to check my store after every change?

No. The check runs by itself after Publish or Update. Select Check now in step 4 after you change the products for your paid options in Squarespace, or your theme. It takes a few seconds.

How do I see a page without OptionKit?

Open the page. In the address bar, select the very end of the address and type ?optionkit=off, then press Enter. For example, yourstore.com/shop/p/mug becomes yourstore.com/shop/p/mug?optionkit=off. If the address already has a question mark, type an ampersand (&) instead of the question mark. If a problem is still there without OptionKit, it isn’t OptionKit’s.