For the complete documentation index, see llms.txt. This page is also available as Markdown.

Mark pipeline as failed

Mark a pipeline as failed during execution to stop all running and queued stages.

You can manually stop a running pipeline by marking it as failed. The Mark as Failed button on the pipeline execution details page allows you trigger failure handling for the pipeline and its currently running stages.


What you will learn from this topic


Before you begin

  • Pipeline permissions: You must have Execute permissions on pipelines to mark a pipeline as failed. For more information, refer to Manage roles.

  • Account setting enabled: You must enable Allow users to mark a running Step as failure in your Harness account's default settings.


Mark a pipeline as failed

Perform the following steps to mark a running pipeline as failed:

  1. Navigate to the pipeline execution details page.

  2. Click Mark as Failed.

After you mark a pipeline as failed, Harness fails running and queued stages. Completed stages are not marked as failed.

If a pipeline is configured with failure strategy like Ignore Failure or Retry, the execution might continue even after Mark as Failure is sent.


Marking a Pipeline vs. a Stage as Failed

You can manually mark either an entire pipeline or an individual stage as failed. The behavior differs depending on whether other stages are running at the same time.

  • If only one stage is running when you mark the stage or pipeline as failed, both options have the same effect.

  • If multiple stages are running in parallel, marking the pipeline as failed stops all running stages. Marking a stage as failed stops only that stage.


Next steps

Last updated

Was this helpful?