> For the complete documentation index, see [llms.txt](https://developer.harness.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.harness.io/artifact-registry/3.0/registries/delete-a-registry.md).

# Delete a registry

Soft delete or permanently delete a registry, restore it from the Deleted view, and understand what happens to its artifacts during retention.

{% hint style="info" %}
This feature is in Beta[^1] and requires enablement. [View all early access features.](https://developer.harness.io/release-notes/features.md)

{% @harness-feature-flag-access/request-feature-flag-access module="artifacts" pagePath="artifacts/registries/delete-a-registry" pageTitle="Delete%20a%20registry" featureFlags="%5B%7B%22name%22%3A%22Soft%20delete%20for%20registries%20and%20artifacts%22%2C%22key%22%3A%22HAR\_SOFT\_DELETE\_SUPPORT%22%2C%22status%22%3A%22BETA%22%2C%22description%22%3A%22Enables%20soft%20delete%20for%20registries%2C%20packages%2C%20and%20versions%2C%20with%20a%20configurable%20retention%20window%20before%20permanent%20removal.%22%7D%5D" %}
{% endhint %}

Deleting a registry removes it from the **Registries** list. Harness supports two deletion modes:

* **Soft delete**: the registry moves to a **Deleted** view. Its packages, images, and versions are soft deleted at the same time. Nothing is downloadable during the retention window, but you can restore it before the window closes.
* **Permanent delete**: the registry and all its contents are removed immediately. This cannot be undone.

When soft delete is enabled for your account, Harness defaults to soft delete. You can switch to permanent delete in the confirmation dialog.

{% hint style="warning" %}
Permanently deleting a registry removes all packages, images, versions, and other artifacts it contains in one step. Confirm the registry name and contents before proceeding.
{% endhint %}

## Before you begin

Your role must include **Delete** permission on Artifact Registry. Go to [RBAC and permissions](https://developer.harness.io/artifact-registry/3.0/reference/rbac-and-permissions.md) for details.

## Delete from the Registries list

1. In the navigation menu, select **Registries**.
2. Find the registry, click the three-dot menu (**⋮**) at the end of its row, and select **Delete**.
3. In the confirmation dialog, type the exact registry name to confirm.
4. To permanently delete instead of soft delete, select the **Permanently delete** checkbox.
5. Click **Delete**.

## Delete from inside the registry

1. Open the registry you want to delete.
2. Click the three-dot menu (**⋮**) next to **Setup Client** in the top right.
3. Select **Delete**, type the exact registry name to confirm, optionally select **Permanently delete**, then select **Delete** again to finish.

## What happens after a soft delete

* The registry disappears from the **Available** list immediately.
* Its packages, images, and versions are soft deleted at the same time.
* Nothing in the registry is downloadable; clients that attempt to pull receive HTTP 404.
* The registry and its contents remain in storage and count toward your storage usage until the retention window expires.
* You can restore the registry at any time before the retention window closes.

After restoring an upstream proxy registry, clients must re-pull cached artifacts because the upstream proxy cache is empty after restoration.

## Restore a soft deleted registry

1. In the navigation menu, select **Registries**.
2. Click **Show** and select **Deleted**.
3. Find the registry, click the three-dot menu (**⋮**), and select **Restore**.

The registry returns to the **Available** list. Its soft deleted artifacts are also restored.

## Permanently delete from the Deleted view

If a registry is already soft deleted and you want to remove it immediately:

1. Go to **Registries** > **Show: Deleted**.
2. Find the registry, click the three-dot menu (**⋮**), and select **Delete**.

This is permanent and cannot be undone.

## Soft deleted artifact content

The **Registries** > **Deleted** view shows registry rows only. To view, restore, or permanently delete individual packages and versions that were soft deleted when the registry was deleted, go to the global **Artifacts** list and switch **Show** to **Deleted**.

Go to [Delete an artifact or version](https://developer.harness.io/artifact-registry/3.0/artifacts/delete-an-artifact.md) for the full artifact deletion workflow.

## Troubleshooting

<details>

<summary>The Delete option does not appear in the menu</summary>

Your role may not include **Delete** permission on Artifact Registry. Contact your account administrator to review your role assignments.

</details>

<details>

<summary>Can I recover a permanently deleted registry?</summary>

No. Permanent deletion is irreversible. The registry and all its contents are removed immediately. If you selected permanent delete by mistake, contact [Harness Support](mailto:support@harness.io); recovery is not guaranteed and depends on backup availability.

</details>

<details>

<summary>Storage is still being counted after I soft deleted the registry</summary>

Soft deleted items remain in storage until the retention window expires and the scheduled purge runs. To free storage immediately, permanently delete the registry from the **Deleted** view.

</details>

## Next steps

* [Create a registry](https://developer.harness.io/artifact-registry/3.0/registries/create-a-registry.md)
* [Delete an artifact or version](https://developer.harness.io/artifact-registry/3.0/artifacts/delete-an-artifact.md)
* [Lifecycle management overview](https://developer.harness.io/artifact-registry/3.0/lifecycle-management/overview.md)

[^1]: Off by default. If you want to try it and share feedback, request access and Harness will turn it on for your account. Beta features can change and may not be ready for production use.
