Piece Health – Product Health Check for WooCommerce

By sammomix

0+ active installationsVersion 0.1.0

Check your WooCommerce catalog for products that need fixing, fix weights and costs in bulk, and mark down the pieces that do not sell.

Description

A catalog slowly fills with products that have no weight, no cost, no photo, a one-line description or a price of 0. Nobody notices until a shipping rate is wrong, a margin report is empty or a shopper cannot tell two products apart.

Piece Health reads your products, tells you what to fix and gives your catalog a score, then lets you fix the most common gaps in bulk. It was built for shops that sell one-of-a-kind pieces (vintage, second-hand, antiques, handmade), and works as a general product data checker for any WooCommerce shop.

What it checks

  • No cost: the product has no value in WooCommerce’s Cost of Goods Sold field (WooCommerce 10.3 and later).
  • No weight: a product that ships has no weight.
  • No price: the regular price is empty or 0.
  • More than one in stock: a one-of-a-kind piece with a stock above 1 (you can turn this check off).
  • No photo: the product has no image.
  • Ready for AI shopping, scored on its own: a description under 60 characters, a title under 3 words, a product only in the default category. These are what search engines and AI shopping assistants read.

Variable products are checked piece by piece: each variation has its own price, cost and weight.

What you can do about it

  • Fix in bulk: type a weight or a cost for each piece (or fill all the empty fields with one value) and save. Piece Health only fills gaps: a piece that already has a weight or a cost is never changed. Costs go into WooCommerce’s own Cost of Goods Sold field.
  • Sleeping pieces: the pieces that have been in stock for a long time (90 days by default, you can change it), how much money they tie up, and a one-click markdown of 10 to 50 percent. The markdown is a sale price: your regular price stays and WooCommerce shows it crossed out. It never goes below the cost, never touches a sale price you set yourself, and can be undone.
  • Progress: about once a week, when you open the page, the two scores are kept. If your score fell by 5 points or more, or 5 or more new problems appeared, a warning shows. No background task, no e-mail.

Good to know

  • Unlimited products, free. No quota, no trial, no paid tier, no advertising.
  • Nothing is sent anywhere. Piece Health makes no external request and never reads orders or customers.
  • It changes nothing until you press a button, and it never changes titles, descriptions, categories, photos, stock or orders.
  • Large catalogs work: products are read 40 at a time and the page shows how far the scan is.

Source code

The admin page is written in TypeScript and React and built with @wordpress/scripts. The source is in the src/ folder of the plugin. To rebuild the files in build/, run npm install and then npm run build in the plugin folder.

Installation

  1. Install and activate WooCommerce 10.3 or later.
  2. Install and activate Piece Health.
  3. Optional but recommended: in WooCommerce > Settings > Advanced > Features, turn on Cost of Goods Sold, so costs can be checked and written.
  4. Open WooCommerce > Piece Health.

FAQ

Do I need to turn on a WooCommerce setting?

Only for costs. WooCommerce ships the Cost of Goods Sold field but keeps it off by default. Turn it on in WooCommerce > Settings > Advanced > Features. Until then the cost check is left out, costs cannot be written, and everything else works.

What does the score mean?

The catalog score is the share of your products that have none of the problems listed on the Overview, out of 100. “Ready for AI shopping” is the same for titles, descriptions and categories. A product counts once however many problems it has.

What does Piece Health change in my store?

Nothing, until you press a button. Fix in bulk writes the weights and costs you typed, only on pieces that have none. Sleeping pieces puts a sale price on the pieces you select. Titles, descriptions, categories, photos, stock and orders are never changed.

Which products are checked?

Published simple and variable products. Grouped and external products, drafts and products in the trash are left out, and the Overview says how many products of other types it skipped. Virtual and downloadable products are not asked for a weight.

What is a sleeping piece?

A piece that has been in stock for a long time. WooCommerce does not record when stock arrived, so Piece Health uses the date the product was created: a piece you list again as a new product starts again at 0 days. Piece Health does not read orders, so it cannot tell whether a product sold last week. If you sell several of each product, treat the list as a starting point.

How do markdowns work? Can I undo them?

A markdown sets the sale price (every variation that is in stock, for a variable product) to a percentage off the regular price. A markdown never goes below the cost when the cost is known, and a piece that already has a sale price of your own is left alone. Undo removes a markdown made by Piece Health, and only if you have not changed the sale price since.

My products are not one-of-a-kind. Can I turn off the stock check?

Yes: untick “My products are one-of-a-kind pieces” on the Overview or in Settings.

Is my data sent to a server?

No. Piece Health makes no external request and never reads orders or customers.

What happens when I delete the plugin?

By default your settings and score readings are kept. Turn on “Delete all Piece Health data when the plugin is deleted” in Settings if you want everything removed. Weights, costs and sale prices already written to WooCommerce are never touched.

Is it compatible with high-performance order storage and the block checkout?

Yes. Piece Health declares compatibility with both and never reads or changes orders. It uses the standard WooCommerce product API.

Screenshots

Changelog

0.1.0

  • First release.