> For the complete documentation index, see [llms.txt](https://ecomnius.gitbook.io/formrest/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ecomnius.gitbook.io/formrest/woocommerce/product-dimensions.md).

# Product Dimensions

Add assembled product sizes that shoppers can read in cm or inches.

Formrest shows the size of each product on the product page, product cards, quick view, the bag and search results. The data comes from the **Dimensions** tab added by **Formrest Core**.

## What to enter

Dimensions are the **assembled size of the product**, in **centimeters**, on four axes:

* **Width (cm)**
* **Depth (cm)**
* **Height (cm)**
* **Seat height (cm)** – for chairs, sofas and stools.

Packaged size and weight for shipping stay in WooCommerce's own **Shipping** tab; they are not shown as product dimensions.

## Add dimensions to a product

**Step 1** – Go to **Products** and edit a product.

**Step 2** – In the **Product data** box, open the **Dimensions** tab.

**Step 3** – Enter the values you know and click **Update**.

## Variations

Each variation has its own four fields under **Product data > Variations**.

* Leave a variation field empty to **use the product value** for that axis. The placeholder shows the value that will be used.
* Fill a field only where the variation is different, for example a wider version of the same sofa.
* When a shopper chooses a variation, the dimensions on the page update. If the new variation has no value for an axis, the old value is removed rather than kept.

## Rules

* Use plain decimal numbers: `82.5` or `82,5`. Values are rounded to 2 decimals.
* Don't type units, thousands separators or `0`. Values like `90cm`, `1,200` or `0` are rejected and the previous value is kept; an error is shown at the top of the screen.
* **Empty means unknown.** An empty axis is not shown. If a product and all its variations have no dimensions, the dimensions block is hidden.

## cm / in switch

Shoppers can switch between centimeters and inches. The choice is remembered on their device and applies to every dimensions block on the page. You always enter the values in centimeters.

## Import and export

WooCommerce's CSV importer and exporter (**Products > Import / Export**) include four columns: **Formrest Width (cm)**, **Formrest Depth (cm)**, **Formrest Height (cm)** and **Formrest Seat Height (cm)**. They are matched automatically during import. Only the columns present in the file are written.

## Using dimensions in templates

* The block is added to the product summary automatically, before the Add to cart button.
* In an Elementor or Kitify template you can place it with the shortcode `[formrest_product_dimensions]`, or `[formrest_product_dimensions id="123"]` for a specific product.
* The **Formrest Product Space**, **Formrest Size Comparison** and **Formrest Size Studio** widgets draw footprints from the same data. See [Formrest Widgets](/formrest/elementor/formrest-widgets.md).
