Parameters

Define inputs for your configurator: numbers, text, and selection lists.

Parameters are the inputs of your configuration. Each parameter has a short name (variable), a display name, a type, and a default value. Parameters are referenced in formulas using their short name prefixed with $ (e.g., $width).

Parameter Types

Number — numeric input with optional min, max, and step constraints.
Text — free-form text input.
List — selection from predefined options.
Material 3D — lets the user pick a 3D material (color, texture, PBR properties) from the library. Used in visualization rules via material3DSource: { type: "parameter", parameterRef: "$ColorFence" }.

Short Names (Variables)

Each parameter gets a short name like $width or $material. This is the identifier used in formulas. Short names must start with $ followed by a letter, and can contain letters, digits, and underscores. Cyrillic characters are supported.

$width    → number, default 1000, min 500, max 3000, step 100
$height   → number, default 2000
$material → list, options: aluminum, steel, wood

Number Constraints

Min — minimum allowed value (optional).
Max — maximum allowed value (optional).
Step — increment/decrement step for the input control (optional).
Default — initial value when the calculation form loads.

Dynamic Validation Rules

Dynamic Min / Dynamic Max — formulas that compute the allowed range from other variables.
Validation Formula — returns true when the value is valid and false when it should be rejected.
Validation Message — the text shown to the end user when the validation formula fails.
Visibility Condition — formula that hides or shows the parameter dynamically.

Write validation messages for the end user, not for the configurator author. For example: "Width must be greater than 0".

When you add a validation formula, the editor also lets you test it with a sample value. The preview uses that sample for the current parameter and current defaults for the rest of the configuration.

Input Parameters

When a configuration is used as a nested item inside another configuration, some parameters can be marked as "input" — meaning their values come from the parent configuration rather than being set directly.

Use drag-and-drop to reorder parameters. The order determines how they appear in the calculation form.

Quick Start Calculations