On Fail

Last updated on October 28, 2026

You can set on_first_failure to define behavior when a phase reaches FAIL.

execution:
  on_first_failure: continue

main:
  - name: Calibration
    python: calibrate
  - name: Functional Test
    python: test_functions

With continue, remaining phases execute even after a failure. The default stop behavior cancels any phases that haven't started yet. Phases already running finish, and teardown phases still run.

on_first_failure applies to the FAIL, ERROR and TIMEOUT outcomes. A phase can override it with then. A phase retried through then: <outcome>: retry follows on_first_failure once its retries run out, see When Retries Run Out.

How is this guide?

On this page