Cloudinary Blog
Understanding Cloudinary Transformations and Pricing Plan

One main reason people use Cloudinary is to leverage its capabilities for transforming digital assets, such as images and videos. Whether for optimization or aesthetics, it’s easy and fast to manipulate digital media for your web or mobile projects.

Cloudinary’s service plans count one credit as 1,000 transformations. However, the many transformation options available can cause confusion on what actions count against a plan’s quota. Since this is a common topic in our support tickets, we wanted to spell out the details here.

Feel free to watch this accompanying video if you’d prefer to watch instead of read.

Content Upload

Generally, uploading a piece of content counts as a single transformation because Cloudinary must process the image. It’s important to remember that if you’re planning a large migration of images or videos to Cloudinary, such as at the start of your account.

Transformation Upload

However, you cannot transform “raw” files, such as Excel spreadsheets or CSS files. Cloudinary simply stores them instead of processing them as images or videos. Therefore, uploading raw files does not count against your transformation quota..

Raw Transformation Files

Additionally, files of certain types can result in multiple transformations once you’ve optimized or added effects to them. Here are some examples:

  • Animated GIFs: The initial upload counts as one transformation. A subsequent transformation counts once for every 10 frames of an image. As an example, applying a transformation set to a GIF with 20 frames counts as two transformations.
  • PDFs: Similar to animated GIFs, the initial upload counts as one transformation. A subsequent transformation set counts once for every 10 pages of the document.
  • Standard Definition (SD) Videos: SD videos are those with a 480p or lower resolution. One transformation is counted for the initial upload, after which transforming every second of the video counts as two transformations.
  • High Definition (HD) Videos: HD videos are those with a resolution that’s higher than 480p, such as 720p, 1080p, or even 4K. The initial upload counts as one transformation, after which transforming every second of the video counts as four transformations.

Transformed Assets

In most circumstances, each transformation grouping on an image or video counts as a single transformation. That means the first transformation set could be something as small as c_crop or as big as c_crop,w_200,h_300, but both of those sets count as one each. That rule applies whether you apply the transformation eagerly or on the fly.

After generating a transformation set for an image, Cloudinary stores the transformed version in your account for quicker and recurring access. Because Cloudinary has already generated that image, loading it doesn’t count against your transformation quota. No matter how many views the image gets afterwards—and you’re at liberty to post the identical transformation on as many different web pages as you desire—no additional counts occur against your quota.

Transformation Servings Do Not Increase

On the other hand, changing the order of a transformation set does trigger a transformation, even if the transformations in the set remain the same. That’s because Cloudinary must reprocess the material, yet the end result is unchanged. Using the example above, changing the order of the set from c_crop,w_200,h_300 to h_300,c_crop,w_200 results in a transformation counted against your quota.

Fetching Outside Content

A powerful feature of Cloudinary is its ability to fetch and retrieve files from remote locations with dynamic URLs. This capability can be of tremendous benefit because the fetched content can reduce your server load and lower hosting costs. Plus, you can manipulate or optimize your media assets any time on Cloudinary.

Given that content fetches involve no actual processing by Cloudinary, they don’t count as upload transformations. However, adding transformations to fetched content does count against your quota.

Image Transformations That Count Multiple Times

f_auto

The f_auto transformation delivers images in an optimal format according to your visitor’s browser configurations. To take advantage of that, we recommend that you make use of f_auto in transformations.

f_auto Example

The superior technique of f_auto potentially creates four transformations once somebody on these browsers views the image as:

  • WebP for Chrome users and some Firefox and Microsoft Edge users.
  • JPEG XR for Microsoft Edge and Internet Explorer users.
  • JPG for Firefox users.
  • Original image type, if it wasn’t originally a JPG.

If your account also includes support for JPEG 2000 transformations, which Safari can display, then Cloudinary generates an additional transformation. The f_auto transformation also creates animated versions of all available formats for animated images.

dpr_auto

Also a very useful transformation, dpr_auto displays images at the optimal device pixel ratio (DPR) rather than manually setting a DPR. dpr_auto creates new transformations as soon as a viewer loads the image on a device with a different DPR.

dpr_auto Examples

