hugo/docs/content/en/methods/resource/Fit.md

title, description, categories, keywords, params

title	description	categories	keywords	params
Fit	Applicable to images, returns a new image resource downscaled to fit according to the given processing specification.			functions_and_methods returnType signatures images.ImageResource RESOURCE.Fit SPECIFICATION

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

Downscale an image to fit according to the given processing specification while maintaining the aspect ratio. You must provide both width and height (such as 600x400) within the specification. Unlike Fill or Resize, this method will never upscale an image; if the source image is smaller than the target dimensions, it remains its original size. The operation uses the resampling filter provided, if any.

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

In the example above, "300x175 lanczos" is the processing specification.

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

Example

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

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

}}