Last updated: Nov-23-2023
Whether your web or mobile application delivers your organization's own carefully selected images, images uploaded by your end users (UGC), or both, you probably need to adjust the originals to fit the graphic design of your website or mobile application.
Cloudinary's dynamic URL transformations enable you to achieve those goals programmatically and on the fly without the need for graphic designers and fancy editing tools.
You can build these URLs manually in your code, or take advantage of Cloudinary's SDKs, which enable you to write your transformation code using intuitive syntax designed for your preferred programming language or framework and let the SDK automatically build these URLs for you.
Here are just a few examples of some popular use cases that you can accomplish on the fly by combining Cloudinary transformations. Click each image to see the URL parameters applied in each case:
change aspect ratio & crop to face,
add outlines & shadows Place, style, and format
image and text layers Apply special effects like
cartoonify and brightness,
rotate to any angle
Cloudinary allows you to easily transform your images on the fly to any required format, style and dimension, and apply effects and other visual enhancements. You can also optimize your images to deliver them with minimal file size alongside high visual quality for an improved user experience and minimal bandwidth. You can do all of this by implementing dynamic image transformation and delivery URLs. Your transformed images are then delivered to your users through a fast CDN with optimized caching.
With image transformations, you can:
- Deliver images using the image format that fits your needs.
- Resize and crop your images to the required dimensions using different scaling and cropping techniques, or use our smart cropping techniques, including face-detection or auto-gravity for cropping to focus on the most relevant parts of a photo.
- Generate a new image by layering other images or text on your base image.
- Apply a variety of effects, filters, and other visual enhancements to help your image achieve the desired impact.
The other pages in this guide provide details and use case examples on the various types of image transformations you can apply to your images.
The Transformation URL API Reference details every transformation parameter available for both images and videos.
- Usage limits for uploading, transforming and delivering files depend on your Cloudinary plan. For details, check the Account tab in your Cloudinary Console Settings.
- 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.
Below you can see the transformation URL and corresponding SDK code for generating an image with several transformation parameters applied. This transformation generates and delivers an image that is initially cropped to a 400x400 image that automatically focusses on the face, then rounded to a circle and finally, scaled down to a width of 200 pixels and delivered in the most optimal transparent format.
Your Cloudinary media assets are accessed using simple delivery HTTP or HTTPS URLs, which are then delivered to users via a worldwide fast CDN. The URL contains the public ID of the requested asset plus any optional transformation parameters. The public ID is the unique identifier of the asset and is either defined when uploading the asset to Cloudinary, or automatically assigned by Cloudinary (see Uploading Assets for more details on the various options for specifying the public ID).
Cloudinary's SDKs automatically build the transformation URL for you. They allow you to continue working in your preferred developer framework and also provide helper methods to simplify building image tags and image transformation URLs.
The default Cloudinary asset delivery URL has the following structure:
|cloud_name||A unique public identifier for your product environment, used for URL building and API access.|
|asset_type||The type of asset to deliver. Valid values:
|delivery_type||The storage or delivery type. For details on all possible types, see Delivery types.|
|transformations||Optional. One or more comma-separated transformation parameters in a single URL component, or a set of chained transformations in multiple URL components (separated by slashes). When the transformation URL is first accessed, the derived media file is created on the fly and delivered to your user. The derived file is also cached on the CDN and is immediately available to all subsequent users requesting the same asset.|
|version||Optional. You can include the version in your delivery URL to bypass the cached version on the CDN and force delivery of the latest asset (in the case that an asset has been overwritten with a newer file). For simplicity, the version component is generally not included in the example URLs on this page. For details, see Asset versions.|
|public_id||The unique identifier of the asset, including the folder structure if relevant.|
|extension||Optional. The file extension of the requested delivery format for the asset. Default: The originally uploaded format or the format determined by f_auto, when used.|
In the most general case of simply delivering images that were uploaded to your Cloudinary product environment without any transformations, the delivery URL will be in the format:
For example, delivering the image with a public ID of:
sample , uploaded to Cloudinary's
demo product environment in
The following shows an example of delivering the same image with transformation parameters, where the image is scaled and cropped to fill a 250x300 pixel size and a blurring effect is applied:
- For customers with a Custom Domain Name (CNAME) - available for Cloudinary's Advanced plan and above - the basic image delivery URL becomes:
https://<custom domain name>/image/upload....
- You can convert and deliver your image in other supported image formats by simply changing the image format file extension. For details, see Delivering in a different format.
You can append an SEO-friendly suffix to your URL by replacing the
image/uploadelement of the URL with
imagesand then appending the desired suffix with a slash (/) after the public ID and before the extension. For example, if you have a cooking image with a random public ID like:
abc1def2, you can deliver your image as:
For more details, see Dynamic SEO suffixes.
You can also use shortcut URLs when specifically delivering image files using the default
uploadtype. With Cloudinary's Root Path URL feature, the
<delivery_type>elements can be omitted from the URL (they automatically default to the values
uploadrespectively). For example, the Root Path shortcut delivery URL for the cropped image above is:
The following video provides a quick demonstration of how dynamic transformation URLs work with both images and videos.
The delivery type element of the URL provides an indication about the way the asset will be delivered, although in most cases, the delivery type value is determined at the time that the asset is stored in Cloudinary.
The following delivery type values are supported:
|Delivery type||Description||Learn more|
|upload||The default delivery type for uploaded assets. In most cases, this delivery type indicates that the asset is publicly available. However, there are options you can use to restrict access to assets with an
|private||The URL for the original asset can be accessed only with a signed URL. Transformed versions of the asset are publicly available (unless strict transformations are also defined).||Uploading private assets|
|authenticated||Both original and transformed versions of the asset can be accessed only with a signed URL or an authentication token.||Uploading authenticated assets Delivering authenticated assets|
|list||Generates a list of assets that have a specified tag.
Note: This isn't a delivery type in the classic sense, in that it doesn't relate to an individual asset. However, to use this feature, you specify
|Client-side asset lists|
|fetch||Enables transforming and delivering remote assets on the fly.||Fetch remote media files|
|Fetches a profile picture from Facebook, Twitter, or other specified social delivery type based on a specified ID or name.||Social media profile pictures|
|Delivers a thumbnail image generated from the specified video from a public video site.||Fetching thumbnails of public videos|
|multi||Enables you to deliver a single animated image (GIF, PNG or WebP) from all image assets that have been assigned a specified tag.||Multi method Create animated images Create PDF files|
|text||Enables you to generate an image in your product environment from a specified textual string along with style parameters for use as an image overlay.||Text method|
|url2png||Requires the URL2PNG Website Screenshots add-on. Enables you to generate a screenshot of a website.||URL2PNG Website Screenshots add-on|
Relevant only for the Ruby on Rails SDK. Delivers files that were uploaded using the
There are two types of transformation parameters:
- Action parameters: Parameters that perform a specific transformation on the asset.
- Qualifier parameters: Parameters that do not perform an action on their own, but rather alter the default behavior or otherwise adjust the outcome of the corresponding action parameter.
It's best practice to include only one action parameter per URL component.
If you want to apply multiple actions in a single transformation URL, apply them in separate chained components, where each action is performed on the result of the previous one.
In contrast, qualifier parameters must be included in the component with the action parameter they qualify.
- Most qualifiers are optional, meaning the related action parameter can be used independently, but you can add optional qualifiers to modify the default behavior.
- In some cases, an action parameter requires one or more qualifiers to fully define the transformation behavior.
- There are a few parameters that can be used independently as action parameters, but can also be used in other scenarios as a qualifier for another action.
For example, the transformation below includes a crop action, a rounding action, and 2 effect actions. The qualifier transformations included in each action define additional adjustments on the transformation action's behavior:
In this transformation:
- The width, aspect ratio, gravity, and zoom qualifiers control the way the thumbnail crop action will be performed.
- The rounding action does not have any qualifiers.
- The color qualifier overrides the default color of the outline effect action.
- The x and y qualifiers adjust the placement of the shadow effect and the color qualifier overrides the default shadow color.
Transformation flags alter default transformation behavior. In some cases, they alter the default behavior of the transformation URL as a whole. In other cases, they alter the behavior of one or more specific transformation parameters that must be used together in the same URL component.
In general, tens of flags are available that can alter delivery and format, cropping and positioning, overlays, metadata and color profiles, as well as PDF and text behaviors, just to name a few.
fl_attachment alters the normal behavior of the overall transformation. Instead of delivering an asset in a web page, it causes the transformed media file to be downloaded as an attachment. This flag can be used independently of other transformations.
fl_relative modifies the way overlay resize parameters are evaluated. This flag can only be used in conjunction with the overlay (
fl_layer_apply tells Cloudinary to apply all chained transformations, until a transformation component that includes this flag, on the last added overlay or underlay asset instead of applying them on the base asset. This flag acts as an indicator to close the layer section of the transformation, similar to a closing bracket. Placement definitions for how the layer should be applied, such as gravity and offsets are also defined in the component with this flag.
For details on all available transformation flags, see the flag section of the Transformation Reference.
For backward compatibility reasons, many of Cloudinary's earlier SDK major versions generate
http URLs by default. When using one of these SDKs, you can instruct the SDK to generate
https URLs by setting the
secure parameter to
true, either globally as part of your SDK configuration, or locally in each transformation operation. For example, delivering the
sample image with HTTPS:
Some transformation parameters with multiple options offer two alternative syntaxes for defining the option values:
Verbose, unordered: Each option of the transformation (whether required or optional) is specified in the verbose format
name_valueand each option is separated by a colon (
:) or semi-colon (
;) depending on the transformation.
The options can be specified in any order, and you only need to include those that you want (or are required) to define.
With this syntax, you can also choose to specify only the options for which you don't want to use default values and default values will be applied for the others.
- Non-verbose, ordered: Transformation options are specified only by values, and must be entered in the pre-defined option order for that transformation. All values from the syntax to the left of the value you want to supply must also be entered.
Transformations that support both verbose and non-verbose URL syntax are indicated as such in the Transformation Reference. When both are supported, SDKs always output the verbose syntax.
The version component is an optional part of Cloudinary delivery URLs that can be added to bypass the CDN cached version and force delivery of the newest asset. Cloudinary returns the value of the
version parameter as part of every upload response, and the returned
secure_url parameters also include the
version component, which represents the timestamp of the upload.
- Delivering the URL without a version value will deliver the cached version on the CDN if available or will request the latest version from Cloudinary if not cached (or when the cached version expires).
- Delivering the URL with a version will deliver the cached CDN version only if the cached version matches the requested version number. Otherwise, it will bypass the cached CDN version and immediately request and deliver the latest version from Cloudinary.
Example image delivery URL without version:
Example image delivery URL with version:
truewhile uploading a new version of an asset. This invalidates the previous version of the media asset throughout the CDN. Note that it usually takes between a few seconds and a few minutes for the invalidation to fully propagate through the CDN. Using a new
versionvalue in a URL takes effect immediately, but requires updating your delivery URLs in your production code. For details on invalidating media assets, see Invalidating cached media assets on the CDN.
The theme effect supports the
photosensitivity options, but you can specify them in a different order using verbose syntax. For example:
However, when using non-verbose syntax, you must specify the parameters in order. Therefore, even if you only want to change the default behavior of the
photosensitivity (last) option, you must still specify the value to use for the
color (first) option:
Cloudinary supports powerful transformations that are applied on the fly using dynamic URLs. You can combine multiple transformation actions together as part of a single delivery request, e.g., crop an image and then add a border to it.
In general, it's best practice to chain each transformation action in your URL as a separate component in the chain.
To support chained transformations, Cloudinary's transformation URLs allow you to include multiple transformation components, each separated by a slash (
/), where each of the transformation components is executed on the result of the previous one. Cloudinary's SDKs can apply multiple transformation components by specifying the
transformation parameter and setting it to an array of transformation maps.
Examples with the uploaded JPEG image named
Two chained transformations: fill to a 150px square, then round to a circle, and deliver in the best transparent format:
Four chained transformations: crop to 150x100 with a custom offset from the center, fill crop to 130x100, rotate by 20 degrees, then scale down to 80%, and deliver in the best transparent format:
A named transformation is a pre-defined set of transformation parameters that has been given a custom name for easy reference. Instead of applying each of the required transformations separately to an asset, you can apply a single named transformation to apply all the transformations defined for it. This makes it easy to:
- Reuse transformations on multiple assets
- Shorten complex transformation URLs
- Hide the details of a transformation in your delivery URL.
- Simplify the enabling/disabling of transformations in Strict Transformations mode.
Named transformations can include other named transformations, which allows you to define a chain of transformations to run on multiple assets more easily.
You can create and manage named transformations via the API or in the console UI using the Transformation Builder.
Once the named transformation has been defined, you can transform an asset with the
transformation parameter (
t for URLs) and the name of your named transformation. For example
You can include user-defined variables in your named transformations, and then pass the value for the user-defined variable into the transformation from an external source. This enables creating a named transformation 'template' with a lot of flexibility.
For example, you could define a complex named transformation that includes a text overlay as a named transformation, using a user-defined variable for the text string value.
You can also set named transformations as transformation presets, which you can apply as templates in the Media Library so that you can preview how assets will look with different named transformations applied.
- Updating the transformation definition for a named transformation via the Admin API does not automatically update assets that were already derived/delivered with that named transformation. To apply the new definition to any already derived assets that use that named transformation, you must specifically invalidate those transformations or otherwise modify the other parameters in that delivery URL, so that the asset will be re-derived using the new definition.
However, when updating the transformation definition of a named transformation via the Cloudinary Console, if the named transformation is used in fewer than 1000 existing derived assets, those assets are automatically invalidated and will use the new named transformation definition the next time they are requested. If more than 1000 existing derived assets use the named transformation, then existing derived assets are not updated and only newly generated derived assets will use the new definition.
You can use the regen_derived CLI command to regenerate derived assets after updating a transformation definition for a named transformation.
- When creating named transformations that may be applied to assets by other users, it's important to be aware that not all formats are supported for transformations. Applying a named transformation to an asset that has an unsupported format will result in an error. See a list of supported formats.
You can create a named transformation programmatically or using the Transformations UI in your Cloudinary console:
To create a named transformation programmatically, use the
Transformations Admin API method. The following example defines a named transformation called
small_profile_thumbnail that uses automatic cropping to resize assets to the required size for a particular application's thumbnail display:
For more details and examples, see the Create Transformation method in the Admin API Reference.
To create a named transformation programmatically: Open the Transformations page, accessible from the Console Product Navigation menu.
From here, there are a few ways to create a named transformation:
- Start with a transformation from the Transformations Gallery as a template and refine it to your needs before saving it with your chosen name.
- View a log of all your dynamic transformations (those you generated and delivered on the fly), from here you can copy the transformation string and use the Quick Edit option of the Transformation Builder.
- Create a new transformation from scratch using the Transformation Builder and save with your chosen name.
- Must contain valid UTF8 characters only
- Must not contain more than 1024 characters
- Must not contain any of these characters:
The Cloudinary Transformation Builder is the UI for creating and saving your transformations in a simple and easy to use way. The Transformation Builder has two modes of operation:
- Construct: Build transformations manually by selecting and configuring transformation actions.
- Converse: Build transformations using AI chat by describing the transformation with natural language.
Watch this video for a quick introduction to the Transformation Builder:
The Transformation Builder in construct mode provides:
- A simple and intuitive UI for selecting and configuring transformation actions - easily discover actions and parameters as you build.
- Transformations built as a series of self-contained actions so you can see the results of each one as you apply it.
- URL and SDK code ready to copy and paste directly to your code.
- The ability to update the default preview image to something from your own product environment.
- Quick edit functionality, to easily add transformations using URL syntax.
The builder supports most common transformation actions. If the transformation action you are trying to apply is not listed, you can add an Additional Transformation action and use transformation URL syntax to specify your transformation. Alternatively, you can switch to the legacy editor to create your transformation.
The Transformation Builder in converse mode provides:
- An AI-powered conversational interface to describe the transformation you want to create with natural language.
- Iterative prompts to continue the conversation and perfect the transformation.
- URL and SDK code ready to copy and paste directly to your code.
- The ability to update the default preview image to something from your own product environment.
- The conversational interface is powered by GPT.
- It answers questions related to Cloudinary transformations only.
- The use of AI, including the GPT model, means that answers may not be 100% accurate.
- We have implemented mechanisms to improve the accuracy of results for transaction-related queries compared to using ChatGPT directly.
- We are continually learning and making improvements as this technology progresses.
Below are some examples of using the following named transformations that have been defined for the Cloudinary
demo product environment:
jpg_with_quality_30: Convert the image to a JPEG with 30% quality.
crop_400x400: Crop the image to 400x400 with center gravity.
fit_100x150: Fit the image into a 100x150 rectangle.
To create a version of the sample image based on the
To create a transformation that applies additional transformations to the
jpg_with_quality_30 named transformation, such as fitting it to a 100 pixel width and a 50 pixel height:
You can also chain multiple named transformations. For example, to chain the three named transformations we defined above:
Chaining transformations can create long URLs, so instead you could define a named transformation that includes a chain of other transformations, including other named transformations. For example, we can create a named transformation that is a composite of the three named transformations described above. It is now simple to specify a single named transformation instead:
t_demo_combined is defined as:
The automatic format transformation parameter (
f_auto) is not effective if used in named transformations.
f_auto is used in a delivery URL, the CDN layer determines the best format to deliver. If this parameter is hidden in a named transformation then it is not visible to the CDN.
You can use
f_auto together with a named transformation by chaining the components, for example,
The automatic quality transformation parameter (
q_auto) is effective in named transformations, except in one situation.
q_auto is used in a delivery URL and the browser sets the
Save-Data HTTP header to
on in the request,
q_auto is translated to
q_auto:eco at the CDN level. If this parameter is hidden in a named transformation then it is not visible to the CDN, so the default level is applied,
To accommodate this situation, you may prefer to use
q_auto together with a named transformation by chaining the components, for example,
q_auto:best, then there are no concerns as there are no dependencies on the CDN level.
Learn more: Save-Data support
Watch this video tutorial to learn how to create re-usable named transformations with the Cloudinary Transformation Builder UI.
You access uploaded images or their derived transformations with URLs. These URLs can be used as the
<src> of the
<img> tags in your HTML code or other frontend functions to deliver your media assets.
But the easiest way to deliver them is using Cloudinary's framework SDKs to automatically generate transformation URLs and embed them using HTML image tags. The SDKs offer two main helper methods: the URL helper and the image tag helper.
The Cloudinary URL helper method (e.g.,
cloudinary_url in the Ruby/Rails SDK) automatically generates the image source URL itself. For example, using the URL helper method to return the URL of the
sample image, padded to a scaled width and height of 300 pixels with a blue background for the padding:
This SDK code outputs the URL:
By default, the Cloudinary image tag helper method (e.g.,
cl_image_tag in Ruby on Rails) automatically generates an HTML image tag including the image source URL.
The following shows the same transformations as above, but this time using the image tag to generate a complete HTML image tag.
This SDK code will output the following HTML code:
The Cloudinary Image Tag helper method allows you to not only specify any Cloudinary transformations parameters, but also to specify regular HTML image tag attributes (e.g., alt, title, width, height). For example, using the Image Tag helper method to create an HTML image tag for the
sample image, with the 'alt' attribute set to "A sample photo" and the 'className' attribute set to "Samples":
For more information on these SDK helper methods, see the transformation documentation in the relevant SDK guide.
Images can be uploaded to Cloudinary in various formats (input formats), and you can easily convert these images to other formats for displaying in your web site or application (output formats). Examples of situations where you might want to change the delivered image format:
- Delivering JPEG images for photos that you want to load quickly (or AVIF or WebP if your users are on a browser that supports these).
- Delivering a PNG (24 bit) for high quality illustrations with a transparent background.
- Delivering an image where the original format is not supported for delivery by the browser. For example, you could deliver a Photoshop (.psd) image as a JPEG.
You can convert and deliver images in a different format by specifying the required format as the file extension of the delivery URL. When using an SDK to build the URL, you can either append the extension of the new format to the asset's public ID or use the
For example, to display a GIF version of the uploaded
sample JPEG file:
You can combine other image transformations with format conversion. Just make sure the format you use is supported for transformations, as per the Supported image formats table. For example, to deliver a scaled down 150x100 GIF version of the
Another option for changing the format is to explicitly call the
fetch_format transformation parameter (
f in URLs). This can be useful in situations where you cannot change the file extension, for example, when fetching remote assets that already have a different file extension (format) as part of their URLs.
For example, to fetch a remote image from Wikimedia in PNG format, and deliver the image in JPEG format (also scaled down to a width of 400 pixels):
- If the file extension is omitted in a delivery URL, the file is delivered in the originally uploaded format unless a specific format (or the auto format is requested using the
f_) transformation parameter).
- When converting from one multi-page or multi-layer image format (PDF, GIF, WebP, TIFF, PSD) to another, only the first 100 pages are included in the new file.
- SDK major versions with initial release later than January 2020 have a
formattransformation parameter, instead of the
fetch_formatparameter. See f (format) in the transformation reference.
You can take advantage of Cloudinary's automatic format selection (
f_auto) transformation to automatically deliver images in the most optimized format that's supported by the requesting browser.
For example, if you deliver a JPEG image with
f_auto, Cloudinary might generate and deliver the image as a WebP, AVIF or JPEG-2000 file, depending on the requesting browser and your account setup. The
f_auto algorithm will similarly deliver the best format when the original asset is a PNG (with or without transparency), an animated GIF, etc.
The table below summarizes the supported image formats.
|Format||Extensions||Supported for Upload 1||Supported for Transformations 2|
|AI (Adobe Illustrator)||.ai||Yes||Yes|
|animated AVIF||.avif||No||Yes 9|
|BW (Browzwear file)||.bw||Yes||Yes 6|
|DNG (Digital Negative)||.dng||Yes||No|
|EPS (Encapsulated PostScript)||.ps, .ept, .eps, .eps3||Yes||Yes|
|FBX (Filmbox)||.fbx 10||Yes||Yes 6|
|FLIF (Free Lossless Image Format)||.flif||Yes||Yes|
|GLB (Binary glTF)||.glb||Yes||Yes|
|glTF (GL Transmission Format)||.gltf||Yes||Yes 6|
|JPEG||.jpg, .jpe, .jpeg||Yes||Yes|
|JPEG 2000||.jp2 4||Yes||Yes|
|JPEG XR (JPEG eXtended Range)||.wdp, .jxr, .hdp||Yes||Yes|
|JXL (JPEG XL)||.jxl||Yes||Yes|
|OBJ||.obj 10||Yes||Yes 6|
|PSD (PhotoShop Document)||.psd||Yes||Yes 5|
|Raw image files||.arw, .cr2||Yes||No|
|TARGA (Truevision TGA)||.tga||Yes||Yes|
|U3MA (Fabric file)||.u3ma||Yes||Yes 6|
|USDZ||.usdz||Yes 7||No 8|
- If a format is supported only for upload, then the delivery URL enables a user to download the original file in its original format, but you cannot apply transformation parameters.
If a format is supported for transformations, but the browser doesn't support displaying that format, you can either provide the transformation URL with the original format to enable users to download the file, or you can provide the URL with a different delivery format specified. In that case, Cloudinary applies the transformation to the original format and then converts the image to the requested format for delivery. For example, you could provide a transformation URL for a PhotoShop (.psd) image and specify
jpgas the delivery format to display the resulting transformation in the browser.
You can transform an InDesign file if you deliver it as an image format, such as
png, but you cannot deliver an
inddfile with transformations.
By default, when you request a
jp2image with a quality value less than 90, chroma sub-sampling (420) is automatically applied using Kakadu. You can also explicitly request chroma sub-sampling as part of your
qualityparameter. For example:
All layers are flattened into a single image if no
pageparameter is specified.
- The 3D format types are uploaded as a zip file. Some transformations, such as converting to a video or image, are supported on the bundle as a whole. No transformations are currently supported on its contained assets. For further information see Transformations on 3D models.
- USDZ files can only be uploaded as raw files.
- Transformations cannot be applied to USDZ files, but you can deliver any uploaded 3D model as a USDZ file.
Images converted to AVIF and animated AVIF from other formats use additional quota. Images exceeding 30 megapixels cannot be encoded to AVIF - ensure you scale them down first. You can request to enable AVIF and animated AVIF as possible formats to be delivered when automatic format selection (
f_auto) is used.
- You cannot convert a 3D model of a different format to FBX or OBJ.
This page walked you through the basics of how image transformations work. The rest of the pages in this guide provide details, use cases and examples of the many different types of transformations you can apply to the images you deliver:
|Resizing and cropping||Resize (crop and/or scale) images server-side before delivering them.|
|Placing layers on images||Place image, text, or other layers on (or under) existing assets to generate new and customized creations on the fly.|
|Effects and enhancements||Apply a huge variety of effects, filters, and other artistic enhancements to any image.|
|Face-detection based transformations||Transform an image based on detected faces.|
|Animated image transformations||Create animated images from multiple images in your product environment, convert them to video, convert between animated formats, and apply animation-specific transformations.|
|3D models||Learn how to perform transformations on 3D models.|
|Conditional transformations||Apply a transformation only if a specified condition is met.|
|User-defined variables and arithmetic transformations||Use arithmetic expressions and variables to add additional sophistication and flexibility to your transformations.|
|Custom functions||Inject a remote, lamda or WebAssembly function and apply the result as a transformation.|
In addition to changing the appearance of your media assets by transforming them, you can also use Cloudinary URLs and a variety of parameters to control how they are delivered:
|Optimizations||Deliver your media assets with the smallest possible file size while maintaining visual quality, saving bandwidth and improving performance for your website. This includes automatic quality and format selection optimizations (q_auto and f_auto).|
|Responsive images||Deliver your images to perfectly fit any device, viewport size, orientation, or resolution at any pixel density (DPR). Upload a single high resolution image and let Cloudinary automatically transform it.|
Deliver remote media files
Social media profile pictures
|Grab media assets from anywhere on the web or pull social media profile pictures from a variety of popular social media networks, including support for on-the-fly transformation and optimized delivery via a CDN.|
|Paged and layered media||Deliver content from assets with multiple pages or layers such as PDFs or Photoshop files, including options for delivering or transforming only selected pages or layers.|
|Access control||Control who can access your media, both the originals and transformed assets, including enabling strict transformations, using signed delivery URLs, uploading images as private or authenticated, and using
|Advanced URL delivery options||Take advantage of advanced options that make your URLs more SEO-friendly, deliver assets using private CDNs or multi-CDN solutions, use custom domain names (CNames) for your URLs, define custom favicons, work with asset versions, and more.|
Cloudinary provides a variety of methods to create new assets in your product environment.
|Animated images||Create a single animated image from multiple image assets, where each asset is used as a single frame of the resulting animated image.|
|PDF files from images||Create a PDF from multiple image assets, where each asset is used as a single frame of the resulting PDF file.|
|Sprites||Create and deliver sprite images with their corresponding CSS based on all images with a specified tag.|
|Image collages||Create image collages from multiple image assets, combined together in a specific layout, with spacing and colors defined in a template.|
|Images from text||Create an image of a given textual string and customize the look & feel of the resulting image with various font, color and style parameters.|
- Transformation URL API Reference: Details all available transformation parameters. Icons indicate which parameters are supported for each asset type.
- Video transformations guide: Provides details and examples of the transformations you can apply to video assets.
- Transformation basics video tutorial: Watch a quick video on how these dynamic transformation URLs work.
- How are transformations counted?: Details how various transformations are counted for monthly billing.