Catalog health
Rules such as every product in the tile collection needs coverage, pieces, dimensions and a sample. The app audits the catalog and lists what is missing, with a fix field on each row.
A catalog of a few thousand tiles has products that go live without a coverage, samples that were archived, links that point at the wrong product. On the product page that shows up as a missing buy box or a sample button that adds nothing. Catalog health finds those products for you.
Rules
A rule says which products are in scope and what each of them must have. Open Catalog health in the app and click New rule:
- Scope: a collection (for example "All tile"), a tag, a product type, or every product. Draft products are left out unless you tick Include draft products.
- Required fields: any of coverage per box, pieces per box, tile dimensions (length and width; thickness is never required), coverage per gallon, a sample, and container sizes on the variants.
- A name, and whether the rule is active.
Most tile stores need two rules: one on the tile collection requiring coverage, pieces, dimensions and a sample, and one on the paint collection requiring coverage per gallon, container sizes and a sample.
The audit
Saving a rule starts an audit, and Run audit now starts one whenever you like. The audit reads every product in your store in one pass, so it takes a minute or two on a large catalog, and then lists what it found. It also runs every night, and the products you save on the Products page or fix on this page are rechecked right away, so the list stays current without you doing anything.
The rules card shows, per rule, how many products are in scope and how many have at least one issue. The dashboard shows the total and a notice when it is above zero.
The issues
Each row is one product with one issue: the product, a badge for the issue, and the detail (the sample's title, the value found). Filter by rule, field, issue type or severity, or search by title.
| Issue | Means |
|---|---|
| Missing | The field is empty |
| Zero | The field is 0 |
| Not a number | The field holds text |
| Length or width missing | One of the two dimensions the tile area needs is empty |
| No sample linked | The product has neither a linked sample product nor a sample variant |
| Sample product deleted | The link points at a product that no longer exists |
| Sample is a draft, Sample is archived | The linked sample is not published, so the button would add nothing |
| Sample out of stock | The linked sample has no inventory (a warning; the button still shows if you sell when sold out) |
| Sample points at itself | The product is linked as its own sample |
| Linked sample looks like a full-size product | The linked product has a coverage per box, which a sample never has (a warning) |
| Container size missing | A paint variant has neither a container size and unit nor a size in its title |
| Containers mix weight and volume units | A product sells kilos next to gallons or litres; the buy box leaves the weights out |
| Coverage differs from dimensions x pieces | The coverage you entered is more than 20 percent away from length x width x pieces (a warning: check for a typo or a tile with large grout joints) |
Errors mean a block will not render or a button will not work; warnings mean something looks off but still works.
Fixing
- Fix on a row opens the field right there (or the product picker for a sample). Save, and the product is rechecked; the row disappears when it passes.
- Open in Shopify opens the product in the admin, with the app's fields pinned on the right.
- Open these in Products on a selection opens the Products page with just those products, for fixing a batch in one go.
- Recheck rechecks one product without waiting for the nightly audit.
Keeping it clean
Add new products to the collection a rule covers and they are audited that night; fix them from this page. A catalog with zero issues means every tile product page has a buy box, a spec row and a working sample button.
Spec rows
A row of three cells on the product page: tiles per square foot, tiles per box and the tile dimensions; coverage, sizes and recommended coats for paint.
Samples
Link samples to full-size products, track each shopper from the sample order to the full-size order, and write customer tags your email and SMS flows can use.