Timeout settings

Configure timeout settings for steps, stages, and pipelines to prevent excessive execution times.

Timeout settings help prevent steps, stages, and pipelines from running excessively long. For example, this can help end a pipeline naturally if a step enters an endless loop or other long-lasting or infinite failure condition.

---

What you will learn from this topic

• How to configure step timeouts to limit step execution time.

• How to configure stage timeouts to limit stage execution time.

• How to configure pipeline timeouts to limit overall pipeline execution time.

---

Before you begin

• Pipeline permissions: You must have Edit permissions on pipelines to configure timeout settings. For more information, refer to Manage roles.

---

Step timeouts

When configuring a step, you can set the step Timeout under the Step Parameters tab. The default is usually 10 minutes.

Step timeouts mark steps as expired in the following scenarios:

• The step does not complete before the configured timeout.

• The stage or pipeline reaches the stage or pipeline timeout limit when the step is still running.

---

Stage timeout

Find the stage Timeout settings under Overview > Advanced when configuring your stage.

Stage timeouts mark stages as expired in the following scenarios:

• The stage does not complete before the configured timeout.

• The pipeline reaches its timeout limit when the stage is still running.

When a stage timeout is less than its total step execution time, the failure strategy applied is EXPIRE_ALL, preventing rollback. This occurs because child nodes (steps) inherit the expired status from the stage, stopping further execution.

---

Pipeline timeouts

Find the Pipeline Timeout Settings under the Advanced Options section in the right navbar.

The pipeline timeout applies to the duration of the entire pipeline. It does not override stage or step timeouts, but stages and steps will timeout if the pipeline timeout limit is hit while a stage or step is running.

Approvals

Approval steps and stages can pause execution but they do not stop the pipeline timeout counter. Make sure that the pipeline timeout setting accommodates the time required for approvals.

---

Next steps

• Define a failure strategy on stages and steps: Configure automated actions to take when timeouts occur.

• Runtime inputs: Use runtime inputs to make timeout values configurable at execution time.