Delete variants

Last updated Apr 21, 2026 You can delete variants via the Images dashboard or API. The only variant you cannot delete is public.

Caution

Deleting a variant is a global action that will affect other images that contain that variant.

Delete 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. Find the variant you want to remove and select Delete.

Delete variants via the API

Make a DELETE request to the delete variant endpoint.

curl --request DELETE https://api.cloudflare.com/client/v4/accounts/{account_id}/images/v1/variants/{variant_name} \
--header "Authorization: Bearer <API_TOKEN>"

After the variant has been deleted, the response returns "success": true.

Was this helpful?

YesNo

On this page

Delete variants - 图1Docs

{"@context":"https://schema.org","@type":"TechArticle","@id":"https://developers.cloudflare.com/images/optimization/hosted-images/delete-variants/#page","headline":"Delete variants","description":"Remove image variants from Cloudflare Images using the dashboard or API.","url":"https://developers.cloudflare.com/images/optimization/hosted-images/delete-variants/","inLanguage":"en","image":"https://developers.cloudflare.com/images/optimization/hosted-images/delete-variants/og.png?v=0215f1b34c7a8acb","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: Turn on flexible variants in Cloudflare Images to allow dynamic resizing beyond predefined variant options. title: Enable flexible variants image: https://developers.cloudflare.com/images/optimization/hosted-images/enable-flexible-variants/og.png?v=d81e90a409a68ee4

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.