Health checks

The Health checks note, in the editor’s margin, asks the same questions of your preset on every keystroke and answers each one, so you find out a preset is broken before a customer does. The checks are listed in screen order (name, items, discounts, destination, limits, status), so working down the note is working down the form. Each item’s line also shows its own problems, using the same rules. Its heading sums things up: N to do, N blocking, N warnings, or All clear.

​

Two severities

A blocking check stops the save. The preset can’t work as it stands. It would give you a broken cart, or no link at all. The check says Blocks saving, and the save bar says how many checks are in the way. A warning doesn’t. The preset will work, but may not do what you meant. That’s your call to make, so the save goes ahead. Checks that pass fold into a checks passed line at the bottom. Open it to read them. When you fix a blocking check, it shows as fixed for a moment (for example Name set) and then folds into that line. Fix the last one and you’re told the preset can be saved.

​

A new preset starts with a to-do

A brand-new preset needs two things before it can be saved: a name and an item. Until you first try to save, the note lists them as a quiet to-do rather than as errors:

• Name the preset
• Add at least one item

The save bar says what’s left, for example Name the preset and add an item to save. If you press Save preset before they’re done, they turn into the blocking checks they are: No name yet and No items yet. Either way, they block the save.

​

Click a check to go to its field

Every to-do, every blocking check and most warnings are buttons. Click one and the editor scrolls to the field it’s about, opens the item if it’s on an item, puts the cursor in the field and highlights it. A check with nowhere to go is a plain row. That’s the passed checks, and on the free version the Preset has expired and Preset has sold out warnings, because the fields that would fix them are locked there.

​

What blocks a save

​

What only asks to be looked at

A few answers are information rather than problems, and go straight into the passed line: whether the slug is set or will be generated, how many items and units the preset holds, that every option is set on its variable items, that each custom item is named and priced, and, on a scheduled preset, the date it goes live.

​

Checks the free version stays quiet about

Five of these checks point at controls the free version doesn’t have. Free leaves them out, because you’d have no way to fix them there. The warning would never go away, and you could be locked out of your own preset. Left out on free: the custom-item price, name and weight checks, the end-date check, and the cap comparison. The expired and sold-out warnings still show on free, because the status is a fact about the preset. They say the fix is part of Pro instead of pointing at a locked field.

​

Sold individually

WooCommerce lets you mark a product Sold individually: one per order, whatever the customer asks for. A preset that asks for three of one is the one case where the editor and the cart could quietly disagree. The summary would price three, the cart would add one, and the customer would be charged for one with nothing saying why. So the editor tells you. The item’s line says Sold one at a time, and the note raises one warning covering every item affected:

The cart trims the quantity to one and charges for one. Set the quantity to 1 so the preset quotes what the customer will pay.

Clicking it takes you to the first affected item’s Quantity. It’s kept apart from the stock problems below. Those say an item may not reach the cart. This one does reach it, trimmed, and you can fix the quantity in the editor, which you can’t do for stock. A customer who follows the link still gets the preset, plus a notice explaining the change. You can edit that notice like any other. It’s item_qty_capped under Messages and labels.

​

Stock problems

Stock is a fact about your shop rather than your preset, so it only ever warns. A late delivery from a supplier shouldn’t stop you saving your own preset. Each affected item gets its own warning, and each one ends by pointing at the setting that decides what happens: Unavailable items in Settings decides what happens. That’s Skip the item and fill the cart with the rest, or Refuse the preset. A product that allows backorders isn’t counted as low on stock. The listing flags a live preset too. If one of its products has been deleted, isn’t published, or can’t be bought, the row shows a Needs attention badge and a Fix link that opens the preset. Both read live product data rather than anything stored with the preset, so a product coming back clears the flag without you touching the preset.