> For the complete documentation index, see [llms.txt](https://help.accentuate.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.accentuate.io/use-case-guides/home-and-living/dimensions.md). # Dimensions OVERVIEW The Dimensions field captures the measurable physical size and weight attributes of a Home & Living product. Structured dimension data is critical for purchase confidence: a customer must be able to verify that a sofa will fit through a doorway, that a dining table seats six comfortably, or that a bookshelf will fill a specific alcove — before they buy. Each dimension is a separate field entry with a clear label and unit. Do not store all dimensions in a single text block. Structured individual values enable filtering ('show me all desks under 120cm wide'), feed AI space-planning tools, and allow retailers to build automated fit-check features. BUSINESS VALUE Why this field matters * Dimensions are the primary return-prevention tool — most home product returns cite wrong size as the reason * Structured dimension data enables size filtering on collection pages — customers can find products that fit their space * AI-powered room planning tools require structured dimensions to place products in virtual spaces * Trade and contract buyers require dimensions in structured format for specification documents and CAD drawings * Accurate packaged dimensions reduce logistics costs by enabling precise freight calculation * Weight data is required for shipping rate calculation and for customers assessing whether they can self-install ACF SETUP How to configure this field in Accentuate Custom Fields | Where | ACF dashboard → Templates tab → Product scope → Add new field | | ----------- | ------------------------------------------------------------- | | Label | Dimensions | | Name / Key | dimensions | | Namespace | accentuate (default) | | Field type | Shopify >> Single-line text (List) | | Multi-value | Yes — each dimension is a separate labelled entry |
| Critical: Each dimension entry must include its label AND unit. Do not enter '120' — enter 'Width: 120 cm'. Without labels and units, dimension data becomes ambiguous and unusable for filtering or display. | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | STEP-BY-STEP IN ACF * Open ACF, go to Templates tab and select the Product scope * Click 'Add new field' * Label: 'Dimensions' — Key auto-fills as 'dimensions' * Namespace: leave as 'accentuate' * Field type: Shopify >> Single-line text (List) * Enable 'Allow multiple selections' — dimensions are always multi-value (height, width, depth minimum) * Click Done, then Save * For each product, enter every relevant dimension as a separate labelled entry in cm and kg | Shopify admin (optional pinning): Settings → Custom data → Products. Namespace: 'accentuate', Key: 'dimensions', Type: Single-line text (List). Pinning is highly recommended — dimensions are the most frequently needed field during product data entry. | | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
REFERENCE VALUES Standard dimension labels — always include the unit (cm or kg) | Value format | When to use | | ------------------------------------- | ------------------------------------------------------------------------------------------------------ | | Height: 80 cm | Vertical measurement — tables, chairs, shelving, lamps, storage | | Width: 120 cm | Horizontal measurement (left to right) — desks, sofas, beds, wardrobes | | Depth: 40 cm | Front-to-back measurement — shelving, sofas, storage units | | Length: 200 cm | Longest horizontal dimension — dining tables, rugs, beds (use instead of Width when length is primary) | | Diameter: 60 cm | Circular products — round tables, pendant shades, bowls, mirrors | | Seat height: 45 cm | Distance from floor to seat surface — chairs, sofas, stools | | Table thickness: 2.5 cm | Tabletop or shelf thickness — relevant for design and structural context | | Weight: 15 kg | Product weight — critical for self-installation decisions and freight calculation | | Volume: 30 L | Internal capacity — storage boxes, laundry baskets, planters, bins | | Folded dimensions: 80 x 40 x 10 cm | Compact state dimensions — folding chairs, tables, clothes airers | | Packaged dimensions: 130 x 50 x 20 cm | Shipping box dimensions — required for freight rate accuracy | | Max load: 50 kg | Maximum supported weight — shelves, storage units, stools, benches | \
BEST PRACTICES * Always standardise on centimetres (cm) and kilograms (kg) — do not mix cm and mm, or kg and lbs, within a catalogue * Label every entry clearly: 'Width: 120 cm' not '120 cm' — unlabelled numbers are ambiguous * Include packaged dimensions for all products — this is required for accurate freight calculation * For seating, always include seat height alongside overall height — customers need both * For storage products, always include internal volume or internal dimensions alongside external dimensions * For folding or extendable products, include both configurations (folded/extended, closed/open) COMMON MISTAKES * Entering all dimensions as a single text string: 'W120 x D40 x H80 cm' — this prevents filtering and AI parsing * Omitting units: '120' means nothing without 'cm' * Mixing unit systems across a catalogue: some products in cm, others in mm or inches * Confusing Height with Seat height for chairs — these are different measurements and both matter * Leaving out packaged dimensions — this creates freight calculation errors and increased shipping costs * Not updating dimensions when a product variant (size) is added — each variant may need its own dimension set IN CONTEXT | Extendable Dining Table — White Oak |


| | ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- | | Room | Dining room | | Style | Scandinavian, Minimalist | | Material | Solid wood (oak), Metal (steel) | | Dimensions | Height: 75 cm, Width: 90 cm, Length: 160 cm (closed), Length: 220 cm (extended), Weight: 42 kg, Packaged dimensions: 175 x 95 x 25 cm | | Assembly required | Full assembly required (tools included) |
DEVELOPER IMPLEMENTATION | Liquid note: Shopify >> List — use .value for the array. Render dimensions in a structured specification table — this is the most referenced section of any home product page. | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
Liquid — Storefront Rendering \|

{% comment %}

Dimensions — Shopify >> Single-line text (List)

Namespace: accentuate | Key: dimensions

Render as a spec table — critical for purchase confidence

{% endcomment %}

{% assign dims = product.metafields.accentuate.dimensions.value %}

{% if dims != blank %}

\

\

Dimensions & Specifications\

\

\

{% endif %}

| \| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Pro tip: Use dimension data to build a 'Will it fit?' feature. Filter collections by Width metafield value to let customers set a maximum width before browsing — this dramatically reduces returns from size mismatch. | | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
SEE ALSO * Assembly required — large dimensions often correlate with flat-pack delivery and assembly complexity * Room — room type informs which dimensions are most relevant to display prominently * Indoor / Outdoor — outdoor dimensions may require weatherproofing allowances | Full ACF documentation: help.accentuate.io \| Metafield Definitions → Fields → Field data type → Shopify field types | | -------------------------------------------------------------------------------------------------------------------- |
--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://help.accentuate.io/use-case-guides/home-and-living/dimensions.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.