Resize

Resize an image to the given width and/or height.

If you specify both width and height, the resulting image will be disproportionally scaled unless the original image has the same aspect ratio.

{{ with resources.Get "images/original.jpg" }}
  {{ with .Resize "300x" }}
    <img src="{{ .RelPermalink }}" width="{{ .Width }}" height="{{ .Height }}" alt="">
  {{ end }}
{{ end }}

Process specification

The process specification is a space-delimited, case-insensitive list of one or more of the following in any sequence:

action

Applicable to the Process method only. Specify zero or one of crop, fill, fit, or resize. If you specify an action you must also provide dimensions.

dimensions

Provide width or height when using the Resize method, else provide both width and height. See details.

anchor

Use with the Crop and Fill methods. Specify zero or one of TopLeft, Top, TopRight, Left, Center, Right, BottomLeft, Bottom, BottomRight, or Smart. Default is Smart. See details.

target format

Specify zero or one of gif, jpeg, png, tiff, or webp. See details.

background color

When converting a PNG or WebP with transparency to a format that does not support transparency, optionally specify a background color using a 3-digit or a 6-digit hexadecimal color code. Default is #ffffff (white). See details.

compression

New in v0.153.5

The compression method to use when encoding the image. One of lossless or lossy. The lossless method is only applicable to WebP images. Default is lossy. See details.

hint

Applicable to WebP images and equivalent to the -preset flag for the cwebp encoder. Specify zero or one of drawing, icon, photo, picture, or text. Default is photo. See details.

quality

Applicable to JPEG and WebP images when using lossy compression. Specify qN where N is a whole number between 1 and 100, inclusive. Default is 75. See details.

resampling filter

Typically specify zero or one of Box, Lanczos, CatmullRom, MitchellNetravali, Linear, or NearestNeighbor. Other resampling filters are available. See details.

rotation

Typically specify zero or one of r90, r180, or r270. Also supports arbitrary rotation angles. See details.

Example

{{ with resources.Get "images/original.jpg" }}
  {{ with .Resize "300x webp q85 lanczos" }}
    <img src="{{ .RelPermalink }}" width="{{ .Width }}" height="{{ .Height }}" alt="">
  {{ end }}
{{ end }}

Original

Processed