Dimension Overlay — Setup and Configuration Guide

Content

1. Overview
2. Global Settings
3. Product-Level Settings (Standard Product)
4. Product-Level Settings (Modular Product)
5. Custom Dimensions
6. Controlling Dimensions per Embed Template
7. Practical Examples

Overview

The Dimension Overlay is a Babylon.js-powered system that renders interactive dimension lines directly on 3D product models inside the Mimeeq Configurator. It displays width, height, and depth as floating lines with pill-shaped labels — giving your customers clear, accurate size information.

Previously, dimension controls were limited: you could show or hide dimensions and set a display unit per product. Improvements to dimension feature introduce a significantly expanded set of controls, split across two levels: Global and Local.

Global Settings

Global settings define the default appearance and behavior of dimensions across all your products. Any product that hasn't been configured locally will automatically inherit these settings. To access global dimension settings, navigate to Settings → Global Template → Dimensions.

Dimension Visibility

This section controls which dimension lines are shown by default and how they behave when the camera moves.

Dimension Styling

This section controls the visual appearance of dimension lines and labels.

Pill Style has three options:

• Dark — The label pill has a dark background with light text. This is the default style and works well on light-coloured product backgrounds.
• Light — The label pill has a light background with dark text. Useful when the product or scene background is dark.
• Custom — Lets you manually set the pill background color, border color, and text color independently for full control over the look.

Dimension Units

This section defines which units are available in your configurator and which one is used by default. The units table lists all supported measurement units:

For each unit, you can set the Display Precision — the number of decimal places shown when that unit is active. This is useful when different markets expect different levels of precision (for example, showing centimeters with one decimal place vs. millimeters with no decimals). So the same physical dimension — say a 1200mm wide sofa — would display as 1200 mm, 120.5 cm, 1.205 m, or 47.24 in depending on which unit is active. You can edit these default precision values to match your market's conventions.

Use the Default checkbox to select which unit is active by default when a customer opens the configurator. Only one unit can be set as default at a time.

Product-Level Settings (Standard Product)

To control dimensions for a specific standard product, open the product, navigate to the 3D & AR tab, and expand the Dimensions accordion.

Show Dimensions

The first setting is a Show Dimensions dropdown with two options:

• No — Dimensions are hidden for this product.
• Yes — Dimensions are visible. Selecting Yes reveals all additional dimension settings described below.

Dimension Source

When Show Dimensions is set to Yes, you can choose where the dimension settings come from using the Dimension Source dropdown:

• Global Template — The product inherits all dimension settings from the global template. The sections for Dimension Visibility, Dimension Styling, and Dimension Units will be visible but not editable at the product level.
• Local Settings — All settings become editable, allowing you to override any value from the global template for this product only. This is useful when a specific product needs a different unit, style, or axis visibility than the rest of your catalogue.

Dimension Position

This section lets you control which side of the product each dimension line appears on, relative to the camera.

For each axis — Width, Height, and Depth — you can choose between three options:

Product-Level Settings (Modular Product)

To control dimensions for a modular product, open the modular product, navigate to Settings, and expand the Dimensions accordion.

Dimension Source

Unlike standard products, modular products do not have a Show Dimensions toggle — dimensions are available by default. You can choose where the dimension settings come from using the Dimension Source dropdown:

• Global Template — The modular product inherits all dimension settings from the global template, including Dimension Visibility, Dimension Styling, and Dimension Units. These settings are visible but not editable at the product level.
• Local Settings — All settings become editable, allowing you to override any value from the global template for this modular product only.

Dimension Position

Position override is available for modular products in the same way as standard products. You can control which side of the product each dimension line (Width, Height, Depth) appears on — Auto, Near, or Far. See the Dimension Position section above for a full description of each option.

Custom Dimensions

Custom dimensions allow you to display point-to-point measurements on a product that go beyond the standard width, height, and depth — for example, the seat width between armrests, or the height of a backrest from the seat cushion.

This is useful when the dimensions your customers actually care about are not the same as the overall bounding box. A sofa might be 200 cm wide overall, but what a buyer really needs to know is the seat width between the armrests, or the height of the backrest from the seat cushion — measurements that a bounding box simply cannot provide.

Custom dimensions are configured per product using the Rules system and are not part of the global template.

How to Set Up Custom Dimensions

1. Open the product and navigate to the Rules tab.
2. Click + Add rule and give it a name (e.g. "Custom dimensions").
3. Click + Add trigger and set Do you want to be triggered by to your preferred trigger — for example, Options if you want custom dimensions to appear only for a specific product configuration, or Always Active if they should always be present.
4. Click + Add action and set Select action type to Show Custom Dimensions.
5. Set Select when to run to Always and Select scope to All Devices.
6. Click Add Custom Dimension to add your first dimension.

For each custom dimension, configure the following fields:

Trigger mode options:

