> 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/use-artifact-registry/manage-registries/delete-registry.md).

# Delete Registries

{% hint style="info" %}
**FEATURE FLAG**

Soft-delete (the default delete behavior described below) is behind the feature flag `HAR_SOFT_DELETE_SUPPORT`. Contact [Harness Support](mailto:support@harness.io) to enable it. Without the flag, the **Permanently delete** path is the only way to remove a registry.
{% endhint %}

This procedure removes an artifact registry from the project. By default, Harness **soft-deletes** the registry: it moves off the **Available** tab on **Artifact Registries** and appears under **Deleted**, where you can restore it or delete it permanently until your retention policy applies. **Soft-deleting a registry applies to everything inside it in one step:** every package, image, and version stored in that registry is soft-deleted together with the registry row (you do not keep artifacts in **Available** while only the registry row is deleted).

{% hint style="warning" %}
Permanently deleting a registry removes all packages, images, versions, and other artifacts it contains in one step. That action cannot be undone through the **Deleted** tab. Confirm the scope before you proceed.
{% endhint %}

### Delete from the registries list <a href="#delete-from-the-registries-list" id="delete-from-the-registries-list"></a>

1. Go to **Artifact Registries** (or **Registries** in the sidebar).
2. Find the registry, open the row menu (⋮) on the right, and select **Delete**.
3. In the confirmation dialog, type the registry name when prompted. For a soft delete, keep **Permanently delete** cleared. Select **Permanently delete** when you want immediate removal through the permanent path described in the warning above.

<figure><img src="/files/hiKNwILcq4XoIZnDtr8m" alt="Row menu on a registry showing the Delete option"><figcaption><p>Delete a registry from the registries list</p></figcaption></figure>

### Delete from registry details <a href="#delete-from-registry-details" id="delete-from-registry-details"></a>

1. Open the registry you want to remove.
2. Select the menu (⋮) next to **Setup Client**, then **Delete**.
3. Complete the confirmation dialog as described above.

<figure><img src="/files/9v050iGdp0UZ8aiuD00w" alt="Registry detail page menu showing the Delete option next to Setup Client"><figcaption><p>Delete a registry from the registry details page</p></figcaption></figure>

### Soft-deleted registries <a href="#soft-deleted-registries" id="soft-deleted-registries"></a>

After a soft delete, open **Registries** and select the **Deleted** tab. This view lists the **registry** itself—one row per soft-deleted registry. Use the row menu (⋮) to **Restore** or **Delete** (permanent removal).

<figure><img src="/files/xFChrq8V5If3NNKnsE6O" alt="Artifact Registries Deleted tab with row menu showing Restore and Delete"><figcaption><p>Deleted tab: open the row menu to restore or permanently delete</p></figcaption></figure>

Soft-deleted **packages**, **versions**, and other artifact content appear on the **Artifacts** page under **Deleted** (and in scoped views inside a registry or package). **Artifact Registries** → **Deleted** lists the registry row only. For that flow, go to [Manage deleted artifacts](/artifact-registry/use-artifact-registry/manage-artifacts/soft-delete.md).