Multi-stage pipelines user experience

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2020

The multi-stage pipelines experience brings improvements and ease of use to the Pipelines portal UI. This article shows you how to view and manage your pipelines using this new experience.

You can view and manage your pipelines by choosing Pipelines from the left-hand menu.

View pipelines

You can drill down and view pipeline details, run details, pipeline analytics, job details, logs, and more.

At the top of each page is a breadcrumb navigation bar. Select the different areas of the bar to navigate to different areas of the portal. The breadcrumb navigation is a convenient way to go back one or more steps.

Breadcrumb navigation

  1. This area of the breadcrumb navigation shows you what page you're currently viewing. In this example, the page is the run summary for run number 20191209.3.
  2. One level up is a link to the pipeline details for that run.
  3. The next level up is the pipelines landing page.
  4. This link is to the FabrikamFiber project, which contains the pipeline for this run.
  5. The root breadcrumb link is to the Azure DevOps fabrikam-tailspin organization, which contains the project that contains the pipeline.

Many pages also contain a back button that takes you to the previous page.

Pipelines back button

Pipelines landing page

From the pipelines landing page you can view pipelines and pipeline runs, create and import pipelines, manage security, and drill down into pipeline and run details.

Choose Recent to view recently run pipelines (the default view), or choose All to view all pipelines.

Choose Recent to view recently run pipelines or choose All to view all pipelines.

Select a pipeline to manage that pipeline and view its runs. Select the build number for the last run to view the results of that build, select the branch name to view the branch for that run, or select the context menu to run the pipeline and perform other management actions.

Pipeline context menu

Select Runs to view all pipeline runs. You can optionally filter the displayed runs.

View pipeline runs

Select a pipeline run to view information about that run.

Once you're done, use the breadcrumb navigation bar to navigate to the pipeline's details page.

View pipeline details

The details page for a pipeline allows you to view and manage that pipeline.

Pipeline details

Choose Edit to edit your pipeline. For more information, see YAML pipeline editor.

Pipeline settings

You can view and configure pipeline settings from the More actions menu on the pipeline details page.

Pipeline settings and more actions


Select Runs to view the runs for that pipeline. You can optionally filter the displayed runs.

Pipeline runs

You can choose to Retain or Delete a run from the context menu. For more information on run retention, see Build and release retention policies.

Pipeline run context menu


Select Branches to view the history or run for that branch. Hover over the History to view a summary for each run, and select a run to navigate to the details page for that run.

Pipeline branches


Select Analytics to view pipeline metrics such as pass rate and run duration. Choose View full report for more information on each metric.

Pipeline analytics

View pipeline run details

From the pipeline run summary you can view the status of your run, both while it is running and when it is complete.

Pipeline run summary

From the summary pane you can download artifacts, and navigate to linked commits, test results, and work items.

Cancel and re-run a pipeline

If the pipeline is running, you can cancel it by choosing Cancel. If the run has completed, you can re-run the pipeline by choosing Run new.

Cancel pipeline run

Pipeline run more actions menu

From the More actions menu you can download logs, add tags, edit the pipeline, delete the run, and configure retention for the run.

Pipeline run summary more actions menu


You can't delete a run if the run is retained. If you don't see Delete, choose Stop retaining run, and then delete the run. If you see both Delete and View retention releases, one or more configured retention policies still apply to your run. Choose View retention releases, delete the policies (only the policies for the selected run are removed), and then delete the run.

Jobs and stages

The jobs pane displays an overview of the status of your stages and jobs. This pane may have multiple tabs depending on whether your pipeline has stages and jobs, or just jobs. In this example, the pipeline has two stages named Build and Deploy. You can drill down into the pipeline steps by choosing the job from either the Stages or Jobs pane.

Pipeline jobs

Choose a job to see the steps for that job.

Pipeline tasks

From the steps view, you can review the status and details of each step. From the More actions you can toggle timestamps or view a raw log of all steps in the pipeline.

Pipeline tasks more actions menu

Manage security

You can configure pipelines security on a project level from the More actions on the pipelines landing page, and on a pipeline level on the pipeline details page.

Pipeline security

To support security of your pipeline operations, you can add users to a built-in security group, set individual permissions for a user or group, or add users to predefined roles. You can manage security for Azure Pipelines in the web portal, either from the user or admin context. For more information on configuring pipelines security, see Pipeline permissions and security roles.

Task insights for failed pipeline runs

Azure DevOps provides a Task Insights for Failed Pipeline Runs setting, that when enabled, provides pop-up notifications of build failures with a link to view a report.

This task has failed pop-up.

To configure this setting, navigate to Preview features, find Task Insights for Failed Pipeline Runs, and choose the desired setting.

Task insights for failed pipeline runs setting.

Next steps

Learn more about configuring pipelines in the language of your choice:

Learn more about building Azure Repos and GitHub repositories.

To learn what else you can do in YAML pipelines, see Customize your pipeline, and for a complete reference see YAML schema reference.