Skip to content

Spec sheet

A technical table on the product page: six rows of label and value, each row reading a product metafield so one template describes your whole catalogue.

  1. Create the metafield definitions you want to show — Settings → Custom data → Products. See Metafields.
  2. On the product page in the theme editor, Add block → Spec sheet.
  3. Type the Row 1 label — “Material”. Row 2’s fields appear as soon as row 1 has a label, and so on: the panel only ever shows one empty row ahead of you.
  4. Type the metafield the row reads into Row 1 metafield (namespace.key). The first four rows already read custom.material, custom.weight, the three Dimension metafields and custom.care.
  5. Repeat for as many rows as you need.
Setting Notes
Heading Default “Specifications”.
Row 1–6 label The row’s name. Defaults for the first four: Material, Weight, Dimensions, Care.
Row 1–6 metafield The product metafield the row reads (namespace.key). Several keys separated by commas are joined with ×: the Dimensions row reads custom.width, custom.height, custom.depth and shows “12 × 12 × 18 cm”. A measurement (Dimension, Weight) comes with its unit. Defaults for the first four: custom.material, custom.weight, the three dimensions, custom.care.
Row 1–6 value Fixed text, shown on products without a value in the row’s metafield.
  • A row whose value is empty is dropped from the table.
  • A product with no values at all shows no table — not a heading, not an empty frame.

So the block can go into the template before every product is documented.

Label Metafield Type
Material custom.material Single line text
Weight custom.weight Weight
Dimensions custom.width Dimension
Care custom.care Single line text
Finish your own Single line text
Includes your own Single line text

Dimensions point at the same custom.width / custom.height / custom.depth as the Size reference block. It is the same measurement shown twice, once as a drawing and once as a number — not two values to keep in step. The row lists the three keys and the theme joins whatever the product has with ×.

Why six fixed rows and not repeatable blocks

Section titled “Why six fixed rows and not repeatable blocks”

Six pairs, revealed one at a time, keeps the panel short while still letting every value come from your product data, and the row order stays the merchant’s.

Six is also about as much as a customer reads. If you need more, a Collapsible row block with a longer table in it is the better home for the rest.

  • Put the spec sheet above the add-to-cart button when the numbers decide the purchase — that is what the Plinth preset does, where material, dimensions and edition are the wall label of the work.
  • Keep units consistent across the catalogue. A Weight metafield carries its own unit, which is why it is the right type for weight.
  • Use the same labels on every product. A table whose rows change name from product to product is harder to read than no table.