Mark stage as failed

Mark a stage as failed during pipeline execution to abort running steps and trigger failure strategies.

You can manually mark a specific stage as failed during pipeline execution. When you mark a stage as failed, Harness aborts any currently-running delegate tasks and triggers configured failure strategies.

---

What you will learn from this topic

• How to configure a failure strategy for manually marked stage failures.

• How to mark a stage as failed during pipeline execution.

---

Before you begin

• Pipeline permissions: You must have Execute permissions on pipelines to mark a stage 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.

---

Configure failure strategy

Failure strategies define the actions to take when a stage fails. You can configure failure strategies for different failure conditions.

If a stage marked as failed has no specified failure strategy, Harness uses the default failure strategy.

Perform the following steps to configure a failure strategy for manual stage failure:

1. In your pipeline, select the stage where you want to configure a failure strategy.

2. Click the Advanced tab.

3. Under Failure Strategy, click Add.

4. For On failure of type, select User Marked Failure.

5. For Perform Action, select the desired action to take when the stage is marked as failed, such as Rollback or Retry.

6. Click Save.

---

Mark a stage as failed

Perform the following steps to mark a stage as failed during pipeline execution:

1. Go to the execution details for a currently-running pipeline.

2. Select the stage you want to mark as failed, and click Mark Stage As Failed.

In the execution history, the stage's Error Summary reports User Initiated Failure, and the stage's failure type is USER_MARKED_FAILURE.

Parallel stages

If you need to fail multiple stages running parallel, you must select Mark Stage as Failed for each parallel stage.

If you only mark one of the parallel stages as failed, the other stages must complete before the failure strategy applies for the failed stage.

---

Next steps

• Define a failure strategy on stages and steps: Configure automated failure handling strategies for different error conditions.

• Mark pipeline as failed: Mark an entire pipeline as failed instead of a single stage.