Save to State

With the Save to State action, you can save temporary values to the state. This is useful when, for example, you want to use the same value in multiple steps of your workflow.

To configure the action, first you need to create a variable to store the value you want to save or select one from the Variable dropdown if you've created it before. When creating a variable, make sure to select the proper variable type. Then, you need to pass the data you want to save in the New value field. The saved value will be available as {{state.<key>}} in all actions and components.

Examples

Saving the result of the previous step

{{data}}

You can always adjust the data before saving it.

Saving values with JS Code action

state.varName = 'newValue';

// or using setValue method
state.setValue('varName', 'newValue');

Reading state values

const value = state.getValue('varName');

Resetting variables

Reset a variable to the initial value

state.resetValue('varName');

Reset all variables

// reset all variables, page and app state
state.resetValues();

// reset all page variables
state.resetValues('page');

// reset all app (global) variables
state.resetValues('app');

Adding additional values

const values = {{ui.form.value}};

return {
  ...values,
  created_at: new Date(),
}

The created_at column must exist in the table schema, otherwise it won't be sent.

Changing values

const values = {{ui.form.value}};
return {
  ...values,
  name: values.name.toUpperCase(),
}

Deleting unwanted values

const values = {{ui.form.value}};
delete values.age;
return values;

alternatively:

const values = {{ui.form.value}};
const { created_at, ...rest } = values;
return rest;

Joining array values

const values = {{ui.form.value}};
return {
  ...values,
  tags: values.tags.join(','),
}

Using default values

const values = {{ui.form.value}};
return {
  ...values,
  // if the value is not set, use the default value
  created_at: values.created_at || new Date(),
}