How to understand kit health

Kit Health shows whether a kit is correctly configured and ready to appear on the storefront. It is not related to whether the kit is enabled — a disabled kit can still be healthy. Health reflects configurational completeness: does the kit have the right products, a primary item, a valid schedule, and at least one purchasable combination?

You can check health in two ways:

• Kit listing grid — the Health column on the Catalog -> Product Kits page shows OK or Has issues for every kit at a glance.
• Kit form widget — when editing a kit, the Kit Health widget updates in real time as you change fields, without requiring you to save first.

tip

Use the form widget while building or troubleshooting a kit. It tells you exactly what needs to be fixed before you save.

note

The Health column in the grid is also refreshed automatically by the scheduled reindex (runs every two hours by default). This means the grid can change on its own — for example, a kit that was OK may switch to Has issues if its products go out of stock, without anyone editing the kit.

---

"Has issues" reasons and how to resolve them

The table below lists every reason the widget can report, what causes it, and the steps to fix it.

Reason	What it means	How to fix it
Schedule	The kit's active window is in the future or has already passed.	Open the General Information section. If Active from is a future date and you want the kit live immediately, clear or adjust the date. If Active to is a past date, extend it or clear the field to remove the expiry.
No items	No products have been added to the kit.	Go to the Products section and add at least two products (Predefined Kit) or configure at least two positions (Smart Kit).
No primary item	The kit has products but none has Is Primary enabled.	In the Products section, enable Is Primary for at least one product. The kit will appear on the product page of every item marked as primary.
No valid combinations	Fewer than two products are present in the kit.	Add more products until the kit contains at least two. A minimum of two is required to form any combination.
No salable combinations	No combination produces two or more visible products. This occurs when all required products are out of stock, or when all optional products are out of stock leaving only the primary product (a single-product kit is not shown on the storefront).	Check stock levels. If a required product is out of stock, restock it or mark it as optional. If all optional products are out of stock, restock at least one of them or add additional optional products to the kit.

---

Step-by-step: fixing a kit reported as "Has issues"

1. Navigate to Catalog -> Product Kits.

2. Find the kit with Has issues in the Health column and click to open it.

3. Read the reasons listed under the Kit Health widget at the top of the form.

4. Work through each reason using the table above. The widget updates after every change, so you can confirm each fix immediately without saving.

   tip

   You do not need to save the kit to see health updates — the widget reflects the current state of the form in real time.

5. Once the widget shows OK, press Save to persist your changes.

note

Setting Active to No does not cause a health issue. Health checks focus on configuration correctness, not on whether the kit is currently enabled for the storefront.