---
layout: default
navsection: userguide
title: "Trashing and untrashing data"
...
{% comment %}
Copyright (C) The Arvados Authors. All rights reserved.

SPDX-License-Identifier: CC-BY-SA-3.0
{% endcomment %}

Collections have a sophisticated data lifecycle, which is documented in the architecture guide at "Collection lifecycle":{{ site.baseurl }}/architecture/keep-data-lifecycle.html#collection_lifecycle.

Arvados supports trashing (deletion) of collections. For a period of time after a collection is trashed, it can be "untrashed". After that period, the collection is permanently deleted, though there may still be ways to recover the data, see "Recovering data":{{ site.baseurl }}/admin/keep-recovering-data.html in the admin guide for more details.

# "*Trashing (deleting) collections*":#delete-collection
# "*Recovering trashed collections*":#trash-recovery

{% include 'tutorial_expectations' %}

h2(#delete-collection). Trashing (deleting) collections

A collection can be trashed using workbench or the arv command line tool.

h3. Trashing a collection using Workbench

To trash a collection using Workbench, open the ︙ action menu for the collection, and select *Move to trash*. You can do this from the collection page directly, or from the project listing that contains the collection.

h3. Trashing a collection using arv command line tool

<pre>
arv collection delete --uuid=zzzzz-4zz18-xxxxxxxxxxxxxxx
</pre>

h2(#trash-recovery). Recovering trashed collections

A collection can be untrashed / recovered using workbench or the arv command line tool.

h3. Untrashing a collection using Workbench

To untrash a collection using Workbench, open the *Trash* page from the left navigation menu. For each collection in this listing, you can press the *Restore* button on the far right to untrash it. You can also open a collection to review its contents. From that collection page, you can open the ︙ action menu and select *Restore* to untrash the collection.

!{width: 80%}{{ site.baseurl }}/images/trash-buttons.png!

h3. Untrashing a collection using arv command line tool

You can list the trashed collections using the list command.

<pre>
arv collection list --include-trash=true --filters '[["is_trashed", "=", "true"]]'
</pre>

You can then untrash a particular collection using arv using it's uuid.

<pre>
arv collection untrash --uuid=zzzzz-4zz18-xxxxxxxxxxxxxxx
</pre>

The architecture section has a more detailed description of the "data lifecycle":{{ site.baseurl }}/architecture/keep-data-lifecycle.html  in Keep.