Skip to content
SapphireIT Labs
Publish Guard documentation

Built-in checks

IdGroupDefault severityNotes
titlecontentrequiredRejects empty and “Auto Draft” titles.
descriptioncontentrequiredFails when empty; warns below min_description_chars (150).
short_descriptioncontentwarningSame, with min_short_description_chars (50).
featured_imagemediarequiredAlso fails when the attachment no longer exists. Variable: the parent’s image only, because variations inherit it.
image_countmediawarningFeatured + gallery, de-duplicated, against min_images (2). Skipped at 0 or 1. Variable: also counts every enabled variation’s image and gallery.
pricepricingrequiredSimple 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_pricepricingwarningOnly 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.
categoryorganizationrequiredWarns when the only category is the store default.
tagsorganizationwarningAt least one tag.
skuinventorywarningPresence only. WooCommerce already enforces uniqueness. Variable: passes when the parent has a SKU (WooCommerce inheritance), otherwise every enabled variation needs its own.
stock_statusinventorywarningWarns 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_productsorganizationwarningVariable: 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():

FamilyProduct types
simplesimple, subscription, and any type not listed here (Bundles, Composite, Bookings)
variablevariable, variable-subscription
groupedgrouped
externalexternal

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.

Last updated:

Black Friday sale

Black Friday: 80% off every Pro plugin

Your first year, on every plan. The coupon is added for you at checkout.

Ends in The offer ends at 00:00 GMT on 5 December 2026.

Claim deal