Sanity logo

Documentation

    • Overview
    • Platform introduction
    • Next.js quickstart
    • Nuxt.js quickstart
    • Astro quickstart
    • React Router quickstart
    • Content Lake
    • Compute and AI
    • APIs and SDKs
    • Dashboard
    • Studio
    • Canvas
    • Media Library
    • Build custom apps
    • HTTP API
    • CLI
    • Libraries
    • Specifications
    • Changelog
    • User guides
    • Developer guides
    • Courses and certifications
    • Join the community
    • Templates
APIs and SDKs
Overview

  • HTTP API Reference →
  • Schemas

    Introduction to schemas
    Naming things
    Attribute limit
    Studio schema reference
    Schema Deployment
    Aspects schema for Media Library

  • Command Line Interface

    Introduction
    Importing content
    Reference
    Managing backups

  • TypeScript

    Generating types

  • App SDK

    Go to App SDK docs
    Reference

  • Content Releases

    Programmatic control
    Cheat sheet

  • Asset API

    Presenting Images
    Image transformations
    Image Metadata
    International Image Interoperability Framework (IIIF) API reference
    Asset CDN
    Image URL helper
    Asset utilities

  • Sanity Connect for Shopify

    Introduction
    Custom sync handlers
    Reference

APIs and SDKsLast updated May 15, 2025

Image transformations

  • Article
  • Changelog

Support for AVIF transformations in image pipeline

v2024-11-13

The image pipeline now supports transformations to AVIF for supported browsers using the URL parameter &auto=format or .auto('format') with the Image URL helper.

Check out the launch blog post and learn more details about how AVIF transformations work in the documentation.

Sanity Asset CDN now supports animated images

v2024-08-08

Animated image assets (like .gif and .webp files) uploaded to Sanity will now be transformed and returned as animated rather than static images. To maintain the previous behavior of loading static images from the asset pipeline, please add frame=1 as a query argument to the image URL. This will only return the first frame of the animated image file.

The maximum limit is 256 megapixels ((width x height x frame count) / 1,000,000). If your animated file exceeds this limit, we'll return the first frame. In most cases, if your animated images are large, you might want to use proper video formats and/or consider plugins like Mux.

On this page

  • The anatomy of the image URL
  • Supported image types
  • The URL parameters
  • AVIF transformations
  • Read more
Sanity logosanity.ioAll Systems Operational© Sanity 2025