Visual workflows

Test a workflow with representative sample data

A workflow test runs a configured action against a real row. It helps uncover missing fields and connection problems before the workflow is enabled.

Updated

By Kition Docs

Verified against Kition 0.2.0 (7d49036f) on 2026-11-06

Choose a sample that exercises the mapping

Use a row that contains the values your action actually needs. For an email, that includes the recipient and content fields; for a record action, it includes values compatible with the destination table. A completely blank record is rarely a useful success test.

Treat a test as a real execution. Send test email and Run with sample deliver a message; Run now creates a real record; record tests update the table. Only a filter’s Run with sample row is a dry run that changes nothing. Choose a controlled destination and label the sample clearly.

Run and inspect a controlled test

  1. Save the trigger and action settings and resolve the reported field errors.
  2. Select the action on the canvas and find its test section: Test step for Send email, Test with real data for Add record, or Test action for other record actions.
  3. Pick an existing row (Use existing row), and check field substitutions and the destination before running.
  4. Run the test and read its result or error.
  5. Verify the real output, then repeat with an important edge case such as a missing optional value.

Cover more than one result

Useful workflow test inputs
SampleWhat it checks
Complete normal recordThe intended mapping and output
Missing optional valueHow incomplete information appears
Different real categoryWhether assumptions were too narrow
Row a filter should stopThat the run is marked skipped

Promote a tested configuration carefully

After a successful test, inspect the destination rather than relying only on a success message. A message can be sent to the wrong recipient, and a record can be created with values in the wrong fields. Validation confirms the settings are complete; review confirms your intent.

Test runs from Test step are kept out of the regular run history. Save any corrections and rerun the relevant test before enabling. When the table, connection, or body changes later, repeat the check that covers that dependency instead of assuming an old test remains valid.

Version and sources

This guide describes the Kition desktop app as of source 7d49036f, checked on 2026-11-06. Connected actions also depend on the configured model provider or service. If your installed version is older, some controls may differ.

Related pages

Ready when you are.

Kition is a desktop AI workspace for connected documents, structured tables, editable designs, whiteboards, visual workflows, and reviewable AI agents.