How are transformations counted?
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:
|
'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. |
When you deliver a fetched or social media profile image, it also counts as one transformation (whether or not you apply transformation parameters in the delivery URL). These delivery types are not considered uploads, and thus there are no additional upload transformation counts 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 management 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 images converted to AVIF from other formats is based on the image size.
|
Example: For an AVIF of 3.2 MP: AVIF transformation count = 1 + (0.5 * 2) = 2.
|
- 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.