Documentation Index Fetch the complete documentation index at: https://docs.penbox.io/llms.txt
Use this file to discover all available pages before exploring further.
penscript supports arithmetic, number formatting, and numeric comparisons. These operators are used in computed form fields, premium calculations, validation rules, and automation conditions.
Addition: :sum Returns the sum of all numbers in a list.
{ ":sum" : [ 11 , 5 , 6 , -2 ] } // Result: 20
Works with variables:
{ ":sum" : [ "{data.amount_1}" , "{data.amount_2}" , "{data.amount_3}" ] } // Scope: { "data": { "amount_1": 100, "amount_2": 250, "amount_3": 50 } } // Result: 400
Also used for date arithmetic — see the Dates & time page for details.
Subtraction: :substract Returns the sequential subtraction of all numbers in a list. The first value is the starting point, and each subsequent value is subtracted from it.
{ ":substract" : [ 100 , 30 ] } // Result: 70 { ":substract" : [ 100 , 20 , 5 ] } // Result: 75
Works with variables:
{ ":substract" : [ "{data.total}" , "{data.discount}" , "{data.tax}" ] } // Scope: { "data": { "total": 500, "discount": 75, "tax": 25 } } // Result: 400
Also supports date arithmetic — see the Dates & time page for details.
Multiplication: :product Returns the product of all numbers in the input array.
{ ":product" : [ 5 , 3 ] } // Result: 15 { ":product" : [ "{data.quantity}" , "{data.unit_price}" ] } // Scope: { "data": { "quantity": 4, "unit_price": 25 } } // Result: 100
Commonly used inside :pipe for sequential transformations:
{ ":product" : [ "@value" , 2 ] } // Result: double the current @value
Division: :divide Divides the first number by the second.
{ ":divide" : [ 100 , 4 ] } // Result: 25 { ":divide" : [ "{data.total}" , "{data.count}" ] } // Scope: { "data": { "total": 750, "count": 3 } } // Result: 250
Power: :power Raises a base to an exponent.
{ ":power" : [ 2 , 3 ] } // Result: 8 { ":power" : [ 10 , 2 ] } // Result: 100
Min / Max: :min, :max Returns the lowest or highest value from an array.
{ ":max" : [ 3 , 7 , 2 , 9 , 1 ] } // Result: 9 { ":min" : [ 3 , 7 , 2 , 9 , 1 ] } // Result: 1
Works with variables:
{ ":max" : [ "{data.offer_a}" , "{data.offer_b}" , "{data.offer_c}" ] }
Fixed Decimals: :to-fixed Converts a number to a string with a fixed number of decimal places. Defaults to 2 digits if :digits is not specified.
{ ":to-fixed" : 123.456 } // Result: "123.46" { ":to-fixed" : 123.456 , ":digits" : 1 } // Result: "123.5" { ":to-fixed" : 99 , ":digits" : 2 } // Result: "99.00"
Works with variables:
{ ":to-fixed" : "{data.price}" , ":digits" : 2 } // Scope: { "data": { "price": 49.9 } } // Result: "49.90"
Type Coercion: :number Converts a value to a number. Useful when form inputs are strings that need to be used in calculations.
{ ":number" : "123" } // Result: 123 { ":number" : "45.67" } // Result: 45.67 { ":number" : "abc" } // Result: NaN
Works with variables:
{ ":number" : "{data.quantity}" } // Scope: { "data": { "quantity": "10" } } // Result: 10
Formats a number for display. Use :digits to control decimal precision.
{ ":digits" : 0 , ":format-number" : { ":product" : [ 0.7355 , "{data.horses_power}" ] } } // Scope: { "data": { "horses_power": 110 } } // Result: 81
{ ":digits" : 2 , ":format-number" : { ":sum" : [ "{data.subtotal}" , "{data.tax}" ] } } // Scope: { "data": { "subtotal": 99.5, "tax": 20.895 } } // Result: 120.40
Age Calculation: :age Calculates age in years from a date value. Typically used as an inline pipe (see Dates & time for the full reference), but also available as an operator in numeric contexts.
"{data.birthdate | age}" // → 34 { ":cmp" : "{data.birthdate | age}" , ":gte" : 18 } // → true if the person is 18 or older
Numeric Comparisons Use :cmp with numeric values for conditional logic based on calculations:
{ ":if" : { ":cmp" : "{data.price}" , ":gte" : 100 }, ":then" : "Premium tier" , ":else" : "Standard tier" } // Scope: { "data": { "price": 110 } } // Result: "Premium tier"
Combining arithmetic with comparison:
{ ":if" : { ":cmp" : { ":sum" : [ "{data.deductible}" , "{data.premium}" ] }, ":gt" : 10000 }, ":then" : "Requires approval" , ":else" : "Auto-approved" }
Next Steps
Logic & comparisons Conditional logic with numeric results
Dates & time Date arithmetic with :sum
Loops & arrays Aggregate calculations on collections
Variables & scope Referencing numeric data
