CalcTree Help Pages
  • What is CalcTree?
  • Getting started
    • CalcTree Pages
    • Create a CalcTree Page
    • Add a calculation
    • Collaborate with a colleague
  • Calculations
    • Parameters
      • Math formulas
        • Parameter Data Types
        • Native Functions
          • Arithmetic Functions
          • Trigonometric Functions
          • Logical & Comparison Functions
          • Matrix & Vector Functions
          • Probability & Combinatorics Functions
          • Statistical Functions
          • String Functions
          • Utility Functions
          • Other Native Functions
        • Valid Expression Syntax
      • Supported Units
      • Dropdown List Parameters
        • Linking CSV Data to Dependent Dropdowns in CalcTree
      • Parameter Settings
    • Integrations
      • Python in CalcTree
        • Adding a Python Source
        • Defining Parameters in Python
        • Referencing Other Parameters in Python
        • Working with Units in Python
        • Creating Tables and Visuals in Python
        • Consuming Files in Python
        • Using Pre-installed Python Libraries
      • Spreadsheets [Coming Soon!]
      • File Upload
        • CSV files
      • 3rd Party Software Plugins
        • Excel
        • Grasshopper
        • ETABS [v20 & v21]
        • ETABS [v22]
        • SAP 2000
        • CSI Bridge [v26]
    • Templates [Coming Soon!]
    • Optimising your calculations
  • Pages & Reports
    • CalcTree Documents
    • Static content
    • Parametric content
      • Parametric equation
      • Inputs
      • Outputs
  • Export to PDF
  • API
    • GraphQL API
      • Generating an API key
      • Queries
        • GetCalculation
        • Calculate
      • Examples
        • Bulk calculations with Python
  • Collaborate
    • Add members
    • Review and approval
    • Add stakeholders
  • Administrate
    • CalcTree Workspace
    • Versioning and Audit trail
  • CalcTree for System Administrators
Powered by GitBook
On this page
  • 1D Dropdowns
  • 2D Dropdowns (Label/ID Pairs)
  1. Calculations
  2. Parameters

Dropdown List Parameters

Make your calculations interactive with selectable inputs.

PreviousSupported UnitsNextLinking CSV Data to Dependent Dropdowns in CalcTree

Last updated 26 days ago

You can turn any parameter with a predefined list of options into a dropdown selector using the viewer setting in the right-hand panel (RHS).

This allows users to choose from a set of options directly on the page. The selected value can then be used as an input in other parts of your calculation, making your page more interactive and user-friendly.

1D Dropdowns

  • Create a parameter with a list (e.g. ["Option A", "Option B", "Option C"]).

  • In the parameter settings in the right-hand side panel set the Viewer, option to list.

  • The parameter will now render as a selection dropdown on the page.

  • Not that the formula for your parameter will update to ctselect([array]), and cannot be edited when in list view. Switch back to a a parameter to edit the values.

Example parameter definition

Material = ["Concrete", "Steel", "Timber"]

This creates a parameter where users can pick between Concrete, Steel, or Timber, and the selected value can be referenced in your formulas.

2D Dropdowns (Label/ID Pairs)

You can also define dropdown options using a list of lists to separate user-facing labels from internal values.

Example Format:

List: '[[1, "One"], [2, "Two"], [3, "Three"]]',

In this structure:

  • The second item in each inner list (e.g. "One", "Two", "Three") is shown in the dropdown as the label.

  • The first item (e.g. 1, 2, 3) is the value that gets returned when the user makes a selection — this is referred to as the id.

This setup is especially useful when you want user-friendly labels on the interface but use more technical or numeric values in your calculations.