> 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/continuous-delivery/3.0/use-deployments/helm/step-library/helm-delete.md).

# Helm Delete

The Helm Delete step runs `helm uninstall` to remove a Helm release and all its associated Kubernetes resources from the cluster. Use it to clean up a release after deployment, tear down a test environment, or as a standalone cleanup step in a pipeline.

***

### Before you begin <a href="#before-you-begin" id="before-you-begin"></a>

Before you configure the step, make sure you have the following in place:

* **A Helm service:** Go to [Helm services](/continuous-delivery/3.0/use-deployments/helm/helm-services.md) to set up a service with a chart source and values files.
* **A Helm infrastructure:** Go to [Helm infrastructure](/continuous-delivery/3.0/use-deployments/helm/helm-infrastructure.md) to connect a cluster and namespace.
* **A Harness delegate in the target cluster:** The delegate runs deployment steps in the cluster.
* **Runtime configuration:** Every Helm stage requires a `runtime` block specifying a connector and namespace. Go to [Helm runtime configuration](/continuous-delivery/3.0/use-deployments/helm/overview.md#helm-runtime-configuration) to understand the required fields.

***

### Configure the step <a href="#configure-the-step" id="configure-the-step"></a>

The following parameters are available on the Helm Delete step.

| Parameter                 | Description                                                                                                                                                         | Required |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- |
| **Name**                  | Display name for this step in the stage canvas. Default: `Helm Delete`.                                                                                             | Required |
| **Release Name**          | The name of the Helm release to uninstall. When left empty, Harness uses the release name derived from the infrastructure definition.                               | Optional |
| **Dry Run**               | When enabled, runs the uninstall in dry-run mode without making any changes to the cluster. Use this to preview which resources would be removed. Default: `false`. | Optional |
| **Environment Variables** | Additional environment variables to pass into the Helm plugin execution.                                                                                            | Optional |
| **Command Flags**         | Additional flags to append to the `helm uninstall` command.                                                                                                         | Optional |

***

### How the step works <a href="#how-the-step-works" id="how-the-step-works"></a>

The step runs `helm uninstall <release-name> --namespace <namespace>` and removes all Kubernetes resources tracked in that Helm release from the cluster. Helm also removes the release history entry from the namespace.

If **Dry Run** is enabled, Harness runs `helm uninstall --dry-run` and prints the resources that would be deleted without making any changes to the cluster.

***

### Advanced settings <a href="#advanced-settings" id="advanced-settings"></a>

* **Timeout duration:** Maximum time the step can run before Harness terminates it.
* **On failure:** Define what happens if the step fails, such as retry, mark as success, or abort.
* **Strategy:** Configure a looping strategy to run this step over a list of values.
* **Conditional execution:** Run this step only when a specified condition is true.

***

### Next steps <a href="#next-steps" id="next-steps"></a>

* Go to [Helm Basic Deploy](/continuous-delivery/3.0/use-deployments/helm/step-library/helm-basic-deploy.md) to review the deploy step reference.
* Go to [Helm Rollback](/continuous-delivery/3.0/use-deployments/helm/step-library/helm-rollback.md) to review the rollback step reference.