// Module included in the following assemblies:
//
// * builds/managing-build-output.adoc

:_mod-docs-content-type: REFERENCE
[id="builds-output-image-labels_{context}"]
= Output image labels

ifdef::openshift-enterprise,openshift-webscale,openshift-origin[]
docker and
endif::[]
source-to-image (S2I) builds set the following labels on output images:

[options="header"]
|===

|Label |Description

|`io.openshift.build.commit.author`
|Author of the source commit used in the build

|`io.openshift.build.commit.date`
|Date of the source commit used in the build

|`io.openshift.build.commit.id`
|Hash of the source commit used in the build

|`io.openshift.build.commit.message`
|Message of the source commit used in the build

|`io.openshift.build.commit.ref`
|Branch or reference specified in the source

|`io.openshift.build.source-location`
|Source URL for the build
|===

You can also use the `BuildConfig.spec.output.imageLabels` field to specify a list of custom labels that will be applied to each image built from the build configuration.

.Custom labels for built images
[source,yaml]
----
spec:
  output:
    to:
      kind: "ImageStreamTag"
      name: "my-image:latest"
    imageLabels:
    - name: "vendor"
      value: "MyCompany"
    - name: "authoritative-source-url"
      value: "registry.mycompany.com"
----
