Parameters

Set up numbers, lists, on/off switches, text, materials, and image inputs.

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.
On / off — a true/false setting shown as a switch in the calculation, not a slider from 0 to 1. In formulas, use If($hasGate; ...; ...), for example.
Text — free-form text input.
List — selection from predefined options.
3D material — lets the user pick a color or textured material from the library. Assign this parameter as the material source in the specification item's 3D settings.
Personalisation slot (image) — an image input for configured branding, such as a logo. The corresponding surface must also be set up in the 3D rules.

Select a parameter in Outline and change Type in Inspector → Basic. Configure list options and numeric limits in Behavior. Changing a type can affect formulas and existing values, so test the result in Preview. For a list, add options first and select its default; for on / off, set the initial switch state.

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.

Guided learning and validation Calculated values