Platforms6 min read·Updated

Sanity Images: WebP Masters Plus the Image URL Builder

Sanity's image pipeline (`auto=format`) is excellent. Editors still upload iPhone HEIC exports converted to 5 MB JPEG. Convert to WebP at 2000 px first so Studio thumbs, GROQ-driven pages and emails all start from a light asset.

auto=format is not a free lunch

The CDN will pick WebP/AVIF for the browser. It still downloads and processes your master. A 2000 px WebP master makes every w= request cheaper and protects you when someone forgets auto=format.

Why it matters

  • Studio becomes sluggish with huge masters.
  • GROQ pages that list 24 images feel the weight.
  • Hotspot/crop is happier on a reasonably sized file.

How to do it

  1. Convert the shoot or CMS export to WebP.
  2. Upload via Sanity Studio. Recrop if needed.
  3. Keep auto=format in the URL builder anyway.

Settings that work

2000 px / 80% for editorial. 1200 px / 85% for cards.

Convert a batch in your browser. Nothing is uploaded.

Put it into practice

Convert your images to WebP right now, free and privately in your browser.

Open the converter

Frequently asked questions

Yes. The image type stores the asset; WebP is valid.

No. Keep it so browsers that prefer AVIF can still get it from the CDN.

Keep reading

Platforms6 min read

WebP for Contentful

Contentful's Images API can format=webp, but huge masters still cost transform time and origin weight. Pre-convert assets to WebP.

Read more
Tutorial6 min read

WebP in Next.js

next/image can serve WebP, but huge files in /public still hurt. How to pre-convert static assets and CMS images for Next.js App Router.

Read more
Workflow6 min read

Blog images to WebP

How to bulk convert article photos and UI screenshots to WebP with different quality for each type.

Read more