---
title: The Pipeline Runs Table
---

The pipeline runs table is a [customizable](#customizing-the-runs-table) list of the pipeline's runs. Use it to
view a run's details, and manage runs (create, continue, or abort). The runs table's auto-refresh allows users 
to continually monitor run progress.

View the runs table in table view <img src="/docs/latest/icons/ico-table-view.svg" alt="Table view" className="icon size-md space-sm" />, 
details view <img src="/docs/latest/icons/ico-split-view.svg" alt="Details view" className="icon size-md space-sm" />, 
or comparison view <img src="/docs/latest/icons/ico-charts-view.svg" alt="Comparison view" className="icon size-md space-sm" />
using the buttons on the top left of the page. Use the details view to access a selected run's details, while keeping 
the run list in view. Details view can also be accessed by double-clicking a specific pipeline run in the table view to 
open its details view. Use the [comparison view](#comparing-runs) to compare your pipeline run's scalar and plot results. 
This view compares the scalars/plots of currently selected pipeline runs. If no runs are selected, The first 100 visible 
runs in the table are compared.

You can archive pipeline runs so the runs table doesn't get too cluttered. Click **OPEN ARCHIVE** on the top of the 
table to open the archive and view all archived runs. From the archive, you can restore 
runs to remove them from the archive. You can also permanently delete runs.

You can download the pipeline runs table as a CSV file by clicking <img src="/docs/latest/icons/ico-download.svg" alt="Download" className="icon size-md space-sm" /> 
and choosing one of these options:
* **Download onscreen items** - Download the values for pipeline runs currently visible on screen  
* **Download all items** - Download the values for all runs in this pipeline that match the current active filters  

The downloaded data consists of the currently displayed table columns.

![Pipeline runs table](../../img/webapp_pipeline_runs_table.png)

## Run Table Columns

The models table contains the following columns:

| Column | Description | Type |
|---|---|---|
| **RUN** | Pipeline run identifier  |  String |
| **VERSION** | The pipeline version number. Corresponds to the [PipelineController](../../references/sdk/automation_controller_pipelinecontroller.md#class-pipelinecontroller)'s and [PipelineDecorator](../../references/sdk/automation_controller_pipelinecontroller.md#class-automationcontrollerpipelinedecorator)'s `version` parameter | Version string |
| **TAGS** | Descriptive, user-defined, color-coded tags assigned to run. | Tag |
| **STATUS** | Pipeline run's status. See a list of the [task states and state transitions](../../fundamentals/task.md#task-states). For Running, Failed, and Aborted runs, you will also see a progress indicator next to the status. See [here](../../pipelines/pipelines.md#tracking-pipeline-progress). |  String |
| **USER** | User who created the run.  |  String |
| **STARTED** | Elapsed time since the run started. To view the date and time of start, hover over the elapsed time.  |  Date-time |
| **UPDATED** | Elapsed time since the last update to the run. To view the date and time of update, hover over the elapsed time. |  Date-time |
| **RUN TIME** | The current / total running time of the run. | Time |
| **_Metrics_** | Add metrics column (last, minimum, and/or maximum values). Available options depend upon the runs in the table. | Varies according to runs in table |
| **_Hyperparameters_** | Add hyperparameters. Available options depend upon the runs in the table. | Varies according to runs in table |

## Customizing the Runs Table

Customize the table using any of the following:
* Dynamic column ordering - Drag a column title to a different position.
* Show / hide columns - Click <img src="/docs/latest/icons/ico-settings.svg" alt="Setting Gear" className="icon size-md" /> 
  to view and select columns to show. Click **Metric** and **Hyperparameter** to add the respective custom columns
* [Filter columns](#filtering-columns)
* Sort columns
* Resize columns - Drag the column separator to change the width of that column. Double-click the column separator for 
  automatic fit.

Changes are persistent (cached in the browser) and represented in the URL, so customized settings can be saved in a 
browser bookmark and shared with other ClearML users.

:::note Float Values Display
By default, the runs table displays rounded up float values. Hover over a float to view its precise value in the 
tooltip that appears. To view all precise values in a column, hover over a float and click <img src="/docs/latest/icons/ico-line-expand.svg" alt="Expand" className="icon size-md" />.  
:::

### Filtering Columns

Filters can be applied by clicking <img src="/docs/latest/icons/ico-filter-off.svg" alt="Filter" className="icon size-md" /> 
on a column, and the relevant filter appears.

There are a few types of filters:
* Value set - Choose which values to include from a list of all values in the column
* Numerical ranges - Insert minimum and/or maximum value
* Date ranges - Insert starting and/or ending date and time
* Tags - Choose which tags to filter by from a list of all tags used in the column. 
  * Filter by multiple tag values using the **ANY** or **ALL** options, which correspond to the logical "AND" and "OR" respectively. These 
    options appear on the top of the tag list.
  * Filter by the absence of a tag (logical "NOT") by clicking its checkbox twice. An `X` will appear in the tag's checkbox.
  
Once a filter is applied to a column, its filter icon will appear with a highlighted dot on its top right (<img src="/docs/latest/icons/ico-filter-on.svg" alt="Filter on" className="icon size-md" />).  

To clear all active filters, click <img src="/docs/latest/icons/ico-filter-reset.svg" alt="Clear filters" className="icon size-md" /> 
in the top right corner of the table.

:::note
The following table customizations are saved on a per-pipeline basis:
* Columns order
* Column width
* Active sort order
* Active filters
* Custom columns
:::

## Create Run
To launch a new run for a pipeline, click **+ NEW RUN** on the top left of the page. This opens a **NEW RUN** modal, where 
you can set the run's parameters. By default, the fields are pre-filled with the last run's values. 

Click **Advanced configurations** to change the run's execution queue.  

![New run modal](../../img/webapp_pipeline_new_run.png)

After clicking **RUN**, the new pipeline run is enqueued in the specified queue, and the run is added to the pipeline run table. 


## Run Actions

The following table describes the actions that can be done from the run table, including the [states](../../fundamentals/task.md#task-states)
that allow each operation.  

Access these actions with the context menu in any of the following ways:
* In the pipeline runs table, right-click a run, or hover over a pipeline and click <img src="/docs/latest/icons/ico-dots-v-menu.svg" alt="Dot menu" className="icon size-md space-sm" />
* In a pipeline info panel, click the menu button <img src="/docs/latest/icons/ico-bars-menu.svg" alt="Bar menu" className="icon size-md space-sm" />

| Action | Description | States Valid for the Action | State Transition |
|---|---|---|---|
| Details | View pipeline details. Can also be accessed by double-clicking a run in the pipeline runs table. | Any state |  None  |
| Run | Create a pipeline run. Configure and enqueue it for execution. See [Create Run](#create-run).  | Any State | *Pending* |
| Abort | Manually stop / cancel a run. | *Running* / *Pending* | *Aborted* |
| Continue | Rerun with the same parameters. |  *Aborted* | *Pending* |
| Add Tag | User-defined labels added to runs for grouping and organization. | Any state |  None  |
| Archive | Move pipeline run to the pipeline's archive. | Any state |  *Pending* to *Draft*  |
| Restore | Action available in the archive. Restore a run to the active pipeline runs table. | Any state | None |
| Delete | Action available in the archive. Delete a run and its steps, which will also remove all their logs, results, artifacts and debug samples | Any State | N/A |

<div class="max-w-50">

![pipeline run context menu](../../img/webapp_pipelines_context_menu.png)

</div> 

Most of the actions mentioned in the chart above can be performed on multiple runs at once.
[Select multiple runs](#selecting-multiple-runs), then use either the context menu, or the bar that appears at the bottom 
of the page, to perform operations on the selected runs. Actions can be performed only on the runs that match the action criteria 
(for example, only *Aborted* pipeline runs can be continued). The context menu shows the number of runs that can be 
affected by each action. The same information can be found in the bottom menu, in a tooltip that appears when hovering 
over an action icon. 

## Selecting Multiple Runs

Select multiple runs by clicking the checkbox on the left of each relevant run. Clear any existing selection 
by clicking the checkbox in the top left corner of the table.

Click the checkbox in the top left corner of the table to select all items currently visible.

An extended bulk selection tool is available through the down arrow next to the checkbox in the top left corner, enabling 
selecting items beyond the items currently on-screen:
* **All** - Select all runs in the pipeline
* **None** - Clear selection
* **Filtered** - Select all runs in the project that match the current active table filters 

## Comparing Runs
The comparison view compares pipeline run scalar and plot results. When selected, the view presents a comparison of all 
[selected runs](#selecting-multiple-runs). If no runs are selected, the first 100 visible runs in the table are compared.

In the dropdown menu, select to view **Scalars** or **Plots**.

**Scalars** shows pipeline run scalar results as time series line graphs. 

![Scalar line graphs](../../img/pipelines_comparison_scalars.png)

All single value scalars are plotted into a single clustered bar chart under the "Summary" title, where each cluster 
represents a reported metric, and each bar in the cluster represents an experiment.

![Single scalar comparison](../../img/pipelines_comparison_single_scalar.png)

Click <img src="/docs/latest/icons/ico-settings.svg" alt="Setting Gear" className="icon size-md" /> to customize which 
metrics to view.

In the **Scalars** view, click <img src="/docs/latest/icons/ico-tune.svg" alt="Tuning" className="icon size-md" /> to access [scalar plot tools](../webapp_exp_track_visual.md#scalar-plot-tools).

**Plots** shows the last reported iteration sample of each metric/variant combination per compared run. 

Line, scatter, box, and bar graphs are compared by overlaying each metric/variant from all compared runs' into a single 
comparative plot.

![Merged plots](../../img/pipelines_comparison_plots_merged.png)

Other plot types are displayed separately for each run.

![Side-by-side plots](../../img/pipelines_comparison_plots.png)


### Run Details Comparison
For a more in depth comparison of pipeline runs, select the runs to compare and click **Compare** in the batch action 
bar. In the run comparison pages, you can compare details, hyperparameters, scalars, plots, and debug samples. For more 
information, see [Comparing Experiments](../webapp_exp_comparing.md).