---
name: "containers-storage-delete-layer"
section: "1"
platform: "linux"
package: "containers-common"
version: "1:0.69.2-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/containers-storage-delete-layer"
---

# containers-storage-delete-layer(1)

Delete a layer

## NAME

containers-storage-delete-layer - Delete a layer

## SYNOPSIS

**containers-storage** **delete-layer** *layerNameOrID*

## DESCRIPTION

Deletes a layer if it is not currently being used by any images or containers, and is not the parent of any other layers.

## EXAMPLE

```
containers-storage delete-layer my-base-layer
```

## SEE ALSO

[containers-storage-create-layer(1)](/containers-storage-create-layer/1.md) [containers-storage-delete-image(1)](/containers-storage-delete-image/1.md) [containers-storage-delete-layer(1)](/containers-storage-delete-layer/1.md)