GRAB A SEAT AT THE CLOUDINARY CAFÉ! Our popular live training series just got bigger. Fresh sessions every week - served up by Cloudinary pros. Register here
Cloudinary Logo Cloudinary Docs Docs
  • Image & Video APIs
    • Get Started
    • Guides
    • References
    • SDKs
    • Release Notes
  • Assets (DAM)
    • Get Started
    • User Guides
    • Admin Guides
    • Assets APIs
    • Release Notes
  • More Products
    • Integrations Add Cloudinary capabilities to your tech stack apps and platforms
    • MediaFlows Low-code workflow automation for images and videos
    • Cloudinary 3D Content creation and 3D experiences at scale
    • FinalTouch (Early Access) AI-powered virtual photoshoot and image creation for eCommerce
  • Resources
    • Blog
    • Training
    • Support
    • Demos
    • Additional Resources
  • Pricing
AI sparkles
Light theme
Dark theme
Device default
sign up for free
  • Get Started
    • Image & Video APIs overview
    • Developer kickstart
      • Step 1: Register and find credentials
      • Step 2: Load pages faster with optimization
      • Step 3: Your first transformations
      • Step 4: Resize transformations
      • Step 5: Set up and run your first SDK project
      • Congrats! You're ready to code!
    • SDK quick starts
    • Try it!
      • Code explorers
      • Feature demos
      • Postman collections
    • Video tutorial library
      • Programmatic asset management
      • Optimization and delivery
      • Transformations
      • Dev Hints on YouTube
    • Additional onboarding resources
      • Service introduction
      • Onboarding FAQ
      • Enterprise onboarding FAQ
      • Migration guide
      • Glossary
  • Guides
    • Cloudinary Image
      • Product overview
      • Image transformations
      • Image optimization and delivery
      • Programmatic image creation
      • Product Gallery widget
      • Media Editor widget
      • Image add-ons
    • Cloudinary Video
      • Product overview
      • Cloudinary Video Player
      • Adaptive bitrate streaming
      • Video transformations
      • Video and audio optimization
      • Video transcription
      • Video analytics
      • Live streaming
      • Video add-ons
      • Video best practices
      • Social media videos
    • Upload
      • Uploading assets
      • Customizing uploads
      • Client-side uploading
      • Upload presets
      • Upload widget
    • Asset management
      • CRUD asset management APIs
      • Media Library for developers
      • Search for assets
      • Eager and incoming transformations
      • Custom metadata
      • Analyze assets
      • Moderate assets
      • Webhook notifications
      • Advanced asset management
      • Add-ons
    • Account management
      • Account settings
      • Product environment settings
      • User provisioning
      • Usage data
      • How are transformations counted?
    • Retail and e-commerce
      • Best practices
      • Visual differentiators
      • Customize and optimize assets
      • Workflows
    • User-generated content
      • Profile picture sample project
      • Video review sample project
      • Marketplace products sample project
      • Try before you buy sample project
    • AI in action
    • Native mobile
    • Add-ons
      • Advanced Facial Attributes Detection
      • Amazon Rekognition AI Moderation
      • Amazon Rekognition Video Moderation
      • Amazon Rekognition Auto Tagging
      • Amazon Rekognition Celebrity Detection
      • Aspose Document Conversion
      • Cloudinary AI Background Removal
      • Cloudinary AI Content Analysis
      • Cloudinary AI Vision (Beta)
      • Cloudinary Duplicate Image Detection
      • Google AI Video Moderation
      • Google AI Video Transcription
      • Google Auto Tagging
      • Google Automatic Video Tagging
      • Google Translation
      • Imagga Auto Tagging
      • Imagga Crop and Scale
      • Perception Point Malware Detection
      • Microsoft Azure Video Indexer
      • OCR Text Detection and Extraction
      • Pixelz - Remove the Background
      • URL2PNG Website Screenshots
      • VIESUS™ Automatic Image Enhancement
      • WebPurify Image Moderation
  • References
    • Transformation URL API
    • Upload API
    • Admin API
    • Provisioning API
    • Analyze API (Beta)
    • Live streaming API
    • Cloudinary CLI
    • SDK references
      • Transformation Builder reference
      • React SDK reference
      • Vue.js SDK reference
      • JavaScript SDK reference
      • Angular SDK reference
      • PHP SDK reference
      • Go SDK reference
      • Dart SDK reference
      • Flutter SDK reference
    • Postman collections
    • Upload Widget API
    • Product Gallery API
    • Media Editor API
    • Video Player API
  • SDKs
    • Backend SDKs
      • Node.js SDK
      • Python SDK
      • PHP SDK
      • Java SDK
      • Ruby/Rails SDK
      • .NET SDK
      • Go SDK
      • Dart SDK
      • PHP SDK (Legacy)
    • Frontend SDKs
      • React SDK
      • Vue.js SDK
      • Angular SDK
      • JavaScript SDK
      • jQuery SDK
      • React SDK (Legacy)
      • Vue.js SDK (Legacy)
      • Angular SDK (Legacy)
      • JavaScript SDK (Legacy)
    • Mobile SDKs
      • iOS SDK
      • Android SDK
      • Flutter SDK
      • React Native SDK
      • Kotlin SDK
    • Community-developed libraries
      • Next.js
      • Astro
      • Laravel
      • NuxtJS
      • Svelte
      • Gatsby
      • Netlify
      • Drupal
  • Release Notes
    • Latest: May 27, 2025
    • November 29, 2024
    • October 9, 2024
    • Previous releases
      • August 12, 2024
      • June 27, 2024
      • May 31, 2024
      • April 16, 2024
      • February 28, 2024
      • January 03, 2024
      • November 13, 2023
      • October 26, 2023
      • September 21, 2023
      • August 15, 2023
      • July 13, 2023
      • June 19, 2023
      • May 16, 2023
      • Apr 04, 2023
      • Feb 21, 2023
      • Dec 27, 2022
  • Get Started
    • Image & Video APIs overview
    • Developer kickstart
      • Step 1: Register and find credentials
      • Step 2: Load pages faster with optimization
      • Step 3: Your first transformations
      • Step 4: Resize transformations
      • Step 5: Set up and run your first SDK project
      • Congrats! You're ready to code!
    • SDK quick starts
    • Try it!
      • Code explorers
      • Feature demos
      • Postman collections
    • Video tutorial library
      • Programmatic asset management
        • Programmatic upload
          • Upload programmatically
          • Create upload presets
          • Auto upload
          • Moderate images with AI
          • Use AI to generate image captions
          • Upload images in Flutter
          • Upload images in Node.js
          • Auto-tag images in Node.js
          • Upload multiple files in Node.js
          • Upload videos in Node.js
          • Upload images in Python
          • Auto-tag images in Python
          • Upload videos in Python
          • Upload assets in a React app
          • Upload assets in a Vue.js app
          • Drag-and-drop uploads in React
          • Upload assets in a Next.js app
          • Upload assets with Server Actions
          • Upload assets in Svelte
          • Upload assets in a SvelteKit app
          • Upload assets in a Remix app
          • Upload images in Hono
          • Use webhooks to remove backgrounds
        • Interaction with Cloudinary APIs
          • Generate upload signature
          • Postman collections introduction
        • Cloudinary SDKs
          • Find your credentials
          • Configure the JavaScript SDK
          • Configure the React SDK
          • Configure the Flutter SDK
          • Configure Svelte Cloudinary
          • Configure the Javascript SDK in Svelte
          • Getting started with Cloudinary in Node.js
          • Configure the Node.js SDK
          • Configure the Python SDK
          • Configure the PHP SDK
          • Configure the Go SDK
          • Configure the Vue.js SDK
          • Configure the Next.js SDK
          • List images in Next.js
          • Lazy load images with Next.js
          • Captioning on upload with Node.js
          • Delete assets with Node.js
          • Manage images in a Django app
        • Cloudinary CLI
          • Get started with the CLI
          • Scripting with the CLI
          • Get creative with the CLI
          • Upload with the CLI
        • Widgets
          • Upload Widget
          • Product Gallery
          • Product Gallery in React
          • Product Gallery accessibility
        • Administration
          • Enable automatic backups
          • Restore asset versions
          • Restore deleted assets
      • Optimization and delivery
        • Programmatic optimization
          • Optimization tips
          • Optimize videos in React
          • Transform and optimize images in Svelte
          • Optimize videos in Next.js
          • Optimize Images with Nuxt Cloudinary
          • Optimize Images in SolidJS with Cloudinary
          • Optimize images in Flutter
          • Optimize images in Laravel
        • Programmatic delivery
          • Deliver images with the Next.js Image component
          • Deliver images with the Nuxt Image component
          • Diagnosing error codes
        • Video Player
          • Video Player in React
          • Video Player in Next.js
          • Video Player in HTML
      • Transformations
        • Get started with transformations
          • Transformation basics
          • Transformation Builder
          • Gravity-based crops for images
          • Enhance and restore images
          • Transformation overlays
          • Content-aware image cropping
          • Content-aware video cropping
          • Convert videos to animated images
        • Advanced transformation features
          • Text overlay transformations
          • Complex transformations
          • Named transformations
          • Named transformations using TX Builder
          • Advanced image components
          • Trim videos in Node.js
          • Splice videos in Node.js
          • Zoompan effect
          • Video transformations
          • Crop and resize images in React
          • Crop and resize videos in React
          • Crop and resize images in Python
          • Remove backgrounds and add drop shadows
          • AI generative fill in Next.js
          • Color accessibility in JavaScript
        • Transformations for social media
          • Social media image cards in Next.js
          • Social media image cards in Svelte
      • Dev Hints on YouTube
    • Additional onboarding resources
      • Service introduction
      • Onboarding FAQ
        • Enterprise onboarding FAQ
          • Migration guide
          • Glossary
      • Guides
        • Cloudinary Image
          • Product overview
          • Image transformations
            • Image transformations overview
            • Resizing and cropping
            • Placing layers on images
            • Effects and enhancements
            • Background removal
            • Generative AI transformations
            • Face-detection based transformations
            • Custom focus areas
            • Animated images
            • Transformations on 3D models
            • Conditional transformations
            • User-defined variables and arithmetic transformations
            • Custom functions
          • Image optimization and delivery
            • Optimization overview
            • Image optimization
              • Image optimization basics
              • PDF optimization
              • Optimize by default
            • Responsive images
              • Using HTML and dynamic image transformations
              • Using JavaScript frontend frameworks
              • Using the cloudinary-core JS library
              • Using client hints
            • Deliver remote media files
              • Social media profile pictures
            • PDF and Photoshop files
            • Media access methods
            • CDN delivery options
          • Programmatic image creation
            • Animated images
            • Archives
            • Sprites
            • Image collages
            • PDF files from images
            • Images from text
          • Product Gallery widget
            • Product Gallery changelog
          • Media Editor widget
          • Image add-ons
        • Cloudinary Video
          • Product overview
          • Cloudinary Video Player
            • Video Player features
            • Installation and setup
            • How to embed the Video Player
            • Video Player customization
            • Playlists and recommendations
            • HLS and MPEG-DASH
            • Video Player accessibility
            • Video Player advanced features
              • Events and analytics
              • Video ads and monetization
              • Shoppable Video
              • Interactive Video (Beta)
            • Video Player API reference
          • Adaptive bitrate streaming
          • Video transformations
            • Video transformations overview
            • Resizing and cropping
            • Trimming and concatenating
            • Placing layers on videos
            • Effects and enhancements
            • Audio transformations
            • Advanced video transformations
              • Converting videos to animated images
              • Conditional transformations
              • User-defined variables and arithmetic transformations
          • Video and audio optimization
            • Video optimization
            • Adaptive bitrate streaming
            • Audio optimization
          • Video transcription
          • Video analytics
          • Live streaming
            • Live streaming API reference
            • Simulated live streaming
          • Video add-ons
          • Video best practices
          • Social media videos
        • Upload
          • Uploading assets
          • Customizing uploads
          • Client-side uploading
          • Upload presets
          • Upload widget
            • Upload widget changelog
        • Asset management
          • CRUD asset management APIs
            • List assets
            • Update assets
            • Delete assets
            • Rename assets
            • Relate assets
          • Media Library for developers
          • Search for assets
            • Search API method
            • Cacheable search URLs
            • Visual Search
            • Search expressions
          • Eager and incoming transformations
          • Custom metadata
            • Tags
            • Contextual metadata
            • Structured metadata
              • Conditional metadata rules
          • Analyze assets
            • Image quality analysis
            • Accessibility analysis
            • Semantic data extraction
            • Media Inspector (Beta)
            • Analyze API (Beta)
          • Moderate assets
          • Webhook notifications
          • Advanced asset management
            • Signatures
              • Authentication signatures
              • Notification signatures
              • Delivery URL signatures
              • Response signatures
            • Provenance and authenticity
            • Backups and version management
            • Invalidate cached assets
          • Add-ons
        • Account management
          • Account settings
            • Folder modes
          • Product environment settings
          • User provisioning
            • SAML SSO
          • Usage data
          • How are transformations counted?
        • Retail and e-commerce
          • Best practices
          • Visual differentiators
          • Customize and optimize assets
          • Workflows
            • Product asset workflows
            • Non-product asset workflows
            • Multi-channel content delivery
        • User-generated content
          • Profile picture sample project
          • Video review sample project
          • Marketplace products sample project
          • Try before you buy sample project
            • Delete temporary UGC assets
        • AI in action
        • Native mobile
        • Add-ons
          • Advanced Facial Attributes Detection
          • Amazon Rekognition AI Moderation
          • Amazon Rekognition Video Moderation
          • Amazon Rekognition Auto Tagging
          • Amazon Rekognition Celebrity Detection
          • Aspose Document Conversion
          • Cloudinary AI Background Removal
          • Cloudinary AI Content Analysis
          • Cloudinary AI Vision (Beta)
          • Cloudinary Duplicate Image Detection
          • Google AI Video Moderation
          • Google AI Video Transcription
          • Google Auto Tagging
          • Google Automatic Video Tagging
          • Google Translation
          • Imagga Auto Tagging
          • Imagga Crop and Scale
          • Perception Point Malware Detection
          • Microsoft Azure Video Indexer
          • OCR Text Detection and Extraction
          • Pixelz - Remove the Background
          • URL2PNG Website Screenshots
          • VIESUS™ Automatic Image Enhancement
          • WebPurify Image Moderation
      • References
        • Transformation URL API
        • Upload API
        • Admin API
        • Provisioning API
        • Analyze API (Beta)
        • Live streaming API
        • Cloudinary CLI
        • SDK references
          • Transformation Builder reference
          • React SDK reference
          • Vue.js SDK reference
          • JavaScript SDK reference
          • Angular SDK reference
          • PHP SDK reference
          • Go SDK reference
          • Dart SDK reference
          • Flutter SDK reference
        • Postman collections
        • Upload Widget API
        • Product Gallery API
        • Media Editor API
        • Video Player API
      • SDKs
        • Backend SDKs
          • Node.js SDK
            • Node.js introduction
            • Node.js quick start
            • Node.js image and video upload
            • Node.js image transformations
            • Node.js video transformations
            • Node.js asset management
            • Node.js sample projects
            • Node.js video tutorials
          • Python SDK
            • Python introduction
            • Python quick start
            • Python image and video upload
            • Python image transformations
            • Python video transformations
            • Python asset management
            • Python sample projects
            • Python video tutorials
          • PHP SDK
            • PHP introduction
            • PHP quick start
            • PHP image and video upload
            • PHP image transformations
            • PHP video transformations
            • PHP asset management
            • PHP sample projects
            • PHP video tutorials
            • PHP Management reference
            • PHP Transformation reference
          • Java SDK
            • Java introduction
            • Java quick start
            • Java image and video upload
            • Java image transformations
            • Java video transformations
            • Java asset management
          • Ruby/Rails SDK
            • Ruby/Rails introduction
            • Ruby/Rails quick start
            • Ruby/Rails image and video upload
            • Ruby/Rails image transformations
            • Ruby/Rails video transformations
            • Ruby/Rails asset management
            • CarrierWave integration
            • Attachinary integration
            • Active Storage integration
          • .NET SDK
            • .NET introduction
            • .NET quick start
            • .NET image and video upload
            • .NET image transformations
            • .NET video transformations
            • .NET asset management
          • Go SDK
            • Go introduction
            • Go quick start
            • Go image and video upload
            • Go media transformations
            • Go asset management
            • Go sample projects
            • Go video tutorials
            • Go SDK reference
          • Dart SDK
            • Dart introduction
            • Dart quick start
            • Dart image and video upload
            • Dart media transformations
            • Dart SDK reference
          • PHP SDK (Legacy)
            • PHP introduction
            • PHP image and video upload
            • PHP image transformations
            • PHP video transformations
            • PHP asset management
            • PHP migration guide
        • Frontend SDKs
          • React SDK
            • React introduction
            • React quick start
            • React image and video upload
            • React image transformations
            • React video transformations
            • React sample projects
            • React video tutorials
            • React SDK reference
            • Transformation Builder reference
          • Vue.js SDK
            • Vue.js introduction
            • Vue.js quick start
            • Vue.js image and video upload
            • Vue.js image transformations
            • Vue.js video transformations
            • Vue.js sample projects
            • Vue.js video tutorials
            • Vue.js SDK reference
            • Transformation Builder reference
          • Angular SDK
            • Angular introduction
            • Angular quick start
            • Angular image and video upload
            • Angular image transformations
            • Angular video transformations
            • Angular sample projects
            • Angular SDK reference
            • Transformation Builder reference
          • JavaScript SDK
            • JavaScript introduction
            • JavaScript quick start
            • JavaScript image and video upload
            • JavaScript image transformations
            • JavaScript video transformations
            • JavaScript sample projects
            • JavaScript video tutorials
            • JavaScript SDK reference
            • Transformation Builder reference
          • jQuery SDK
            • jQuery introduction
            • jQuery image and video upload
            • jQuery image transformations
            • jQuery video transformations
          • React SDK (Legacy)
            • React introduction
            • React image and video upload
            • React image transformations
            • React video transformations
            • React migration guide
          • Vue.js SDK (Legacy)
            • Vue.js introduction
            • Vue.js image and video upload
            • Vue.js image transformations
            • Vue.js video transformations
            • Vue.js migration guide
          • Angular SDK (Legacy)
            • Angular introduction
            • Angular image and video upload
            • Angular image transformations
            • Angular video transformations
            • Angular migration guide
          • JavaScript SDK (Legacy)
            • JavaScript introduction
            • JavaScript image and video upload
            • JavaScript image transformations
            • JavaScript video transformations
            • JavaScript migration guide
        • Mobile SDKs
          • iOS SDK
            • iOS introduction
            • iOS quick start
            • iOS image and video upload
            • iOS image transformations
            • iOS video transformations
            • iOS video player
            • iOS sample projects
          • Android SDK
            • Android introduction
            • Android quick start
            • Android image and video upload
            • Android image transformations
            • Android video transformations
            • Android video player
            • Android sample projects
          • Flutter SDK
            • Flutter introduction
            • Flutter quick start
            • Flutter image and video upload
            • Flutter media transformations
            • Flutter video player
            • Flutter video tutorials
            • Dart-based cloudinary_url_gen package reference
            • Flutter SDK reference
          • React Native SDK
            • React Native introduction
            • React Native image and video upload
            • React Native image transformations
            • React Native video transformations
            • React Native video player
          • Kotlin SDK
            • Kotlin media transformations
        • Community-developed libraries
          • Next.js
          • Astro
          • Laravel
          • NuxtJS
          • Svelte
          • Gatsby
          • Netlify
          • Drupal
      • Release Notes
        • Latest: May 27, 2025
        • November 29, 2024
        • October 9, 2024
        • Previous releases
          • August 12, 2024
          • June 27, 2024
          • May 31, 2024
          • April 16, 2024
          • February 28, 2024
          • January 03, 2024
          • November 13, 2023
          • October 26, 2023
          • September 21, 2023
          • August 15, 2023
          • July 13, 2023
          • June 19, 2023
          • May 16, 2023
          • Apr 04, 2023
          • Feb 21, 2023
          • Dec 27, 2022
      Image & Video APIs
      • Get Started
      • Guides
      • References
      • SDKs
      • Release Notes
      Assets (DAM)
      • Get Started
      • User Guides
      • Admin Guides
      • Assets APIs
      • Release Notes
    • More Products
        More Products
        Integrations
        Add Cloudinary capabilities to your tech stack apps and platforms
        MediaFlows
        Low-code workflow automation for images and videos
        Cloudinary 3D
        Content creation and 3D experiences at scale
        FinalTouch (Early Access)
        AI-powered virtual photoshoot and image creation for eCommerce
    • Resources
        Resources
        Blog
        Training
        Support
        Demos
        Additional Resources
    • Pricing
      sign up for free
      Image & Video APIs
      Menu
      • Get Started
        • Image & Video APIs overview
        • Developer kickstart
          • Step 1: Register and find credentials
          • Step 2: Load pages faster with optimization
          • Step 3: Your first transformations
          • Step 4: Resize transformations
          • Step 5: Set up and run your first SDK project
          • Congrats! You're ready to code!
        • SDK quick starts
        • Try it!
          • Code explorers
          • Feature demos
          • Postman collections
        • Video tutorial library
          • Programmatic asset management
            • Programmatic upload
              • Upload programmatically
              • Create upload presets
              • Auto upload
              • Moderate images with AI
              • Use AI to generate image captions
              • Upload images in Flutter
              • Upload images in Node.js
              • Auto-tag images in Node.js
              • Upload multiple files in Node.js
              • Upload videos in Node.js
              • Upload images in Python
              • Auto-tag images in Python
              • Upload videos in Python
              • Upload assets in a React app
              • Upload assets in a Vue.js app
              • Drag-and-drop uploads in React
              • Upload assets in a Next.js app
              • Upload assets with Server Actions
              • Upload assets in Svelte
              • Upload assets in a SvelteKit app
              • Upload assets in a Remix app
              • Upload images in Hono
              • Use webhooks to remove backgrounds
            • Interaction with Cloudinary APIs
              • Generate upload signature
              • Postman collections introduction
            • Cloudinary SDKs
              • Find your credentials
              • Configure the JavaScript SDK
              • Configure the React SDK
              • Configure the Flutter SDK
              • Configure Svelte Cloudinary
              • Configure the Javascript SDK in Svelte
              • Getting started with Cloudinary in Node.js
              • Configure the Node.js SDK
              • Configure the Python SDK
              • Configure the PHP SDK
              • Configure the Go SDK
              • Configure the Vue.js SDK
              • Configure the Next.js SDK
              • List images in Next.js
              • Lazy load images with Next.js
              • Captioning on upload with Node.js
              • Delete assets with Node.js
              • Manage images in a Django app
            • Cloudinary CLI
              • Get started with the CLI
              • Scripting with the CLI
              • Get creative with the CLI
              • Upload with the CLI
            • Widgets
              • Upload Widget
              • Product Gallery
              • Product Gallery in React
              • Product Gallery accessibility
            • Administration
              • Enable automatic backups
              • Restore asset versions
              • Restore deleted assets
          • Optimization and delivery
            • Programmatic optimization
              • Optimization tips
              • Optimize videos in React
              • Transform and optimize images in Svelte
              • Optimize videos in Next.js
              • Optimize Images with Nuxt Cloudinary
              • Optimize Images in SolidJS with Cloudinary
              • Optimize images in Flutter
              • Optimize images in Laravel
            • Programmatic delivery
              • Deliver images with the Next.js Image component
              • Deliver images with the Nuxt Image component
              • Diagnosing error codes
            • Video Player
              • Video Player in React
              • Video Player in Next.js
              • Video Player in HTML
          • Transformations
            • Get started with transformations
              • Transformation basics
              • Transformation Builder
              • Gravity-based crops for images
              • Enhance and restore images
              • Transformation overlays
              • Content-aware image cropping
              • Content-aware video cropping
              • Convert videos to animated images
            • Advanced transformation features
              • Text overlay transformations
              • Complex transformations
              • Named transformations
              • Named transformations using TX Builder
              • Advanced image components
              • Trim videos in Node.js
              • Splice videos in Node.js
              • Zoompan effect
              • Video transformations
              • Crop and resize images in React
              • Crop and resize videos in React
              • Crop and resize images in Python
              • Remove backgrounds and add drop shadows
              • AI generative fill in Next.js
              • Color accessibility in JavaScript
            • Transformations for social media
              • Social media image cards in Next.js
              • Social media image cards in Svelte
          • Dev Hints on YouTube
        • Additional onboarding resources
          • Service introduction
          • Onboarding FAQ
            • Enterprise onboarding FAQ
              • Migration guide
              • Glossary
          • Guides
            • Cloudinary Image
              • Product overview
              • Image transformations
                • Image transformations overview
                • Resizing and cropping
                • Placing layers on images
                • Effects and enhancements
                • Background removal
                • Generative AI transformations
                • Face-detection based transformations
                • Custom focus areas
                • Animated images
                • Transformations on 3D models
                • Conditional transformations
                • User-defined variables and arithmetic transformations
                • Custom functions
              • Image optimization and delivery
                • Optimization overview
                • Image optimization
                  • Image optimization basics
                  • PDF optimization
                  • Optimize by default
                • Responsive images
                  • Using HTML and dynamic image transformations
                  • Using JavaScript frontend frameworks
                  • Using the cloudinary-core JS library
                  • Using client hints
                • Deliver remote media files
                  • Social media profile pictures
                • PDF and Photoshop files
                • Media access methods
                • CDN delivery options
              • Programmatic image creation
                • Animated images
                • Archives
                • Sprites
                • Image collages
                • PDF files from images
                • Images from text
              • Product Gallery widget
                • Product Gallery changelog
              • Media Editor widget
              • Image add-ons
            • Cloudinary Video
              • Product overview
              • Cloudinary Video Player
                • Video Player features
                • Installation and setup
                • How to embed the Video Player
                • Video Player customization
                • Playlists and recommendations
                • HLS and MPEG-DASH
                • Video Player accessibility
                • Video Player advanced features
                  • Events and analytics
                  • Video ads and monetization
                  • Shoppable Video
                  • Interactive Video (Beta)
                • Video Player API reference
              • Adaptive bitrate streaming
              • Video transformations
                • Video transformations overview
                • Resizing and cropping
                • Trimming and concatenating
                • Placing layers on videos
                • Effects and enhancements
                • Audio transformations
                • Advanced video transformations
                  • Converting videos to animated images
                  • Conditional transformations
                  • User-defined variables and arithmetic transformations
              • Video and audio optimization
                • Video optimization
                • Adaptive bitrate streaming
                • Audio optimization
              • Video transcription
              • Video analytics
              • Live streaming
                • Live streaming API reference
                • Simulated live streaming
              • Video add-ons
              • Video best practices
              • Social media videos
            • Upload
              • Uploading assets
              • Customizing uploads
              • Client-side uploading
              • Upload presets
              • Upload widget
                • Upload widget changelog
            • Asset management
              • CRUD asset management APIs
                • List assets
                • Update assets
                • Delete assets
                • Rename assets
                • Relate assets
              • Media Library for developers
              • Search for assets
                • Search API method
                • Cacheable search URLs
                • Visual Search
                • Search expressions
              • Eager and incoming transformations
              • Custom metadata
                • Tags
                • Contextual metadata
                • Structured metadata
                  • Conditional metadata rules
              • Analyze assets
                • Image quality analysis
                • Accessibility analysis
                • Semantic data extraction
                • Media Inspector (Beta)
                • Analyze API (Beta)
              • Moderate assets
              • Webhook notifications
              • Advanced asset management
                • Signatures
                  • Authentication signatures
                  • Notification signatures
                  • Delivery URL signatures
                  • Response signatures
                • Provenance and authenticity
                • Backups and version management
                • Invalidate cached assets
              • Add-ons
            • Account management
              • Account settings
                • Folder modes
              • Product environment settings
              • User provisioning
                • SAML SSO
              • Usage data
              • How are transformations counted?
            • Retail and e-commerce
              • Best practices
              • Visual differentiators
              • Customize and optimize assets
              • Workflows
                • Product asset workflows
                • Non-product asset workflows
                • Multi-channel content delivery
            • User-generated content
              • Profile picture sample project
              • Video review sample project
              • Marketplace products sample project
              • Try before you buy sample project
                • Delete temporary UGC assets
            • AI in action
            • Native mobile
            • Add-ons
              • Advanced Facial Attributes Detection
              • Amazon Rekognition AI Moderation
              • Amazon Rekognition Video Moderation
              • Amazon Rekognition Auto Tagging
              • Amazon Rekognition Celebrity Detection
              • Aspose Document Conversion
              • Cloudinary AI Background Removal
              • Cloudinary AI Content Analysis
              • Cloudinary AI Vision (Beta)
              • Cloudinary Duplicate Image Detection
              • Google AI Video Moderation
              • Google AI Video Transcription
              • Google Auto Tagging
              • Google Automatic Video Tagging
              • Google Translation
              • Imagga Auto Tagging
              • Imagga Crop and Scale
              • Perception Point Malware Detection
              • Microsoft Azure Video Indexer
              • OCR Text Detection and Extraction
              • Pixelz - Remove the Background
              • URL2PNG Website Screenshots
              • VIESUS™ Automatic Image Enhancement
              • WebPurify Image Moderation
          • References
            • Transformation URL API
            • Upload API
            • Admin API
            • Provisioning API
            • Analyze API (Beta)
            • Live streaming API
            • Cloudinary CLI
            • SDK references
              • Transformation Builder reference
              • React SDK reference
              • Vue.js SDK reference
              • JavaScript SDK reference
              • Angular SDK reference
              • PHP SDK reference
              • Go SDK reference
              • Dart SDK reference
              • Flutter SDK reference
            • Postman collections
            • Upload Widget API
            • Product Gallery API
            • Media Editor API
            • Video Player API
          • SDKs
            • Backend SDKs
              • Node.js SDK
                • Node.js introduction
                • Node.js quick start
                • Node.js image and video upload
                • Node.js image transformations
                • Node.js video transformations
                • Node.js asset management
                • Node.js sample projects
                • Node.js video tutorials
              • Python SDK
                • Python introduction
                • Python quick start
                • Python image and video upload
                • Python image transformations
                • Python video transformations
                • Python asset management
                • Python sample projects
                • Python video tutorials
              • PHP SDK
                • PHP introduction
                • PHP quick start
                • PHP image and video upload
                • PHP image transformations
                • PHP video transformations
                • PHP asset management
                • PHP sample projects
                • PHP video tutorials
                • PHP Management reference
                • PHP Transformation reference
              • Java SDK
                • Java introduction
                • Java quick start
                • Java image and video upload
                • Java image transformations
                • Java video transformations
                • Java asset management
              • Ruby/Rails SDK
                • Ruby/Rails introduction
                • Ruby/Rails quick start
                • Ruby/Rails image and video upload
                • Ruby/Rails image transformations
                • Ruby/Rails video transformations
                • Ruby/Rails asset management
                • CarrierWave integration
                • Attachinary integration
                • Active Storage integration
              • .NET SDK
                • .NET introduction
                • .NET quick start
                • .NET image and video upload
                • .NET image transformations
                • .NET video transformations
                • .NET asset management
              • Go SDK
                • Go introduction
                • Go quick start
                • Go image and video upload
                • Go media transformations
                • Go asset management
                • Go sample projects
                • Go video tutorials
                • Go SDK reference
              • Dart SDK
                • Dart introduction
                • Dart quick start
                • Dart image and video upload
                • Dart media transformations
                • Dart SDK reference
              • PHP SDK (Legacy)
                • PHP introduction
                • PHP image and video upload
                • PHP image transformations
                • PHP video transformations
                • PHP asset management
                • PHP migration guide
            • Frontend SDKs
              • React SDK
                • React introduction
                • React quick start
                • React image and video upload
                • React image transformations
                • React video transformations
                • React sample projects
                • React video tutorials
                • React SDK reference
                • Transformation Builder reference
              • Vue.js SDK
                • Vue.js introduction
                • Vue.js quick start
                • Vue.js image and video upload
                • Vue.js image transformations
                • Vue.js video transformations
                • Vue.js sample projects
                • Vue.js video tutorials
                • Vue.js SDK reference
                • Transformation Builder reference
              • Angular SDK
                • Angular introduction
                • Angular quick start
                • Angular image and video upload
                • Angular image transformations
                • Angular video transformations
                • Angular sample projects
                • Angular SDK reference
                • Transformation Builder reference
              • JavaScript SDK
                • JavaScript introduction
                • JavaScript quick start
                • JavaScript image and video upload
                • JavaScript image transformations
                • JavaScript video transformations
                • JavaScript sample projects
                • JavaScript video tutorials
                • JavaScript SDK reference
                • Transformation Builder reference
              • jQuery SDK
                • jQuery introduction
                • jQuery image and video upload
                • jQuery image transformations
                • jQuery video transformations
              • React SDK (Legacy)
                • React introduction
                • React image and video upload
                • React image transformations
                • React video transformations
                • React migration guide
              • Vue.js SDK (Legacy)
                • Vue.js introduction
                • Vue.js image and video upload
                • Vue.js image transformations
                • Vue.js video transformations
                • Vue.js migration guide
              • Angular SDK (Legacy)
                • Angular introduction
                • Angular image and video upload
                • Angular image transformations
                • Angular video transformations
                • Angular migration guide
              • JavaScript SDK (Legacy)
                • JavaScript introduction
                • JavaScript image and video upload
                • JavaScript image transformations
                • JavaScript video transformations
                • JavaScript migration guide
            • Mobile SDKs
              • iOS SDK
                • iOS introduction
                • iOS quick start
                • iOS image and video upload
                • iOS image transformations
                • iOS video transformations
                • iOS video player
                • iOS sample projects
              • Android SDK
                • Android introduction
                • Android quick start
                • Android image and video upload
                • Android image transformations
                • Android video transformations
                • Android video player
                • Android sample projects
              • Flutter SDK
                • Flutter introduction
                • Flutter quick start
                • Flutter image and video upload
                • Flutter media transformations
                • Flutter video player
                • Flutter video tutorials
                • Dart-based cloudinary_url_gen package reference
                • Flutter SDK reference
              • React Native SDK
                • React Native introduction
                • React Native image and video upload
                • React Native image transformations
                • React Native video transformations
                • React Native video player
              • Kotlin SDK
                • Kotlin media transformations
            • Community-developed libraries
              • Next.js
              • Astro
              • Laravel
              • NuxtJS
              • Svelte
              • Gatsby
              • Netlify
              • Drupal
          • Release Notes
            • Latest: May 27, 2025
            • November 29, 2024
            • October 9, 2024
            • Previous releases
              • August 12, 2024
              • June 27, 2024
              • May 31, 2024
              • April 16, 2024
              • February 28, 2024
              • January 03, 2024
              • November 13, 2023
              • October 26, 2023
              • September 21, 2023
              • August 15, 2023
              • July 13, 2023
              • June 19, 2023
              • May 16, 2023
              • Apr 04, 2023
              • Feb 21, 2023
              • Dec 27, 2022
          • Image & Video APIs
          • Guides
          • Account management
          • Account settings

          Account console settings

          Last updated: Apr-23-2025

          You can configure settings that influence your account as a whole, as well as how your assets get uploaded, stored, and delivered within the currently selected product environment.

          Some Settings affect both Assets (DAM) users or admins and developers, so you should coordinate with other teams where relevant.

          Click the Settings icon in the Console Options sidebar to view your Console Settings.

          Account settings

          The default settings are a good place to start but you'll want to review all the settings to ensure they meet your organization's needs.

          The following sections highlight a few of the common settings that you may want to consider when setting up your account.

          Overview

          From the Cloudinary Console Settings pages, you can define a variety of options and configurations that apply to the entire account, including:

          Option Useful for...
          My Profile Editing personal information, setting display preferences (such as language and dark mode), managing email preferences and two-factor authentication, and generating support verification codes. All user roles can access this page. Learn more
          Account Upgrading your plan and updating your account details.
          Product Environments Adding product environments or editing the ones already in your account. Learn more
          User Management Creating and managing users and groups in your account. Learn more
          Account Security Enabling or requiring SAML login and two-factor authentication for the users in the account. Learn more
          Other settings:
          Billing Managing your plan and billing details including:
          • Plans Details, Billing Information pages -- available for all plans
          • Invoices, Payment Method, and Billing Dashboard pages -- available only for accounts on paid plans.
          Note: Some older accounts may have all of their billing details in a single Billing page.
          Add-ons Extending Cloudinary capabilities with tools that offer advanced features for managing, processing, and delivering your digital assets effectively. Learn more

          Notes
          • To find out which roles grant permission to access each setting, see Role-based permissions.
          • While in most accounts, Billing and Add-ons have separate sections in the Console Settings, in older accounts, these sections appear under Account settings.

          Support verification code

          If you're working with Cloudinary Support on a sensitive issue—such as security updates or major account modifications—you, your CSM, or a support representative may ask you to generate a support verification code. This code helps Cloudinary verify your identity and protect your account throughout the support process.

          You can generate the verification code from the Support Verification Code tab in the My Profile page of the Console Settings. The verification code will be sent to the email associated with your Cloudinary account.

          Two-factor authentication and SSO

          In the Account Security page of the Console Settings, check or modify two-factor authentication (2FA) and SAML/SSO login settings for your account.

          Two-factor authentication (2FA) is recommended for any Production environment, or per your organization's security policy. You can upgrade to two-factor authentication on any account, including free accounts and those registered via GitHub, Google, or email.

          Note
          If 2FA is set to Optional in the Security tab, it won't be enforced or prompted for users. However, individual users can still enable 2FA for their own accounts via the Two-Factor Authentication tab under My Profile in the Console Settings.

          Important
          If you signed up through a third-party login (e.g., Google, GitHub, or Heroku), changing your email associated with the third-party service without first setting up direct access to your Cloudinary account may prevent you from logging in. To avoid this, establish direct access to Cloudinary via the My Profile page of the Console Settings before changing your third-party email.

          SSO is available for enterprise accounts. It's recommended especially if you have more than 100 users or per your organization's security policy.

          Product environment management

          A product environment encompasses a distinct asset repository with specific settings and attributes. To learn more about product environments, see What's a product environment?.

          To manage your product environments, navigate to the Product Environment page of the Console Settings. Here, you can browse through all your product environments, search for specific ones, enable or disable them and modify attributes such as cloud name (the unique identifier), display name (shown in the Product Selector instead of the cloud name, if defined) and description. You can check if your product environments are using dynamic folders mode, and you can add new product environments, within the limit of your plan.

          Product environment settings

          When creating a new product environment:

          • You can configure its cloud name, display name, description, and folder mode.

          • By default, all new product environments are set to use the dynamic folders mode, which allows for flexibility in organizing files. However, if necessary, you can select fixed folder mode. You can't change folder modes in existing product environments.

          • Additionally, you can choose an existing product environment to serve as the Base product environment.

          On this page:

          • Overview
          • Support verification code
          • Two-factor authentication and SSO
          • Product environment management

          Note
          The Provisioning API allows managing product environments programmatically via the sub_accounts endpoint. Access to the Provisioning API is available for accounts on an Enterprise plan. If you don’t currently have access and would like to explore your options, contact us. For more details, see the Provisioning API reference.

          Dynamic and fixed folder modes

          All Cloudinary product environments use either dynamic folders or fixed folders. Both modes support most features but differ in some behavior and management options:

          • Dynamic folders offer flexibility, as folder changes and asset naming in the Media Library (managed by display name) don’t affect public IDs included in delivery URLs. This allows you to update names and folder structures in the UI without breaking production links.

          • Fixed folders tie the folder structure and asset naming in the Media Library directly to the public ID, which is part of the delivery URL. As a result, changes to folder structures or asset names can break links if not managed carefully.

          Important

          Starting June 4th, 2024, all new Cloudinary accounts are created using dynamic folder mode.

          You can find out if dynamic folders is enabled for your product environment by navigating to the Product Environments settings page. From the (3-dots) option menu next to the relevant product environment select Edit. Your product environment is using dynamic folder mode if the Dynamic folder mode toggle button is on. If it's off, you're using fixed folder mode.

          Dynamic folders indication

          Notes
          • Historically, Cloudinary accounts used fixed folder mode. If you're currently using the legacy fixed folder mode and would like to enable dynamic folders for your product environment, contact support.
          • For more information on the ways that dynamic and fixed folder modes differ in the Cloudinary Console, see the Folder modes page in the Assets Admin Guide.
          • For more information about how their differences are reflected in the API, see Folder modes.

          Base product environment

          The Base Product Environment option simplifies creating new product environments by inheriting key configurations from an existing environment. When using this option, the following settings are automatically copied:

          • Usage limits
          • Folder mode (removing the option to select a folder mode independently)
          • Customized options applied by Cloudinary support
          • Asset record location (EU, US, or AP)

          It's important to note that some elements, such as folders and assets, are not transferred to the new environment.

          This feature is designed to help maintain consistency in core configurations while streamlining the setup of new environments. Before selecting a base environment, carefully review its settings to ensure they align with your requirements.

          If you need help, contact support or your Customer Success Manager.

          Additional product environment subscriptions

          You can find the maximum number of product environments that you're eligible for at the top of the Product Environments page of the Console Settings. If you're on a paid plan and have reached your base plan limit, the Change Limit button will appear, allowing you to increase this limit. Click Change Limit and select the appropriate add-on for the desired number of additional product environments. Subsequently, you can adjust the number of additional product environment subscriptions on your account at any time.

          If you're already subscribed to an Add product environments add-on, you can change the number of product environments beyond your base plan limit. However, please note that selecting a different Add product environments add-on will replace your previous selection, rather than adding to it. The number of product environments you add will always be applied to the base plan limit, which is the initial cap before any Add product environments plans are included. You can view your base plan limit in the side panel of the Account page within the Console Settings.

          Note
          The option to separately purchase additional product environments from the Console is available only to customers that subscribed to Cloudinary directly (not via another provider like Heroku or AWS), are on a paid plan, and are not on an Enterprise or custom plan.

          For additional help, or to add more than 5 additional product environments, contact support.

          ✔️ Feedback sent!

          ✖️  
          How helpful was this doc page?

          Thanks for submitting your rating. We got it!
          We'd love to hear more. Tell us what you liked and how we can make this page even better:

          *


          Cloudinary is committed to protecting your information security. For details, see our privacy policy.

          For additional assistance, open a support request.

          Error

          Unfortunately there's been an error sending your feedback.

          Rate this page:

          • Account management
          • Folder modes
          Cloudinary Logo - White
          Products
          • Programmable Media
          • Image API
          • Video API
          • DAM
          • Demos
          • Pricing
          • FAQ
          Solutions
            • E-commerce
            • Retail
            • Media & Entertainment
            • Travel & Hospitality
            • Non-Profits
            • Our Customers
            • Resource Library
            Developers
            • Getting Started
            • Documentation
            • SDKs
            • Add-ons
            Company
            • About Us
            • Customers
            • Partners
            • Events
            • Careers
            • Newsroom
            • Blog
            • Trust
            Contact Us
            • Technical Support
            • Contact Sales
            • Education & Training
            • Institute of Quality & Control
            • GDPR
            • SOC
            • Best Overall Dev Portal 2024
            • Terms of Use
            • Privacy Policy
            • DMCA Notice

            © 2025 Cloudinary. All rights reserved.

            A #278