gohugoio--hugo/docs/content/en/methods/resource/Meta.md

title, description, categories, keywords, params

title	description	categories	keywords	params
Meta	Applicable to images, returns an object containing Exif, IPTC, and XMP metadata for supported image formats.		metadata	functions_and_methods returnType signatures meta.MetaInfo RESOURCE.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

Use these methods on the Meta object.

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.

Value	Description
1	Horizontal (normal)
2	Mirrored horizontal
3	Rotated 180 degrees
4	Mirrored vertical
5	Mirrored horizontal and rotated 270 degrees clockwise
6	Rotated 90 degrees clockwise
7	Mirrored horizontal and rotated 90 degrees clockwise
8	Rotated 270 degrees clockwise

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" %}}