Cloudflare Docs
Cloudflare Image Optimization
Cloudflare Docs
Cloudflare Image Optimization
GitHub icon
Edit this page on GitHub
Set theme to dark (⇧+D)
  1. Products
  2. Cloudflare Image Optimization
  3. Manage uploaded images
  4. Enable flexible variants

Enable flexible variants

Flexible variants allow you to create variants with dynamic resizing which can provide more options than regular variants allow. This option is not enabled by default.

​​ Enable flexible variants via the Cloudflare dashboard

  1. Log in to the Cloudflare dashboard and select your account.
  2. Select Images > Variants.
  3. Enable Flexible variants.

​​ Enable flexible variants via the API

Make a PATCH request to the Update a variant endpoint.

curl -X PATCH https://api.cloudflare.com/client/v4/accounts/<ACCOUNT_ID>/images/v1/config \
    --header "Authorization: Bearer <API_TOKEN>" \
    --header "Content-Type: application/json" \
    --data '{"flexible_variants": true}'

After activation, you can use transformation parameters on any Cloudflare image. For example,

https://imagedelivery.net/<ACCOUNT_HASH>/<IMAGE_ID>/w=400,sharpen=3

Note that flexible variants cannot be used for images that require a signed delivery URL.