Products and values
The Products page: tile dimensions, pieces per box, coverage per box, coverage per gallon, container sizes and the sample link, edited in bulk across every product.
Everything the blocks show comes from a handful of values on each product. The Products page in the app edits them in bulk; they are also visible in the Shopify product editor under the app's pinned metafields, so either place works.
The three views
The page has three tabs. Each shows the columns that matter for that kind of product and lets you edit every row, then saves all your edits with one Save button, even across pages.
Tile
| Column | What it is | Used by |
|---|---|---|
| Dimensions | Length x width x thickness of one tile, in the store's dimension unit. Thickness is optional. | Tile specs row, the suggested coverage |
| Pieces per box | How many tiles come in a box | Tile buy box (the tile count), Tile specs row |
| Coverage per box | The area one box covers, in the store's area unit. The field suggests length x width x pieces as a placeholder when the dimensions are set; the manufacturer's rated coverage always wins when you enter it. | Tile buy box (the box count), Tile specs row |
| Tiles per unit of area | Read-only: pieces per box divided by coverage per box, or one over the tile area when the box values are missing | Tile specs row |
| Sample product | The product (or variant) you sell as the sample of this tile | The sample card and button, sample tracking |
Paint
| Column | What it is | Used by |
|---|---|---|
| Coverage per gallon | The area one gallon covers with a single coat | Paint buy box, Paint specs row |
| Sizes | A size and a unit per variant (1 gallon, 0.25 gallon or 1 quart, 5 kilo). Units: gallon, quart, pint, litre, millilitre, kilo, gram. Leave both blank and the app reads the size from the variant title when it says Quart, 1 Gallon, 5 Gallon, 2.5 L, 750 ml or 5 kg; the placeholder shows what it read. | Paint buy box (which containers to recommend), Paint specs row |
| Words (tile tab) | The container word and the piece word a tile is sold by: crate, carton, pallet; sheet, plank. Singular; add the plural after a pipe when it is irregular (box|boxes). Blank keeps the words set on the block. | Tile buy box labels, the result line, the summary prices |
| Sample product | The sample sold for this colour | The sample button, sample tracking |
Samples
Every product with its linked sample and the sample's status, so you can see at a glance which products still need one. A sample can be a separate product (pick it with Choose) or a variant of the product itself titled "Sample" (the blocks find that on their own; see Samples for how the two setups differ).
Bulk actions
The More actions menu on the page offers:
- Fill coverage from dimensions: for every product on the pages you have opened that has dimensions and pieces per box but no coverage, fills the coverage with length x width x pieces. Review the numbers before saving; rated coverage is usually a little less than the nominal area because of grout joints.
- Copy mapped values to all products: writes the values from your field map into the app's fields on every product where the app's field is still blank. Runs in the background and shows a notice when it finishes.
- Export CSV and Import CSV: see CSV import and export.
Where the values live
The values are Shopify product metafields under the app's own namespace, created when you install the app and pinned in the product editor. They belong to your store: a theme developer can read them in Liquid, other apps can read them, and they stay on your products if you ever uninstall the app.
Keeping the catalog complete
Once the first products are set up, create a catalog health rule for the collection they live in. From then on the app tells you which products are missing a value or a sample, instead of you finding out from a product page with no buy box.
Units
Square feet or square metres for areas, inches or centimetres for tile dimensions. Units are set once for the whole store in the app's settings.
CSV import and export
Export every product's values to a spreadsheet, fill in the blanks, and import them back. Rows are matched by product id or handle.