Failures in on-run-start hooks

Removed in v2

This flag was removed in v2. The new behavior is always enabled. If you're upgrading, remove this flag from your dbt_project.yml.

skip_nodes_if_on_run_start_fails	dbt v1 Latest	dbt v1
Introduced	2024.10	1.9.0
Matured (default → true)	2026.09	1.12.0
Removed	—	v2.0

Starting in dbt v1.12, skip_nodes_if_on_run_start_fails defaults to true, skipping all selected resources if there is a failure on an on-run-start hook.

For more information, refer to on-run-start / on-run-end.

Impact

If your project uses on-run-start hooks for non-critical work (for example, telemetry, notifications, audit inserts, attaching session settings), your build stops producing output whenever a hook fails. Tables and views that previously refreshed daily will stop updating the next time the hook fails.

 Recommended actions

If every model is skipped after an on-run-start hook fails, find which on-run-start hook failed in the run log — it appears as an ERROR immediately before all the nodes marked SKIP. From there, either remove the hook if it's not required, or fix the root cause of the failure by reviewing the hook's SQL statements.

To opt out of this behavior, set the flag to false:

dbt_project.yml

flags:
  skip_nodes_if_on_run_start_fails: false

Report incorrect code

Was this page helpful?

Privacy policyCreate a GitHub issue

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.