docker/metadata-action

Health v2 · maintenance only

Adoption not part of the score

1142 stars · 161 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

A GitHub Action that extracts metadata such as tags and labels from Git references and GitHub events for Docker images. It is typically paired with docker/build-push-action to automatically generate image tags and OCI labels in CI workflows.

Use cases

• generate docker image tags from git tags and branches in ci
• automatically label docker images with oci annotations
• tag docker images with semver from git tags
• add sha and edge tags to docker builds in github actions
• produce metadata for docker build push action
• sanitize image names and tags in ci pipelines

When to choose

• you build and push Docker images from GitHub Actions and want automatic, consistent tagging
• you need OCI-compliant labels and annotations derived from Git and event context
• you want semver, sha, edge, or branch-based tag rules without writing shell scripts

When to avoid

• your CI runs outside GitHub Actions
• you need fully custom tagging logic that the action's tag types and expressions cannot express
• you build images without a container registry or labeling workflow

Facets

plugin · maturity active

ci-cd developer-tools configuration-management developer-tools cloud cli github-actions docker-images image-tagging oci-labels semver docker-build devops containers automation docker

Member repositories

For agents

markdown · JSON · MCP: product_card(name="docker/metadata-action")