As an example, viewers on an Apple iPhone X can view images delivered up to a DPR of 3. However, those on an iPhone 6 or 6s can only view images delivered up to a DPR of 2. Once a viewer loads your image on either device for the first time, Cloudinary counts that as a transformation.

Note
dpr_auto requires Cloudinary’s JavaScript library for projects. Here’s our documentation on that library.

On MyDevice.io is a full list of the most common smartphones and tablets with their associated DPRs.

w_auto

The w_auto transformation generates multiple transformations to suit the responsive layout design of your site. Similar to dpr_auto, w_auto requires Cloudinary’s JavaScript library to properly work.

Say, for example, you have three responsive breakpoints on your site. Applying the w_auto transformation to the image would count as one transformation against your quota. You would then receive two more transformations as Cloudinary loads or processes the two other images.

We recommend using Cloudinary’s Responsive Breakpoints Generator to calculate the optimal number of versions required for every image. With this tool, you can determine the exact number of transformations processed through w_auto.

Actions to Take In Case of High Quota

Deleting images from your account does not remove the related transformations from your quota since Cloudinary has already expended the resources for processing those images. In addition, re-uploading an existing image or a previously deleted image does count as a transformation because such a task involves processing on Cloudinary’s part.

Notwithstanding the cost, a plan upgrade is worth considering. If transformations are a key part of your service, especially if you maintain a large retail or ecommerce site with a multitude of images of various sizes and DPR adjustments that are being served to customers, the added transformations to a quota in an upgrade would ensure that your project is sustainable and successful.

Alternatively, thanks to the rolling 30-day window for transformations, you can wait it out. Keep in mind that you can circumvent an unexpected spike of transformations from migrations or unexpected testing cycles by postponing further transformations until that busy period has passed.

Additional Resources

For more details on transformations and quotas, see these posts in our Knowledge Base:

Any questions? File a ticket through our Knowledge Base or write us at support@cloudinary.com.


Thanks to the following content creators for their contributions to this post:

Recent Blog Posts

Cloudinary offers ongoing support to Scene7 customers in their DAM business goals.

With the imminent shutdown of Scene7 after rebranding by Adobe as part of Dynamic Media, dozens of leading eCommerce companies, among them the world’s top three eCommerce brands, have migrated to Cloudinary as a viable alternative to Scene7. And for good reason: time is of the essence and Cloudinary promises not only a smooth migration flow and continuity of their rich-media initiative, but also numerous superb capabilities.

Read more
Applying Your Own Duotone Effect Filter With Cloudinary

The trendy duotone effect is ubiquitous in today’s websites and illustrations for good reason: it highlights content well, rendering it pleasing to the eye, especially on minimal web platforms. The sky is the limit as to how much you can play with colors while applying a duotone effect. You could keep trying them out until something stands out.

Read more
New q_auto Setting For Content-Aware Video Compression

It’s widely known that video is the most effective way of communicating your brand to your audience. It is also an extremely varied medium. Take a look at the existing videos in your media library, you’ll find videos with differing lengths, colors, brightness and density of content. All of these videos need to be optimized in a different way. Cloudinary’s new automatic video quality can intelligently analyze each and every video to encode it using the most optimized settings, ensuring the best trade-off between file size and visual quality, whilst also maintaining a consistent experience throughout. All you need to do is set the quality parameter to auto (q_auto in URLs) and Cloudinary will take care of the rest.

Read more
Automatic Video Transcoding

Delivering video files to users can be a much more complex undertaking than many people stop to consider. There are a large variety of video formats and codecs to choose between, and various optimization parameters for encoding the videos. Parameters such as bitrate, key-frame-interval, and frame-rate will have an effect on the visual quality and bandwidth requirements when delivering the video file. To make matters worse, there are so many potential viewing devices out there (desktops, laptops, tablets, mobiles, wearables, etc). Each of these devices have different browsers or apps, and they all support different formats and codecs!

Read more
Dynamic Video Platform: 7 Use Cases

Increasingly, companies large and small, across all industries are enhancing their customer and brand experiences through video. We’ve just launched our dynamic video platform and shared our thoughts on the differences between traditional online video platforms (OVPs) and dynamic ones when it comes to creating, managing, and delivering compelling and engaging videos.

Read more