Skip to main content

Sheet Calc

Evaluates spreadsheet formulas and returns calculated results.

Overview

The Sheet Calc node applies spreadsheet formula logic to your workflow data. Use it to:

  • Apply familiar spreadsheet functions
  • Calculate values using cell-style formulas
  • Leverage Lido's formula capabilities in workflows
  • Execute spreadsheet actions with CHAIN()

Parameters

ParameterDescriptionRequired
Sheet ExpressionThe spreadsheet formula to evaluateYes
Context CellCell reference for evaluation contextNo
Split RowsCreate separate items for multi-row resultsNo
Run ActionExecute as action command using CHAIN()No
Lido Spreadsheet URLOverride the default spreadsheetNo

Sheet Expression

Write spreadsheet formulas. Supports expressions with {{...}} to inject item data:

=SUM({{$item.data.values}})
=IF({{$item.data.amount}} > 1000, "High", "Low")
={{$item.data.price}} * {{$item.data.quantity}}

Context Cell

Specify a cell location (e.g., Sheet1!A1) to provide spreadsheet context for formula evaluation. This affects relative references in the formula.

Split Rows

When the formula returns multiple rows, create separate output items for each row instead of returning them all in one item.

Run Action

When enabled, the expression is executed as an action command using CHAIN(). Use this for formulas that perform actions rather than just returning values.

Output

The evaluated result. By default returns a 2D array of calculated values.

Single value result:

{
"result": 500
}

Multi-row result (split enabled): Multiple items, one per row.

Multi-row result (split disabled):

{
"result": [[1, 2], [3, 4], [5, 6]]
}

Examples

Basic Calculation

Calculate a percentage:

={{$item.data.value}} * 0.1

Using Spreadsheet Functions

Apply text functions:

=UPPER({{$item.data.name}})
=CONCATENATE({{$item.data.firstName}}, " ", {{$item.data.lastName}})

Conditional Logic

Use IF for conditional values:

=IF({{$item.data.amount}} > 1000, "High", "Normal")

Math Functions

Apply mathematical operations:

=ROUND({{$item.data.price}} * {{$item.data.quantity}}, 2)

Array Formulas

Sum an array of values:

=SUM({{$item.data.values}})

Reference Spreadsheet Data

Reference cells in your spreadsheet:

=VLOOKUP({{$item.data.productId}}, Products!A:C, 3, FALSE)

Tips

  • Uses Lido's spreadsheet formula engine
  • Inject item data using {{\$item.data.fieldName}} syntax
  • Standard spreadsheet functions are available
  • Use Context Cell for formulas with relative references
  • Enable Split Rows when each row should be processed separately
  • Use Run Action for formulas that trigger side effects