• With standard dimensions — the custom dimension is shown and hidden together with the standard dimensions (Width, Height, Depth), triggered by the dimension icon on the canvas. Use this when the custom dimension is always relevant alongside the standard ones.
• Independently — the custom dimension is hidden by default and must be shown and hidden using separate Show dimension and Hide dimension rule actions. Use this when you want to display a custom dimension only in specific contexts, such as when a user opens a particular option group.

You can add as many custom measurements as needed within a single rule by clicking Add Custom Measurement again for each one. Once you have created all custom dimensions, you can override its displayed value using a separate Override Dimensions rule action — for example, to show a rounded or nominal value instead of the exact measured distance between meshes.

How to Override Standard and Custom Dimensions

You can override the displayed value for both standard dimensions (Width, Height, Depth) and custom dimensions using the Override Dimensions rule action. This is useful when a product's nominal size differs from its exact geometry, or when different product configurations require different displayed values.

Override rules can be triggered by any condition available in the Rules system — either Always Active if the override should apply regardless of configuration, or by a specific option or option set if the value changes depending on what the customer selects.

How to set up an Override Dimensions rule:

1. Open the product and navigate to the Rules tab.
2. Click + Add rule and give it a name (e.g. "Dimension overrides").
3. Click + Add trigger and set Do you want to be triggered by to your preferred trigger — Always Active for a global override, or Options to target a specific size or configuration.
4. If triggering by options, select the relevant option set and choose the specific option value to trigger on (e.g. 220 cm).
5. Click + Add action and set Select action type to Override Dimensions.
6. Set Select when to run to Always and Select scope to All Devices.
7. Configure the three fields in the action row:

Repeat steps 3–7 for each size or configuration that requires a different value.

How to set up a Rounded Dimensions rule (modular product):

For modular products, you can use the Rounded mode to snap the measured dimension value to the nearest step size — for example, to round a measured 201.3 cm up to 210 cm when the rounding value is set to 10.

1. Open the modular product and navigate to the Rules tab.
2. Click + Add rule and give it a name (e.g. "Dimension rounding").
3. Click + Add trigger and set Do you want to be triggered by to your preferred trigger — Always Active to apply rounding globally, or Options to apply it only for a specific configuration.
4. Click + Add action and set Select action type to Round Dimensions.
5. Set Select when to run to Always and Select scope to All Devices.
6. Click Add rounding to add your first rounding rule.
7. Configure the two fields per row: Select dimension to round - the axis to round (Width, Height, or Depth) and Rounding value - the step size to round to, entered in your default unit (e.g. 100 rounds to the nearest 100 cm, 10 rounds to the nearest 10 cm).
8. Click Add rounding again to add rounding for additional axes as needed.

Controlling Dimensions per Embed Template

In addition to global and product-level settings, you can also control dimension behaviour at the embed template level. This includes options to show or hide dimensions for a specific embed, always show them on load, override the default unit, and display multiple units simultaneously.

These settings are covered in detail in the Embed Template article. See Embed Template Settings Guide.

Practical Examples

Example 1 — Override standard dimensions for a product

Use this when your product's 3D geometry doesn't exactly match the nominal size you want to show customers.

1. Create a rule and set the trigger to Always Active.
2. Add an Override Dimensions action.
3. Add one row per axis and set the mode to Override, entering the exact value to display.

Result: Every time the product loads, Width, Height, and Depth display your specified values instead of the raw measured geometry. Customers can show and hide these dimensions by clicking the dimension icon on the canvas.

Example 2 — Override a dimension per product size

Use this when a product comes in multiple sizes and each size needs a different displayed width. For example, your sofa is available in 100 cm, 120 cm, and 200 cm widths.

1. Create a rule named Dimension override — 100 cm and set the trigger to Options → Size → 100 cm.
2. Add an Override Dimensions action, select Width, set mode to Override, and enter 100.
3. Repeat for each size, creating a separate rule for 120 cm and 200 cm with the corresponding values.

Result: When a customer selects a size, the Width dimension updates to reflect the exact nominal measurement for that configuration. The dimension is shown and hidden together with the standard dimensions via the dimension icon on the canvas, as the Trigger mode is set to With standard dimensions.

Example 3 — Show a custom dimension independently based on an option

Use this when you want to display an additional measurement — such as back height — only when a customer opts in to seeing it, independent of the standard dimension controls. For example, your product has a Show back height option with Yes and No values.

1. Create a rule named Back height dimension and set the trigger to Options → Show back height → Yes.
2. Add a Custom Dimensions action, configure the mesh pair and label (e.g. Back height), and set Trigger mode to Independently.
3. Create a second rule triggered by Show back height → No with a Hide dimension action targeting the Back height dimension.

Result: The back height measurement only appears when the customer selects Yes, and disappears when they select No. Because the trigger mode is set to Independently, this dimension is not connected to the standard dimension icon on the canvas — it is controlled entirely by the Show and Hide rules you define.

If you have any questions or need help setting up your dimensions, feel free to reach out to our support team.

Updated on: 18/06/2026