Trouble converting images to WebP

tyco · August 7, 2025, 4:03pm

I would suggest you test Hugo’s embedded image render hook and if it works, modify it to process images to webp

tpl/tplimpl/embedded/templates/_markup/render-image.html

master

{{- $u := urls.Parse .Destination -}}
{{- $src := $u.String -}}
{{- if not $u.IsAbs -}}
  {{- $path := strings.TrimPrefix "./" $u.Path -}}
  {{- with or (.PageInner.Resources.Get $path) (resources.Get $path) -}}
    {{- $src = .RelPermalink -}}
    {{- with $u.RawQuery -}}
      {{- $src = printf "%s?%s" $src . -}}
    {{- end -}}
    {{- with $u.Fragment -}}
      {{- $src = printf "%s#%s" $src . -}}
    {{- end -}}
  {{- end -}}
{{- end -}}
<img src="{{ $src }}" alt="{{ .PlainText }}"
  {{- with .Title }} title="{{ . }}" {{- end -}}
  {{- range $k, $v := .Attributes -}}
    {{- if $v -}}
      {{- printf " %s=%q" $k ($v | transform.HTMLEscape) | safeHTMLAttr -}}
    {{- end -}}

This file has been truncated. show original

Also, learn to put assets into folders rather than at root. For example, assets/images/, assets/css, assets/js etc.

Also read Where to place image files when using the Markdown content format.

Topic		Replies	Views
Conversion to WebP support images	6	1289	June 20, 2024
Can hugo convert all images to WEBP after the update? support	2	2692	May 15, 2021
Resize or convert images to WebP conditionally support images	5	192	January 12, 2025
Webp Image Processing support	3	4693	December 15, 2019
Hugo not reading webp images (possible bug) support	0	1087	October 15, 2019

Trouble converting images to WebP

Related topics