| Id | Group | Default severity | Notes |
|---|---|---|---|
title | content | required | Rejects empty and “Auto Draft” titles. |
description | content | required | Fails when empty; warns below min_description_chars (150). |
short_description | content | warning | Same, with min_short_description_chars (50). |
featured_image | media | required | Also fails when the attachment no longer exists. Variable: the parent’s image only, because variations inherit it. |
image_count | media | warning | Featured + gallery, de-duplicated, against min_images (2). Skipped at 0 or 1. Variable: also counts every enabled variation’s image and gallery. |
price | pricing | required | Simple and external: the product’s own regular price. Variable: every enabled variation needs a valid regular price. Grouped: skipped, it has no price of its own. |
sale_price | pricing | warning | Only when a sale price is set: valid, not negative, below the regular price, dates in order. Variable: every enabled variation that is on sale. Grouped: skipped. |
category | organization | required | Warns when the only category is the store default. |
tags | organization | warning | At least one tag. |
sku | inventory | warning | Presence only. WooCommerce already enforces uniqueness. Variable: passes when the parent has a SKU (WooCommerce inheritance), otherwise every enabled variation needs its own. |
stock_status | inventory | warning | Warns on out of stock, and on managed stock that disagrees with the status. Variable: every enabled variation; parent-managed stock reads the parent’s quantity. Grouped and external: skipped, they have no stock of their own. |
child_products | organization | warning | Variable: at least one enabled variation. Grouped: at least one linked product that still exists (not deleted or trashed), and at least one of them published. Other types: skipped. Reports fail, so it blocks when set to required. |
All rules are enabled by default. A warning never blocks publishing; only a required rule that fails does.
Product types
Every rule judges a product by its type family, from Product_Context::get_type_family():
| Family | Product types |
|---|---|
simple | simple, subscription, and any type not listed here (Bundles, Composite, Bookings) |
variable | variable, variable-subscription |
grouped | grouped |
external | external |
Virtual and downloadable are flags, not families: such a product is judged exactly like any other simple product or variation. The sit_wcpg_product_type_family filter (below) moves a third-party type into another family.
title, description, short_description, category and tags read the parent product on every family.
On a variable product, an enabled variation is one whose own status is publish. Disabled (private) variations are ignored. Hidden out-of-stock variations are still checked, so the “Hide out of stock items” setting cannot let an unpriced variation through. A variable product fails a rule when any enabled variation fails it, and the message gives the failing count, the enabled count and the first failing variation id. Variations are always read from storage: the classic editor saves them by AJAX before the form is submitted.
A variable product with no enabled variations skips price, sale_price, stock_status and (without a parent SKU) sku with one shared reason, so the problem is reported once, by child_products. child_products ships as a warning so that REST and CSV imports, which create the parent before its children, are never blocked by it. Set it to required to refuse such products.
A rule that does not apply to a type returns skip with the reason, so the merchant sees it under Not applicable instead of the rule disappearing.