Dimension

The Dimension option lets customers enter custom measurements (e.g., width, height, length) for products that require exact sizing, such as bed sheets, furnitures, etc.

In addition to collecting measurements, you can set up a custom formula that uses the entered values to calculate product pricing automatically. This ensures that pricing scales seamlessly with customer inputs, providing both flexibility for shoppers and efficiency in store management.

Basic Option Settings:

1. Option Name

The internal name used to identify the Dimension option within your app’s settings. This name does not appear on the storefront product page but helps keep your options organized.

2. Label on Product

This text appears above the Dimension option on the product page, guiding customers on the type of measurement or formula they need to enter.

3. Label on Cart

The text that appears on the Cart summary screen, Checkout, and Order detail page, next to the measurements. This ensures the option name is clearly associated with the customer's order.

4. Required Field

This setting ensures that the customer must upload a file before proceeding with their purchase. If enabled, the Dimension option becomes mandatory.

5. Hide "Label on Product"

This option allows you to hide the label that typically appears above the Dimension fields, streamlining the interface if the label is unnecessary.

6. Value X / Value Y / Value Z

You can configure up to three dimensions (X, Y, Z).

• Label – Set the name of each dimension (e.g., Width, Length, Height).

• Unit – Define the measurement unit (e.g., cm, inch, meter).

• Default – Set the initial value shown in the input field.

• Min / Max – Define the acceptable input range for each dimension.

💡 Tip: The built-in Dimension type supports up to 3 inputs. For more, you can add another Dimension option to your option set.

7. Calculate Price

Enable this option to apply dynamic pricing based on customer-entered dimensions.

• Base Price – The starting unit price applied to the formula.

• Price Formula – Set up a custom calculation (e.g., x * y * {{price}} for square area, or x * y * z * {{price}} for volume).

  • x, y, z = customer-entered values.

  • {{price}} = the base price per unit defined above.

Notes:

• The formula calculates the total price including the main product price.

• To avoid double-counting the product’s base price:

  1. Set the main product price to $0.00 and hide the price in your product template (recommended).

  2. If that’s not feasible, and all your products share the same base price, please contact support for a custom solution.

8. Conditional Logic

Set rules that determine when the File Upload option should be displayed or hidden based on other selections made by the customer. For instance, the option might only appear if a customer selects a specific product variant.

Advanced Option Settings:

1. Class Name

Add a custom CSS class name to apply specific styles to the Dimension option.

2. Tooltip

Provide a short explanation that appears when customers hover over the option. Useful for quick hints.

3. Help Text

Add longer, detailed information directly below the Dimension option. This helps customers better understand their choices at each stage.