> ## Documentation Index
> Fetch the complete documentation index at: https://codspeed.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Benchmark Archival

> Learn how to archive and restore outdated benchmarks in CodSpeed

To keep your reports clean and relevant, you can **archive benchmarks that were
removed from your codebase**.

When benchmarks are **permanently removed** from your codebase, they will first
appear as "skipped" in reports due to the [partial runs](/features/partial-runs)
feature. You can then **archive** these benchmarks to remove them from future
reports.

<Tip>Archived benchmarks can be restored at any time if needed.</Tip>

## Effects of archiving a benchmark

An archived benchmark will be **completely removed from active reports**.

Archived benchmarks can be found in the benchmarks page. You can filter the list
by typing `is:archived` in the search bar or using the **Status** filter and
select the "Archived" option. Their individual dashboard pages remain accessible
with full historical data. They can be restored from there.

Archiving a benchmark on a pull request (where the benchmark was skipped) **will
remove the benchmark from the report**.

## How to archive a benchmark

<Note>
  **Archiving Permissions**

  When working with an organization's repository, **only the admins** are allowed
  to archive or restore benchmarks.
</Note>

### From the benchmark list

The most common way to archive benchmarks is when they are removed from your
codebase in a pull request.

1. Navigate to the branch page where the benchmarks were skipped
2. Filter the benchmark list by typing `is:skipped` in the search bar or using
   the **Status** filter and select the "Skipped" option
3. Select the benchmarks you want to archive using the checkboxes
4. Click the **Archive selected** button that appears in the list header

### From a benchmark's dashboard

You can also archive individual benchmarks from their dashboard:

1. Navigate to the benchmark's dashboard by clicking on its name in any report
2. Click the *Archive* button on the benchmark's dashboard
3. Confirm the archival action

## How to restore an archived benchmark

You can restore an archived benchmark at any time.

### From the benchmark list

If you added back some archived benchmarks to your codebase, you can restore
them from the corresponding branch page:

1. Navigate to the branch page and filter the benchmark list by typing
   `is:archived` in the search bar or using the **Status** filter and select the
   "Archived" option
2. Select the benchmarks you want to restore using the checkboxes
3. Click the **Restore selected** button that appears in the list header

### From a benchmark's dashboard

1. Navigate to the archived benchmark's dashboard
2. Click the *Restore* button
3. The benchmark will reappear in active reports

## Related Features

<Columns cols={2}>
  {" "}

  <Card title="Partial Runs" href="/features/partial-runs" icon="forward">
    Understand when benchmarks become skipped and may need archiving
  </Card>

  <Card title="Ignoring Benchmarks" href="/features/ignoring-benchmarks" icon="eye-slash">
    Ignore flaky benchmarks while keeping the code (different from archiving
    removed code)
  </Card>

  {" "}
</Columns>