> ## Documentation Index > Fetch the complete documentation index at: https://docs.tokenfactory.nebius.com/llms.txt > Use this file to discover all available pages before exploring further. # tag - Tag or untag an image Assign or remove a tag from an image. Tags are human-readable names that make images easier to reference. ## Examples ```bash theme={null} # Tag an image contree tag 3f2a7b... my-app:v1.0 # Remove a tag contree tag 3f2a7b... my-app:v1.0 --delete # Use the tagged image eval $(contree use tag:my-app:v1.0) ``` ## Help output
\$ contree tag --help
usage: contree tag \[-h] \[-U] ARG \[ARG ...]

Assign or remove a tag from an image.

Tags provide human-readable names for image UUIDs, making them easier
to reference in commands like \`contree use tag:NAME\`.

With one argument, tags the current session image.
With two arguments, the first is the image reference and the second is the tag.

Use -U/--delete/--rm to remove a tag instead of assigning one.

positional arguments:
  ARG                 TAG (current image) or IMAGE\_REF TAG

options:
  -h, --help          show this help message and exit
  -U, --delete, --rm  Remove tag from image

examples:
  contree tag python-dev:latest            # tag current session image
  contree tag UUID python-dev:latest       # tag specific image by UUID
  contree tag tag:alpine:latest my-alpine  # re-tag by reference
  contree tag -U UUID my-tag               # remove a tag (or --delete/--rm)

for coding agents:
  mutating command
  default action assigns tag; use --delete to remove mapping

agent note:
  Before using this command in an automated workflow, read:
    contree agent
## Usage Tags are free-form strings. A common convention is `scope/purpose:version`: ```bash theme={null} contree tag UUID ubuntu-with-curl:latest contree tag UUID my-project/dev-env:v2 ``` Once tagged, reference the image anywhere with the `tag:` prefix: ```bash theme={null} contree use tag:ubuntu-with-curl:latest ``` Tagging an image that already has a different tag replaces the old tag. ## See also * [images - List and import images](./images) – list images and their tags * [Your First Sandbox](../tutorial/first-steps) – working with images