How are transformations counted?
Last updated: Feb-05-2023
Your account's monthly pricing plan is in part dependent on the total number of transformations performed during a 30-day cycle.
Overview
Transformation counts are impacted by each processing of an asset. The majority of these occur when Cloudinary generates a new 'derived' resource from an asset based on a transformation URL (regardless of the complexity of the transformation).
You may intentionally generate some 'derived' resources in advance using eager
transformations so that they will be immediately available upon request. Otherwise, a derived resource is generated on the fly (and counted) when the transformation URL is requested for delivery for the first time.
Your pricing plan is also impacted by storage and bandwidth usage, not covered here.
Transformation counting basics
- Upload processing: The upload of each image and video asset (with or without an incoming transformation) counts as one transformation.
If you re-upload (overwrite) an asset with the same public ID in the future, that upload is again counted as a transformation.
Stored
raw
assets impact your storage quota, but are not counted as transformations. - Transformation complexity: The count for a single transformation URL is not impacted by the number of transformation parameters in the URL, or the number of transformation components if chained transformations are applied.
- Multiple requests: Since transformations are counted when a new derived resource is generated, multiple requests to the identical transformation URL do not affect transformation counts.
This includes URLs using Dynamic SEO suffixes, which are resolved on the CDN layer and thus do not increase transformation counts, even if multiple SEO suffixes are delivered with the same transformation URL.
Based on the above, most images that you deliver result in one transformation for the initial asset upload, and one transformation per image transformation URL delivered (or eagerly generated).
Special transformation counts
The following features or operations address special transformation counting rules:
Feature | Count guideline | Notes and calculation details |
---|---|---|
Video and audio | Initial upload of a video counts as a single transformation regardless of its size. The transformation count for each derived video resource is calculated based on its generated resolution and its duration. |
|
Multi-page/frame image files | Since transformations applied to animated images, and other files with multiple frames or 'pages', such as TIFF, PDFs, or Photoshop images with layers, are in essence applied to each page or frame, Cloudinary provides a special calculation for these. | 1 transformation for the complete derived image, plus:
|
3D models | Any new derived resource generated from a 3D model counts as 20 transformations. | |
'Auto' transformations | Some auto transformation parameters have the potential to generate multiple derived resources, depending on the browser, device, or viewing size being used when the URL is requested. Each time a new derived resource is generated, it counts as another transformation. |
|
URL changes | If two (or more) transformations generate an identical result, but the URL is different in any way, a separate transformed (derived) resource is created (and counted) when each of those transformations is requested. | Examples:
|
Auto-upload | Auto-upload is much like uploading any other file, except that the upload occurs 'lazily' when the URL is first requested. Thus at the time of the first request, the initial upload counts as a single transformation. If the auto-upload URL also includes transformations, a derived resource is generated in addition to the uploaded file, resulting in a second transformation. |
|
Fetch and remote social media profiles | Fetched and social media profile images count as one transformation (whether or not you apply transformation parameters in the delivery URL). Delivering fetched videos (with or without transformation parameters) follows the same calculation as standard video transformation counts. |
Even though fetched images are cached (and thus count against your storage quote), the fetch delivery type isn't considered an upload, and thus there isn't an additional upload transformation associated with these assets. |
Placeholder images | Placeholder images are used when the requested base image doesn't exist. In that case, then if transformations are applied to the placeholder image, and the relevant derived image doesn't already exist, it is generated and counted as a transformation. | |
Video Player seek thumbnails | Enabling seek thumbnails for the Cloudinary video player will generate a sprite containing the relevant thumbnails from each video. As such, this will count as an additional transformation. | |
Console asset editor | When you use the Asset Editor in the Cloudinary Console to experiment with transformations, a new derived resource is generated each time you refresh the preview. | |
Media library operations that delete derived assets | Certain changes to assets via the Media Library, delete any derived resources that specifically depend on those values, and new derived assets are generated when a transformation URL on that asset is requested. | Example: Adding/modifying tags may result in regeneration of a conditional transformation with a text overlay that's based on a tag value. |
API operations that delete derived assets | Certain Upload API and Admin API operations that change or replace the original asset result in all stored derived resources for that asset being deleted. This means that the next time a corresponding transformation URL is requested, a new derived resource is generated based on the updated asset. | Methods that cause this behavior include: upload, explicit, tags, context, update, delete. |
Asset analysis operations on 'Explicit' | When you include parameters that perform special media processing or analyses on existing assets, and return the data in the response as part of an Explicit method call, this extra analysis operation is counted as a transformation. | Specifically, when you run an Explicit method call that includes one or more of the following parameters, that request is counted as a transformation:
|
AVIF format | The transformation count for AVIF files, and other formats converted to AVIF, is based on the transformed (derived) image size.
Most web-based displayed images should be less than 2 MP (2 MP is, for example, 1600×1250 pixels), so should not incur extra transformation costs. |
Example: For an AVIF of 3.2 MP: AVIF transformation count = 1 + 1 = 2.
|
Animated AVIF format | The transformation count for animated images and videos converted to animated AVIF from other formats is based on the number of frames of the transformed file. 2 transformations are counted per 10 frames. |
Example: For an animated AVIF of 60 frames: Animated AVIF transformation count = 2 * (60 / 10) = 12 transformations. |
Upscale effect | Use of the upscale effect counts as 10 transformations. | The result of the upscale effect is cached, so even if it is used again together with different transformations, no further transformations are counted for its use on the same image. |
- When using add-ons that are triggered by transformation parameters, then an add-on unit is used in addition to the normal transformation count for the derived asset.
- For additional information on how your overall account usage is calculated (including storage and bandwidth), see the Cloudinary Pricing page and this KB article.
- You can set your email preferences to receive notifications regarding your account usage.