---
name: "containers-storage-set-metadata"
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-set-metadata"
---

# containers-storage-set-metadata(1)

Set metadata for a layer, image, or container

## NAME

containers-storage-set-metadata - Set metadata for a layer, image, or container

## SYNOPSIS

**containers-storage** **set-metadata** \[*options* \[...\]\] *layerOrImageOrContainerNameOrID*

## DESCRIPTION

Updates the metadata associated with a layer, image, or container.  Metadata is intended to be small, and is expected to be cached in memory.

## OPTIONS

**-f \| --metadata-file** *filename*

Use the contents of the specified file as the metadata.

**-m \| --metadata** *value*

Use the specified value as the metadata.

## EXAMPLE

```
containers-storage set-metadata -m "compression: gzip" my-layer
```

## SEE ALSO

[containers-storage-metadata(1)](/containers-storage-metadata/1.md)