Width

Applicable to images, returns the width of the given resource.

Syntax

RESOURCE.Width

Returns

int

Use this method with global resources, page resources, or remote resources.

Use the reflect.IsImageResourceWithMeta function to verify that Hugo can determine the dimensions before calling the Width method.

{{ with resources.GetMatch "images/featured.*" }}
  {{ if reflect.IsImageResourceWithMeta . }}
    <img src="{{ .RelPermalink }}" width="{{ .Width }}" height="{{ .Height }}" alt="">
  {{ else }}
    <img src="{{ .RelPermalink }}" alt="">
  {{ end }}
{{ end }}

Last updated: February 27, 2026 : content: Miscellaneous udpates for v0.157.0 (35da1aa3c)

Improve this page