Type Conversion Block
Type Conversion is intended for text, number, boolean, list, date, and object conversion, but schema, UI, and runtimes currently need parity cleanup.
At a glance
What it does
Type Conversion changes one variable into another data type and saves it to an output variable.
The public docs should stay conservative here because schema, local runtime, and cloud runtime do not currently agree on all target type names and conversions.
Use it when
- Convert scraped numeric text before Calculate.
- Turn simple values into text for templating.
- Normalize booleans when the input is predictable.
Do not use it when
- The conversion target is list/date/object and has not been verified in your runtime.
- You need formatting operations; use Format.
- The input can contain messy or ambiguous data.
Settings
Type Conversion needs a source variable, target type, and output variable. Verify target type behavior before relying on it.
Source variable
Required: Yes- Variables
- Variable name
- Description
- Variable to convert.
Target type
Required: Yes- Variables
- No
- Description
- Configured type to convert into.
Output variable
Required: Yes- Variables
- Variable name
- Description
- Variable that receives the converted value.
Outputs
Type Conversion writes the converted value to the output variable.
{{outputVariableName}}anyConverted value. Exact type depends on target type and runtime support.
Example Flow
Use Type Conversion before Calculate or Conditional when the next Block expects a specific primitive type.
- Extract or read a value.
- Convert it to the needed type.
- Use the converted output variable later.
Errors and fixes
Start with symptoms visible in the editor or Inspector, then check the earliest Block that produced the wrong page state, variable, or output.
The conversion fails or differs by runtime.
- Check
- Check the target type and current parity note.
- Fix
- Verify in the runtime you will use, or use Format/Calculate for narrower transformations.
A number conversion fails.
- Check
- Check whether the input contains currency symbols, commas, or extra text.
- Fix
- Clean the value with Format before converting.
Local and cloud runs
Known parity risk: schema/UI/local/cloud do not fully agree on supported target type names. Do not broaden this page until the implementation is aligned.