Enable flexible variants

Last updated Apr 21, 2026 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. In the Cloudflare dashboard, go to the Hosted Images page. Go to Hosted images ↗
  2. Select the Delivery tab.
  3. Enable Flexible variants.

Enable flexible variants via the API

Make a PATCH request to the Update a variant endpoint.

curl --request 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 optimization parameters on any Cloudflare image. For example,

https://imagedelivery.net/{account_hash}/{image_id}/w=400,sharpen=3

Note

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

Was this helpful?

YesNo

On this page

Enable flexible variants - 图1Docs

{"@context":"https://schema.org","@type":"TechArticle","@id":"https://developers.cloudflare.com/images/optimization/hosted-images/enable-flexible-variants/#page","headline":"Enable flexible variants","description":"Turn on flexible variants in Cloudflare Images to allow dynamic resizing beyond predefined variant options.","url":"https://developers.cloudflare.com/images/optimization/hosted-images/enable-flexible-variants/","inLanguage":"en","image":"https://developers.cloudflare.com/images/optimization/hosted-images/enable-flexible-variants/og.png?v=d81e90a409a68ee4","dateModified":"2026-04-21","publisher":{"@type":"Organization","name":"Cloudflare","description":"One platform for your apps, agents, and workforce. Build, secure, and scale without managing infrastructure","url":"https://www.cloudflare.com/","sameAs":["https://github.com/cloudflare","https://www.linkedin.com/company/cloudflare","https://x.com/cloudflare"],"logo":{"@type":"ImageObject","url":"https://developers.cloudflare.com/logo.svg"},"address":{"@type":"PostalAddress","streetAddress":"101 Townsend St","addressLocality":"San Francisco","addressRegion":"CA","postalCode":"94107","addressCountry":"US"},"contactPoint":[{"@type":"ContactPoint","contactType":"Customer Support","url":"https://support.cloudflare.com/","availableLanguage":["English"]},{"@type":"ContactPoint","contactType":"Sales","url":"https://www.cloudflare.com/contact/","availableLanguage":["English"]}]},"isPartOf":{"@type":"WebSite","@id":"https://developers.cloudflare.com/#website","name":"Cloudflare Docs","url":"https://developers.cloudflare.com/"}}

description: Retain C2PA metadata and provenance data on images delivered from Cloudflare Images. title: Preserve Content Credentials image: https://developers.cloudflare.com/images/optimization/hosted-images/preserve-content-credentials/og.png?v=9d8e3cb651a51091

Skip to content

Documentation Index
Fetch the complete documentation index at: https://developers.cloudflare.com/images/llms.txt
Use this file to discover all available pages before exploring further.