# chainctl images overlays detach

URL: https://chainguard-docs-preview-git-fork-eslerm-eslerm-custom-id-f0ac5e.chainguard.app/platform/chainctl/chainctl-docs/chainctl_images_overlays_detach.md
Last Modified: October 1, 2026
Tags: chainctl, Reference, Product

 chainctl images overlays detach Detach a Custom Assembly overlay from a repo.
Synopsis Detach a Custom Assembly overlay from a repo by deleting its binding.
The binding UID is printed by “attach” and shown under each overlay by “chainctl images overlays list”. The overlay itself is kept.
chainctl images overlays detach <BINDING_UID> [flags] Examples # Find the binding UID, then detach it chainctl images overlays list --parent my-org chainctl images overlays detach <BINDING_UID> Options inherited from parent commands --api string The url of the Chainguard platform API. (default "https://console-api.enforce.dev") --audience string The Chainguard token audience to request. (default "https://console-api.enforce.dev") --config string A specific chainctl config file. Uses CHAINCTL_CONFIG environment variable if a file is not passed explicitly. --console string The url of the Chainguard platform Console. (default "https://console.chainguard.dev") --force-color Force color output even when stdout is not a TTY. -h, --help Help for chainctl --issuer string The url of the Chainguard STS endpoint. (default "https://issuer.enforce.dev") --log-level string Set the log level (debug, info) (default "ERROR") -o, --output string Output format. One of: [csv, env, go-template, id, json, markdown, none, table, terse, tree, wide] -v, --v int Set the log verbosity level. SEE ALSO chainctl images overlays	- Manage Custom Assembly overlays and the repos they are attached to.