Meta

{{< new-in 0.155.3 />}}

{{% include "/_common/methods/resource/global-page-remote-resources.md" %}}

The Meta method on an image Resource object returns an object containing Exif, IPTC, and XMP metadata.

While Hugo classifies many file types as images, only certain formats support metadata extraction. Supported formats include AVIF, BMP, GIF, HEIC, HEIF, JPEG, PNG, TIFF, and WebP.

[!note] Metadata is not preserved during image transformation. Use this method with the original image resource to extract metadata from supported formats.

Usage

Use the reflect.IsImageResourceWithMeta function to verify that a resource supports metadata extraction before calling the Meta method.

{{ with resources.GetMatch "images/featured.*" }}
  {{ if reflect.IsImageResourceWithMeta . }}
    {{ with .Meta }}
      {{ .Date.Format "2006-01-02" }}
    {{ end }}
  {{ end }}
{{ end }}

Methods

Date

(time.Time) Returns the image creation date/time. Format with the time.Format function.

Lat

(float64) Returns the GPS latitude in degrees from Exif metadata, with a fallback to XMP metadata.

Long

(float64) Returns the GPS longitude in degrees from Exif metadata, with a fallback to XMP metadata.

Orientation

(int) Returns the value of the Exif Orientation tag, one of eight possible values.

[!tip] Use the images.AutoOrient image filter to rotate and flip an image as needed per its Exif orientation tag

Exif

(meta.Tags) Returns a collection of available Exif fields for this image. Availability is determined by the sources setting and specific fields are managed via the fields setting, both of which are managed in your project configuration.

IPTC

(meta.Tags) Returns a collection of available IPTC fields for this image. Availability is determined by the sources setting and specific fields are managed via the fields setting, both of which are managed in your project configuration.

XMP

(meta.Tags) Returns a collection of available XMP fields for this image. Availability is determined by the sources setting and specific fields are managed via the fields setting, both of which are managed in your project configuration.

Examples

To list the creation date, latitude, longitude, and orientation:

{{ with resources.GetMatch "images/featured.*" }}
  {{ if reflect.IsImageResourceWithMeta . }}
    {{ with .Meta }}
      <pre>
        {{ printf "%-25s %v\n" "Date" .Date }}
        {{ printf "%-25s %v\n" "Latitude" .Lat }}
        {{ printf "%-25s %v\n" "Longitude" .Long }}
        {{ printf "%-25s %v\n" "Orientation" .Orientation }}
      </pre>
    {{ end }}
  {{ end }}
{{ end }}

{{% include "/_common/functions/reflect/image-reflection-functions.md" %}}