Visibility Rules

Visibility Rules

Overview

Visibility rules let you dynamically control whether an option is shown, hidden, required, or restricted based on what the customer has selected or entered elsewhere in the calculator. They make your calculator interactive and context-aware — customers only see the fields relevant to their choices. Open any option in the calculator editor and switch to the Visibility Rules tab to configure them.

Steps

  1. Click Add rule inside the Visibility Rules tab.
  2. Set the logic mode — choose how multiple conditions are evaluated: All (every condition must be true), Any (at least one must be true), or None (no condition may be true).
  3. Choose an action — select what happens when the conditions are met: Show, Hide, Require, Limit, Hide values, or Show values (see Details below).
  4. Add conditions — each condition references another option or variable, an operator, and a comparison value. See Rule Conditions for the full condition reference.

Details

Show / Hide

Shows or hides the entire option when the rule's conditions match. A hidden option is removed from the calculator layout and its value is excluded from pricing and cart data.

Require

Makes the option required only when the rule's conditions match. Useful for fields that are optional in most cases but mandatory in specific configurations. Not available for display types.

Limit

Restricts the option's allowed inputs when conditions match. What you can limit depends on the option type:

Option Type Limit Settings
Number / Slider / Quantity Min value, Max value, Step increment
Text / Text Area / Email Min length, Max length, Regex pattern
Choice types (Dropdown, Radio, Checkbox, Button, Color Swatch, Image Swatch) Allowed values, Max selections
Date Picker Min date, Max date

Hide Values / Show Values

Available only for choice types (Dropdown, Radio, Checkbox, Button, Color Swatch, Image Swatch). Hide values removes specific choices from the list; Show values hides everything except the listed choices.

Examples

  • Conditional engraving — A Switch option "Add engraving?" controls visibility of a Text Box "Engraving text." You add a Show rule on the Text Box: when "Add engraving?" equals True, the text field appears.
  • Material-dependent sizes — A Dropdown "Material" has values Wood, Metal, and Acrylic. A Limit rule on the "Width" number input sets Max to 48 when Material equals Acrylic (because acrylic sheets only come up to 48 inches).

    • Related Articles

    • Value Rules

      Overview Value rules let you automatically set an option's value when certain conditions are met. Instead of the customer filling in a field manually, the calculator can pre-fill it, override it, or lock it to a specific value. This is useful for ...

    • Quantity Discount Rules

      Overview Quantity discount rules let you offer volume-based pricing — the more a customer buys, the bigger the discount. Calculator AI supports two modes: 1D (Simple), where discounts depend only on quantity, and 2D (Advanced), where discounts depend ...

    • Custom SKU Rules

      Overview Custom SKU rules let you automatically generate a unique SKU (Stock Keeping Unit) for every product configuration a customer creates. The SKU is built from fragments — short codes assigned to each option value — combined according to a ...

    • Rule Conditions

      Overview Conditions are the "if" part of every visibility rule and value rule. Each condition checks the current value of an option or variable and compares it using an operator. When the conditions on a rule are satisfied (based on the All/Any/None ...

    • Working with Options

      Overview Options are the building blocks of your calculator. Each option represents a field, choice, or display element that appears in the calculator on your storefront. This article covers how to manage options — adding, reordering, duplicating, ...