Development

Docker Image Reference Parser

Parse Docker image references into registry, namespace, repository, tag and digest components.

Docker image reference

Enter a Docker image name, tag, registry or digest to inspect its individual components.

Inspect a Docker image

Enter a Docker image reference and select Parse image to inspect its registry, namespace, repository, tag and digest.

Docker image references are parsed locally inside your browser. BigForgeKit does not contact registries or verify whether an image exists.

About this tool

What is Docker Image Reference Parser?

Docker Image Reference Parser separates a container image reference into its registry, namespace, repository, tag and digest parts. Edit individual components and rebuild a normalized reference without contacting a container registry.

Features

Built for fast developer workflows

  • Parse Docker Hub and private registry references.
  • Detect explicit registries and custom ports.
  • Extract nested namespaces and repositories.
  • Parse tags and immutable image digests.
  • Support references containing both tags and digests.
  • Edit parsed components and rebuild the image reference.
  • Generate a shorter familiar image name.
  • Warn when no tag or digest is present.
  • Copy generated references.
  • Process every reference locally in your browser.

Frequently asked questions

Questions about Docker Image Reference Parser

What is a Docker image reference?

A Docker image reference identifies an image using an optional registry, one or more namespaces, a repository and optionally a tag or digest.

How is a registry detected?

The first path segment is treated as a registry when it contains a dot, a port separator or is localhost.

What happens when no tag is provided?

Docker commonly resolves an untagged reference using the latest tag. The parser shows a warning because that reference is not explicit.

What is the difference between a tag and a digest?

A tag is a mutable label such as 1.4.2 or latest. A digest identifies immutable image content using an algorithm such as SHA-256.

Can a reference include both a tag and a digest?

Yes. The tag remains descriptive, while the digest determines the exact immutable image.

Does this tool check whether the image exists?

No. It only parses the reference locally and never contacts Docker Hub or another registry.

Related tools