Resize

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

The Resize method returns a new resource from a processable image according to the given processing specification.

[!note] Use the reflect.IsImageResourceProcessable function to verify that an image can be processed.

Usage

Resize an image according to the given processing specification. You may specify only the width (such as 300x) or only the height (such as x150) for proportional scaling.

If you specify both width and height (such as 300x150), the resulting image will be scaled to those exact dimensions. If the target aspect ratio differs from the original, the image will be non-proportionally scaled (stretched or squashed).

{{ with resources.Get "images/original.jpg" }}
  {{ with .Resize "300x" }}
    
  {{ end }}
{{ end }}

In the example above, "300x" is the processing specification.

{{% include "/_common/methods/resource/processing-spec.md" %}}

Example

{{ with resources.Get "images/original.jpg" }}
  {{ with .Resize "300x" }}
    
  {{ end }}
{{ end }}

{{< img src="images/examples/zion-national-park.jpg" alt="Zion National Park" filter="Process" filterArgs="resize 300x" example=true

}}