Dimensions and detail rows

Furniture shoppers check measurements before anything else. Weft reads them from dimension metafields and can show them in centimeters and inches at once. The Product details section below the product adds collapsible rows for the description, dimensions, materials and care, delivery, and your own text.

Dimension metafields #

Create these in Settings > Metafields and metaobjects > Products > Add definition, each with type Dimension and Storefronts access. Create only the ones you use.

Then open each product and fill in the values in the Metafields card. A dimension value has a number and a unit, for example 220 and cm.

Dimensions per size #

If a product comes in sizes, give each size its own measurements with variant metafields:

1. Go to Settings > Metafields and metaobjects > Variants > Add definition.
2. Create custom.width, custom.depth and custom.height (or any of the six keys above) with type Dimension and Storefronts access, the same keys as on products.
3. Open the product, click a variant, and fill in its values in the Metafields card.

Weft reads each measurement from the selected variant first and falls back to the product's own value. You only need variant values for the measurements that change. For example, give the product a depth and height, and give each size variant its width. When a shopper picks another size, the Dimensions block and the Dimensions detail row update with it.

Dimensions block #

A compact line in the buy column, for example "W 220 × D 98 × H 78 cm". On the product page, click the Dimensions block in the Product section:

• Heading: optional.
• Units: As entered shows the unit you typed. Metric and imperial adds the other unit: centimeters, millimeters and meters convert to inches, inches and feet convert to centimeters.
• Text when the product has no dimensions: for example "Made to your measurements. Contact us." Leave empty to hide the block on products without dimensions.

The block shows the selected variant's measurements, as described in dimensions per size.

Product details section #

The section has a heading column on the left (heading, text and an optional image) and detail rows on the right. Each row is a Detail row block. Pick what it shows in Content:

Every row also has Heading, Text and Open by default. The text shows below the row's own content.

Text that differs per product #

Any row's Text can come from a product metafield:

1. Create a product metafield definition, for example custom.care_notes with type Rich text or Multi-line text.
2. In the theme editor, click the row, then the connect icon next to Text, and choose the metafield.

Products without a value show only the row's own content. A row with nothing to show is hidden on the live store.

A drawing per product #

The Dimension drawing setting is one image for the template. To show a different drawing per product, create a product metafield with type File (images only), fill it in on each product, and connect Dimension drawing to it with the connect icon.

Troubleshooting #

• No measurements show. Check the keys (custom.width, not custom.product_width), that the type is Dimension and not text, and that the product has values.
• The measurements don't change with the size. Check that the variant definitions use the same keys as the product ones and have Storefronts access, and that the selected variant has values. A variant without its own value shows the product's.
• The Dimensions row is missing on some products. The row shows when the product or its first variant has a value. Fill in the product's own values as the fallback.
• Only one unit shows. Set Units to Metric and imperial. Yards aren't converted.
• The Materials and care row is empty. The product doesn't use the fabric picker, or the fabric has no composition, features or care. Add text to the row for products without fabrics.