Transformation URL API Reference

Although not a transformation parameter belonging to the <transformation> element of the URL, the extension of the URL can transform the format of the delivered asset, in the same way as f_<supported format>.

If f_<supported format> or f_<auto> are not specified in the URL, the format is determined by the extension. If no format or extension is specified, then the asset is delivered in its originally uploaded format.

If using an SDK to generate your URL, you can control the extension using the format parameter, or by adding the extension to the public ID.
If using a raw transformation, for example to define an eager or named transformation, you can specify the extension at the end of the transformation parameters, following a forward slash. For example, c_pad,h_300,w_300/jpg means that the delivery URL has transformation parameters of c_pad,h_300,w_300 and a .jpg extension. c_pad,h_300,w_300/ represents the same transformation parameters, but with no extension.

Note

As the extension is considered to be part of the transformation, be careful when defining eager transformations and transformations that are allowed when strict transformations are enabled, as the delivery URL must exactly match the transformation, including the extension.

Value	Type	Description
extension	string	The format to use when delivering the asset. Possible values: Any supported delivery format as relevant for the file type you are delivering: Supported image formats Supported video formats Supported audio formats Default: The originally uploaded format of the asset.

Value

Type

Description

extension

string

The format to use when delivering the asset.

Possible values: Any supported delivery format as relevant for the file type you are delivering:

Default: The originally uploaded format of the asset.

Examples

Deliver the image as a JPEG (.jpg):

URL Ruby PHP Python Node.js Java JS jQuery React Vue.js Angular .NET iOS Android Kotlin All

URL:

https://res.cloudinary.com/demo/image/upload/sheep.jpg

Ruby:

cl_image_tag("sheep.jpg")

PHP (cloudinary_php v1.x (legacy)):

cl_image_tag("sheep.jpg")

Library:

PHP (cloudinary_php v2.x):

(new ImageTag('sheep.jpg'));

Library:

Python:

CloudinaryImage("sheep.jpg").image()

Node.js:

cloudinary.image("sheep.jpg")

Java:

cloudinary.url().transformation(new Transformation().imageTag("sheep.jpg");

JS:

cloudinary.imageTag('sheep.jpg').toHtml();

jQuery:

$.cloudinary.image("sheep.jpg")

React:

<Image publicId="sheep.jpg" >

</Image>

Vue.js:

<cld-image public-id="sheep.jpg" >

</cld-image>

Angular:

<cl-image public-id="sheep.jpg" >

</cl-image>

.NET:

cloudinary.Api.UrlImgUp.BuildImageTag("sheep.jpg")

iOS:

imageView.cldSetImage(cloudinary.createUrl().generate("sheep.jpg")!, cloudinary: cloudinary)

Android:

MediaManager.get().url().transformation(new Transformation().generate("sheep.jpg");

Kotlin:

cloudinary.image {
publicId("sheep.jpg")
}.generate()

Deliver the image as a PNG (.png):

URL Ruby PHP Python Node.js Java JS jQuery React Vue.js Angular .NET iOS Android Kotlin All

URL:

https://res.cloudinary.com/demo/image/upload/sheep.png

Ruby:

cl_image_tag("sheep.png")

PHP (cloudinary_php v1.x (legacy)):

cl_image_tag("sheep.png")

Library:

PHP (cloudinary_php v2.x):

(new ImageTag('sheep.png'));

Library:

Python:

CloudinaryImage("sheep.png").image()

Node.js:

cloudinary.image("sheep.png")

Java:

cloudinary.url().transformation(new Transformation().imageTag("sheep.png");

JS:

cloudinary.imageTag('sheep.png').toHtml();

jQuery:

$.cloudinary.image("sheep.png")

React:

<Image publicId="sheep.png" >

</Image>

Vue.js:

<cld-image public-id="sheep.png" >

</cld-image>

Angular:

<cl-image public-id="sheep.png" >

</cl-image>

.NET:

cloudinary.Api.UrlImgUp.BuildImageTag("sheep.png")

iOS:

imageView.cldSetImage(cloudinary.createUrl().generate("sheep.png")!, cloudinary: cloudinary)

Android:

MediaManager.get().url().transformation(new Transformation().generate("sheep.png");

Kotlin:

cloudinary.image {
publicId("sheep.png")
}.generate()

Deliver the image in its originally uploaded format (no extension specified):
URL Ruby PHP Python Node.js Java JS jQuery React Vue.js Angular .NET iOS Android Kotlin All
URL:
Copy to clipboard
https://res.cloudinary.com/demo/image/upload/sheep
Ruby:
Copy to clipboard
cl_image_tag("sheep")
PHP (cloudinary_php v1.x (legacy)):
Copy to clipboard
cl_image_tag("sheep")
Library:
PHP (cloudinary_php v2.x):
Copy to clipboard
(new ImageTag('sheep'));
Library:
Python:
Copy to clipboard
CloudinaryImage("sheep").image()
Node.js:
Copy to clipboard
cloudinary.image("sheep")
Java:
Copy to clipboard
cloudinary.url().transformation(new Transformation().imageTag("sheep");
JS:
Copy to clipboard
cloudinary.imageTag('sheep').toHtml();
jQuery:
Copy to clipboard
$.cloudinary.image("sheep")
React:
Copy to clipboard
<Image publicId="sheep" > </Image>
Vue.js:
Copy to clipboard
<cld-image public-id="sheep" > </cld-image>
Angular:
Copy to clipboard
<cl-image public-id="sheep" > </cl-image>
.NET:
Copy to clipboard
cloudinary.Api.UrlImgUp.BuildImageTag("sheep")
iOS:
Copy to clipboard
imageView.cldSetImage(cloudinary.createUrl().generate("sheep")!, cloudinary: cloudinary)
Android:
Copy to clipboard
MediaManager.get().url().transformation(new Transformation().generate("sheep");
Kotlin:
Copy to clipboard
cloudinary.image { publicId("sheep") }.generate()

Rotates or flips an asset by the specified number of degrees or automatically according to its orientation or available metadata. Multiple modes can be applied by concatenating their values with a dot.

Learn more: Rotating images | Rotating videos

a_<degrees>

Rotates an asset by the specified angle.

See also: Arithmetic expressions

Value	Type	Description
degrees	integer	The number of degrees to rotate the asset clockwise (positive value) or counter-clockwise (negative value). If the angle is not a multiple of 90, a rectangular bounding box is added containing the rotated asset.

Note

If either the width or height of an asset exceeds 3000 pixels, the asset is automatically downscaled first, and then rotated. This applies to the size of the asset that is the input to the rotation, whether that be the output of a previous chained transformation or the original asset size.

Examples

Rotate an image by 90 degrees clockwise (a_90):

URL Ruby PHP Python Node.js Java JS jQuery React Vue.js Angular .NET iOS Android Kotlin All

URL:

https://res.cloudinary.com/demo/image/upload/a_90/sheep.jpg

Ruby:

cl_image_tag("sheep.jpg", :angle=>90)

PHP (cloudinary_php v1.x (legacy)):

cl_image_tag("sheep.jpg", array("angle"=>90))

Library:

PHP (cloudinary_php v2.x):

(new ImageTag('sheep.jpg'))
  ->rotate(Rotate::byAngle(90));

Library:

Python:

CloudinaryImage("sheep.jpg").image(angle=90)

Node.js:

cloudinary.image("sheep.jpg", {angle: 90})

Java:

cloudinary.url().transformation(new Transformation().angle(90)).imageTag("sheep.jpg");

JS:

cloudinary.imageTag('sheep.jpg', {angle: 90}).toHtml();

jQuery:

$.cloudinary.image("sheep.jpg", {angle: 90})

React:

<Image publicId="sheep.jpg" >
  <Transformation angle="90" />
</Image>

Vue.js:

<cld-image public-id="sheep.jpg" >
  <cld-transformation angle="90" />
</cld-image>

Angular:

<cl-image public-id="sheep.jpg" >
  <cl-transformation angle="90">
  </cl-transformation>
</cl-image>

.NET:

cloudinary.Api.UrlImgUp.Transform(new Transformation().Angle(90)).BuildImageTag("sheep.jpg")

iOS:

imageView.cldSetImage(cloudinary.createUrl().setTransformation(CLDTransformation().setAngle(90)).generate("sheep.jpg")!, cloudinary: cloudinary)

Android:

MediaManager.get().url().transformation(new Transformation().angle(90)).generate("sheep.jpg");

Kotlin:

cloudinary.image {
publicId("sheep.jpg")
rotate(Rotate.byAngle(90))
}.generate()

Rotate a video by 20 degrees counterclockwise (a_-20):

URL Ruby PHP Python Node.js Java JS jQuery React Vue.js Angular .NET iOS Android Kotlin All

URL:

https://res.cloudinary.com/demo/video/upload/a_-20/dog.mp4

Ruby:

cl_video_tag("dog", :angle=>-20)

PHP (cloudinary_php v1.x (legacy)):

cl_video_tag("dog", array("angle"=>-20))

Library:

PHP (cloudinary_php v2.x):

(new VideoTag('dog.mp4'))
  ->rotate(Rotate::byAngle(-20));

Library:

Python:

CloudinaryVideo("dog").video(angle=-20)

Node.js:

cloudinary.video("dog", {angle: -20})

Java:

cloudinary.url().transformation(new Transformation().angle(-20)).videoTag("dog");

JS:

cloudinary.videoTag('dog', {angle: -20}).toHtml();

jQuery:

$.cloudinary.video("dog", {angle: -20})

React:

<Video publicId="dog" >
  <Transformation angle="-20" />
</Video>

Vue.js:

<cld-video public-id="dog" >
  <cld-transformation angle="-20" />
</cld-video>

Angular:

<cl-video public-id="dog" >
  <cl-transformation angle="-20">
  </cl-transformation>
</cl-video>

.NET:

cloudinary.Api.UrlVideoUp.Transform(new Transformation().Angle(-20)).BuildVideoTag("dog")

iOS:

cloudinary.createUrl().setResourceType("video").setTransformation(CLDTransformation().setAngle(-20)).generate("dog.mp4")

Android:

MediaManager.get().url().transformation(new Transformation().angle(-20)).resourceType("video").generate("dog.mp4");

Kotlin:

cloudinary.video {
publicId("dog.mp4")
rotate(Rotate.byAngle(-20))
}.generate()

a_<mode>

Rotates an image based on the specified mode.

Value Type Description

mode

constant

Value	Type	Description
mode	constant	Required. The rotation mode to apply. Possible values: `auto_right`: If the requested aspect ratio does not match the image's aspect ratio, rotates the image 90 degrees clockwise. `auto_left`: If the requested aspect ratio does not match the image's aspect ratio, rotates the image 90 degrees counterclockwise only. `vflip`: Vertically mirror flips the image. `hflip`: Horizontally mirror flips the image. `ignore`: Prevents Cloudinary from automatically rotating the image according to the EXIF data stored by the camera when the image was taken.

Required. The rotation mode to apply.

Possible values:

auto_right: If the requested aspect ratio does not match the image's aspect ratio, rotates the image 90 degrees clockwise.
auto_left: If the requested aspect ratio does not match the image's aspect ratio, rotates the image 90 degrees counterclockwise only.
vflip: Vertically mirror flips the image.
hflip: Horizontally mirror flips the image.
ignore: Prevents Cloudinary from automatically rotating the image according to the EXIF data stored by the camera when the image was taken.

Examples

Rotate image 90 degrees clockwise only if the requested aspect ratio does not match the image's aspect ratio (a_auto_right):

URL Ruby PHP Python Node.js Java JS jQuery React Vue.js Angular .NET iOS Android Kotlin All

URL:

https://res.cloudinary.com/demo/image/upload/a_auto_right/sheep.jpg

Ruby:

cl_image_tag("sheep.jpg", :angle=>"auto_right")

PHP (cloudinary_php v1.x (legacy)):

cl_image_tag("sheep.jpg", array("angle"=>"auto_right"))

Library:

PHP (cloudinary_php v2.x):

(new ImageTag('sheep.jpg'))
  ->rotate(Rotate::mode(RotationMode::autoRight()));

Library:

Python:

CloudinaryImage("sheep.jpg").image(angle="auto_right")

Node.js:

cloudinary.image("sheep.jpg", {angle: "auto_right"})

Java:

cloudinary.url().transformation(new Transformation().angle("auto_right")).imageTag("sheep.jpg");

JS:

cloudinary.imageTag('sheep.jpg', {angle: "auto_right"}).toHtml();

jQuery:

$.cloudinary.image("sheep.jpg", {angle: "auto_right"})

React:

<Image publicId="sheep.jpg" >
  <Transformation angle="auto_right" />
</Image>

Vue.js:

<cld-image public-id="sheep.jpg" >
  <cld-transformation angle="auto_right" />
</cld-image>

Angular:

<cl-image public-id="sheep.jpg" >
  <cl-transformation angle="auto_right">
  </cl-transformation>
</cl-image>

.NET:

cloudinary.Api.UrlImgUp.Transform(new Transformation().Angle("auto_right")).BuildImageTag("sheep.jpg")

iOS:

imageView.cldSetImage(cloudinary.createUrl().setTransformation(CLDTransformation().setAngle("auto_right")).generate("sheep.jpg")!, cloudinary: cloudinary)

Android:

MediaManager.get().url().transformation(new Transformation().angle("auto_right")).generate("sheep.jpg");

Kotlin:

cloudinary.image {
publicId("sheep.jpg")
rotate(Rotate.mode(RotationMode.autoRight()))
}.generate()

Rotate image by 90 degrees clockwise if aspect ratio does not match original

Vertically mirror flip the image and then rotate it by another 20 degrees clockwise using the dot notation to apply more than one rotation option (a_vflip):

URL Ruby PHP Python Node.js Java JS jQuery React Vue.js Angular .NET iOS Android Kotlin All

URL:

https://res.cloudinary.com/demo/image/upload/a_vflip.20/sheep.jpg

Ruby:

cl_image_tag("sheep.jpg", :angle=>["vflip", 20])

PHP (cloudinary_php v1.x (legacy)):

cl_image_tag("sheep.jpg", array("angle"=>array("vflip", 20)))

Library:

PHP (cloudinary_php v2.x):

(new ImageTag('sheep.jpg'))
  ->rotate(Rotate::mode(RotationMode::verticalFlip()))
  ->rotate(Rotate::byAngle(20));

Library:

Python:

CloudinaryImage("sheep.jpg").image(angle=["vflip", 20])

Node.js:

cloudinary.image("sheep.jpg", {angle: ["vflip", 20]})

Java:

cloudinary.url().transformation(new Transformation().angle("vflip", "20")).imageTag("sheep.jpg");

JS:

cloudinary.imageTag('sheep.jpg', {angle: ["vflip", 20]}).toHtml();

jQuery:

$.cloudinary.image("sheep.jpg", {angle: ["vflip", 20]})

React:

<Image publicId="sheep.jpg" >
  <Transformation angle={["vflip", 20]} />
</Image>

Vue.js:

<cld-image public-id="sheep.jpg" >
  <cld-transformation angle={["vflip", 20]} />
</cld-image>

Angular:

<cl-image public-id="sheep.jpg" >
  <cl-transformation angle={{["vflip", 20]}}>
  </cl-transformation>
</cl-image>

.NET:

cloudinary.Api.UrlImgUp.Transform(new Transformation().Angle("vflip", "20")).BuildImageTag("sheep.jpg")

iOS:

imageView.cldSetImage(cloudinary.createUrl().setTransformation(CLDTransformation().setAngle("vflip", "20")).generate("sheep.jpg")!, cloudinary: cloudinary)

Android:

MediaManager.get().url().transformation(new Transformation().angle("vflip", "20")).generate("sheep.jpg");

Kotlin:

cloudinary.image {
publicId("sheep.jpg")
rotate(Rotate.mode(RotationMode.verticalFlip()))
rotate(Rotate.byAngle(20))
}.generate()

ac_<codec value>

Sets the audio codec.

Value Type Description

codec value

constant

Value	Type	Description
codec value	constant	Required. The audio codec to use. Possible values: `none`: Removes the audio channel. `aac`: Sets the audio codec to aac (mp4 or flv only). `vorbis`: Sets the audio codec to vorbis (ogv or webm only). `mp3`: Sets the audio codec to mp3 (mp4 or flv only). `opus`: Sets the audio codec to opus (webm only).

Required. The audio codec to use.

Possible values:

none: Removes the audio channel.
aac: Sets the audio codec to aac (mp4 or flv only).
vorbis: Sets the audio codec to vorbis (ogv or webm only).
mp3: Sets the audio codec to mp3 (mp4 or flv only).
opus: Sets the audio codec to opus (webm only).

Examples

Remove the audio from a video (ac_none):

URL Ruby PHP Python Node.js Java JS jQuery React Vue.js Angular .NET iOS Android Kotlin All

URL:

https://res.cloudinary.com/demo/video/upload/ac_none/dog.mp4

Ruby:

cl_video_tag("dog", :audio_codec=>"none")

PHP (cloudinary_php v1.x (legacy)):

cl_video_tag("dog", array("audio_codec"=>"none"))

Library:

PHP (cloudinary_php v2.x):

(new VideoTag('dog.mp4'))
  ->transcode(Transcode::audioCodec(AudioCodec::none()));

Library:

Python:

CloudinaryVideo("dog").video(audio_codec="none")

Node.js:

cloudinary.video("dog", {audio_codec: "none"})

Java:

cloudinary.url().transformation(new Transformation().audioCodec("none")).videoTag("dog");

JS:

cloudinary.videoTag('dog', {audioCodec: "none"}).toHtml();

jQuery:

$.cloudinary.video("dog", {audio_codec: "none"})

React:

<Video publicId="dog" >
  <Transformation audioCodec="none" />
</Video>

Vue.js:

<cld-video public-id="dog" >
  <cld-transformation audio-codec="none" />
</cld-video>

Angular:

<cl-video public-id="dog" >
  <cl-transformation audio-codec="none">
  </cl-transformation>
</cl-video>

.NET:

cloudinary.Api.UrlVideoUp.Transform(new Transformation().AudioCodec("none")).BuildVideoTag("dog")

iOS:

cloudinary.createUrl().setResourceType("video").setTransformation(CLDTransformation().setAudioCodec("none")).generate("dog.mp4")

Android:

MediaManager.get().url().transformation(new Transformation().audioCodec("none")).resourceType("video").generate("dog.mp4");

Kotlin:

cloudinary.video {
publicId("dog.mp4")
transcode(Transcode.audioCodec(AudioCodec.none()))
}.generate()

af_<frequency value>

Controls the audio sampling frequency.

As a qualifier, can be used to preserve the original frequency, overriding the default frequency behavior of vc_auto.

As a qualifier, use with: vc_auto

Learn more: Audio frequency control

Value Type Description

frequency value

string | constant

Value	Type	Description
frequency value	string \| constant	A frequency value in Hz. Possible values: A fixed value specific to the codec used: aac: `96000`, `88200`, `64000`, `48000`, `44100`, `32000`, `24000`, `22050`, `16000`, `12000`, `11025`, `8000`, `7350` libfdk_aac: `96000`, `88200`, `64000`, `48000`, `44100`, `32000`, `24000`, `22050`, `16000`, `12000`, `11025`, `8000`, `0` mp3: `44100`, `48000`, `32000`, `22050`, `24000`, `16000`, `11025`, `12000`, `8000`, `0` opus: `48000`, `24000`, `16000`, `12000`, `8000`, `0` pcm: `48000`, `96000`, `0` `iaf`: Retains the original (initial) audio frequency of the video. This value is relevant when using vc_auto, where the audio frequency would otherwise automatically default to another value.

A frequency value in Hz.

Possible values:

A fixed value specific to the codec used:
- aac: 96000, 88200, 64000, 48000, 44100, 32000, 24000, 22050, 16000, 12000, 11025, 8000, 7350
- libfdk_aac: 96000, 88200, 64000, 48000, 44100, 32000, 24000, 22050, 16000, 12000, 11025, 8000, 0
- mp3: 44100, 48000, 32000, 22050, 24000, 16000, 11025, 12000, 8000, 0
- opus: 48000, 24000, 16000, 12000, 8000, 0
- pcm: 48000, 96000, 0
iaf: Retains the original (initial) audio frequency of the video. This value is relevant when using vc_auto, where the audio frequency would otherwise automatically default to another value.

Example

Set the audio frequency to 96000 Hz (af_96000):

URL Ruby PHP Python Node.js Java JS jQuery React Vue.js Angular .NET iOS Android Kotlin All

URL:

https://res.cloudinary.com/demo/video/upload/af_96000/dog.mp4

Ruby:

cl_video_tag("dog", :audio_frequency=>"96000")

PHP (cloudinary_php v1.x (legacy)):

cl_video_tag("dog", array("audio_frequency"=>"96000"))

Library:

PHP (cloudinary_php v2.x):

(new VideoTag('dog.mp4'))
  ->transcode(Transcode::audioFrequency(96000));

Library:

Python:

CloudinaryVideo("dog").video(audio_frequency="96000")

Node.js:

cloudinary.video("dog", {audio_frequency: "96000"})

Java:

cloudinary.url().transformation(new Transformation().audioFrequency("96000")).videoTag("dog");

JS:

cloudinary.videoTag('dog', {audioFrequency: "96000"}).toHtml();

jQuery:

$.cloudinary.video("dog", {audio_frequency: "96000"})

React:

<Video publicId="dog" >
  <Transformation audioFrequency="96000" />
</Video>

Vue.js:

<cld-video public-id="dog" >
  <cld-transformation audio-frequency="96000" />
</cld-video>

Angular:

<cl-video public-id="dog" >
  <cl-transformation audio-frequency="96000">
  </cl-transformation>
</cl-video>

.NET:

cloudinary.Api.UrlVideoUp.Transform(new Transformation().AudioFrequency("96000")).BuildVideoTag("dog")

iOS:

cloudinary.createUrl().setResourceType("video").setTransformation(CLDTransformation().setAudioFrequency("96000")).generate("dog.mp4")

Android:

MediaManager.get().url().transformation(new Transformation().audioFrequency("96000")).resourceType("video").generate("dog.mp4");

Kotlin:

cloudinary.video {
publicId("dog.mp4")
transcode(Transcode.audioFrequency(96000))
}.generate()

ar_<ratio value>

A qualifier that crops or resizes the asset to a new aspect ratio, for use with a crop/resize mode that determines how the asset is adjusted to the new dimensions.

Use with: c (crop/resize)

Learn more: Setting the resize dimensions

See also: h (height) | w (width) | Arithmetic expressions

Value Type Description

ratio value

string | float

Value	Type	Description
ratio value	string \| float	Required. The aspect ratio to apply. Can be set as either: A string value in the form `a:b`, where `a` is the width and `b` is the height (e.g., `16:9`). A decimal value representing the width divided by the height (e.g., `0.5`).

Required. The aspect ratio to apply. Can be set as either:

A string value in the form a:b, where a is the width and b is the height (e.g., 16:9).
A decimal value representing the width divided by the height (e.g., 0.5).

Examples

Crop an image to an aspect ratio of 1.5 (ar_1.5,c_crop):

URL Ruby PHP Python Node.js Java JS jQuery React Vue.js Angular .NET iOS Android Kotlin All

URL:

https://res.cloudinary.com/demo/image/upload/ar_1.5,c_crop/sample.jpg

Ruby:

cl_image_tag("sample.jpg", :aspect_ratio=>"1.5", :crop=>"crop")

PHP (cloudinary_php v1.x (legacy)):

cl_image_tag("sample.jpg", array("aspect_ratio"=>"1.5", "crop"=>"crop"))

Library:

PHP (cloudinary_php v2.x):

(new ImageTag('sample.jpg'))
  ->resize(Resize::crop()->aspectRatio(1.5));

Library:

Python:

CloudinaryImage("sample.jpg").image(aspect_ratio="1.5", crop="crop")

Node.js:

cloudinary.image("sample.jpg", {aspect_ratio: "1.5", crop: "crop"})

Java:

cloudinary.url().transformation(new Transformation().aspectRatio("1.5").crop("crop")).imageTag("sample.jpg");

JS:

cloudinary.imageTag('sample.jpg', {aspectRatio: "1.5", crop: "crop"}).toHtml();

jQuery:

$.cloudinary.image("sample.jpg", {aspect_ratio: "1.5", crop: "crop"})

React:

<Image publicId="sample.jpg" >
  <Transformation aspectRatio="1.5" crop="crop" />
</Image>

Vue.js:

<cld-image public-id="sample.jpg" >
  <cld-transformation aspect-ratio="1.5" crop="crop" />
</cld-image>

Angular:

<cl-image public-id="sample.jpg" >
  <cl-transformation aspect-ratio="1.5" crop="crop">
  </cl-transformation>
</cl-image>

.NET:

cloudinary.Api.UrlImgUp.Transform(new Transformation().AspectRatio("1.5").Crop("crop")).BuildImageTag("sample.jpg")

iOS:

imageView.cldSetImage(cloudinary.createUrl().setTransformation(CLDTransformation().setAspectRatio("1.5").setCrop("crop")).generate("sample.jpg")!, cloudinary: cloudinary)

Android:

MediaManager.get().url().transformation(new Transformation().aspectRatio("1.5").crop("crop")).generate("sample.jpg");

Kotlin:

cloudinary.image {
publicId("sample.jpg")
resize(Resize.crop() {
aspectRatio(1.5f)
})
}.generate()

Fill a video to an aspect ratio of 1:1 (ar_1:1,c_fill):

URL Ruby PHP Python Node.js Java JS jQuery React Vue.js Angular .NET iOS Android Kotlin All

URL:

https://res.cloudinary.com/demo/video/upload/ar_1:1,c_fill/dog.mp4

Ruby:

cl_video_tag("dog", :aspect_ratio=>"1:1", :crop=>"fill")

PHP (cloudinary_php v1.x (legacy)):

cl_video_tag("dog", array("aspect_ratio"=>"1:1", "crop"=>"fill"))

Library:

PHP (cloudinary_php v2.x):

(new VideoTag('dog.mp4'))
  ->resize(Resize::fill()
    ->aspectRatio(AspectRatio::ar1X1()));

Library:

Python:

CloudinaryVideo("dog").video(aspect_ratio="1:1", crop="fill")

Node.js:

cloudinary.video("dog", {aspect_ratio: "1:1", crop: "fill"})

Java:

cloudinary.url().transformation(new Transformation().aspectRatio("1:1").crop("fill")).videoTag("dog");

JS:

cloudinary.videoTag('dog', {aspectRatio: "1:1", crop: "fill"}).toHtml();

jQuery:

$.cloudinary.video("dog", {aspect_ratio: "1:1", crop: "fill"})

React:

<Video publicId="dog" >
  <Transformation aspectRatio="1:1" crop="fill" />
</Video>

Vue.js:

<cld-video public-id="dog" >
  <cld-transformation aspect-ratio="1:1" crop="fill" />
</cld-video>

Angular:

<cl-video public-id="dog" >
  <cl-transformation aspect-ratio="1:1" crop="fill">
  </cl-transformation>
</cl-video>

.NET:

cloudinary.Api.UrlVideoUp.Transform(new Transformation().AspectRatio("1:1").Crop("fill")).BuildVideoTag("dog")

iOS:

cloudinary.createUrl().setResourceType("video").setTransformation(CLDTransformation().setAspectRatio("1:1").setCrop("fill")).generate("dog.mp4")

Android:

MediaManager.get().url().transformation(new Transformation().aspectRatio("1:1").crop("fill")).resourceType("video").generate("dog.mp4");

Kotlin:

cloudinary.video {
publicId("dog.mp4")
resize(Resize.fill() {
aspectRatio(AspectRatio.ar1X1())
})
}.generate()

Applies a background to empty or transparent areas.

b_<color value>

Applies the specified background color on transparent background areas in an image.

Can also be used as a qualifier to override the default background color for padded cropping, text overlays and generated waveform images.

Learn more: Background color for images | Background color for videos

Value Type Description

color value

string

Value	Type	Description
color value	string	Required. The background color to apply. It can be set as: A 3- or 4-digit RGB/RGBA hex An RGB or RGBA hex triplet or quadruplet (6 or 8 digits). A named color When specifying any RGB or RGBA value, always prefix the value in the URL with `rgb:` (without `#`). For example, `b_rgb:FEB61FC2` or `b_rgb:999`. When using a named color, specify only the color name. For example `b_blue`.

Required. The background color to apply. It can be set as:

A 3- or 4-digit RGB/RGBA hex
An RGB or RGBA hex triplet or quadruplet (6 or 8 digits).
A named color

When specifying any RGB or RGBA value, always prefix the value in the URL with rgb: (without #). For example, b_rgb:FEB61FC2 or b_rgb:999.

When using a named color, specify only the color name. For example b_blue.

Examples

Convert the transparent background of the car_white image to a light-blue color (b_lightblue):

URL Ruby PHP Python Node.js Java JS jQuery React Vue.js Angular .NET iOS Android Kotlin All

URL:

https://res.cloudinary.com/demo/image/upload/b_lightblue/car_white.png

Ruby:

cl_image_tag("car_white.png", :background=>"lightblue")

PHP (cloudinary_php v1.x (legacy)):

cl_image_tag("car_white.png", array("background"=>"lightblue"))

Library:

PHP (cloudinary_php v2.x):

(new ImageTag('car_white.png'))
  ->backgroundColor(Color::LIGHTBLUE);

Library:

Python:

CloudinaryImage("car_white.png").image(background="lightblue")

Node.js:

cloudinary.image("car_white.png", {background: "lightblue"})

Java:

cloudinary.url().transformation(new Transformation().background("lightblue")).imageTag("car_white.png");

JS:

cloudinary.imageTag('car_white.png', {background: "lightblue"}).toHtml();

jQuery:

$.cloudinary.image("car_white.png", {background: "lightblue"})

React:

<Image publicId="car_white.png" >
  <Transformation background="lightblue" />
</Image>

Vue.js:

<cld-image public-id="car_white.png" >
  <cld-transformation background="lightblue" />
</cld-image>

Angular:

<cl-image public-id="car_white.png" >
  <cl-transformation background="lightblue">
  </cl-transformation>
</cl-image>

.NET:

cloudinary.Api.UrlImgUp.Transform(new Transformation().Background("lightblue")).BuildImageTag("car_white.png")

iOS:

imageView.cldSetImage(cloudinary.createUrl().setTransformation(CLDTransformation().setBackground("lightblue")).generate("car_white.png")!, cloudinary: cloudinary)

Android:

MediaManager.get().url().transformation(new Transformation().background("lightblue")).generate("car_white.png");

Kotlin:

cloudinary.image {
publicId("car_white.png")
backgroundColor(Color.LIGHTBLUE)
}.generate()

Convert the transparent areas of an image to the specified color

Scale to fit an image into a 300X300 square and pad any excess space with a pink background (b_pink):

URL Ruby PHP Python Node.js Java JS jQuery React Vue.js Angular .NET iOS Android Kotlin All

URL:

https://res.cloudinary.com/demo/image/upload/w_150,h_150,c_pad,b_pink/sample.jpg

Ruby:

cl_image_tag("sample.jpg", :width=>150, :height=>150, :background=>"pink", :crop=>"pad")

PHP (cloudinary_php v1.x (legacy)):

cl_image_tag("sample.jpg", array("width"=>150, "height"=>150, "background"=>"pink", "crop"=>"pad"))

Library:

PHP (cloudinary_php v2.x):

(new ImageTag('sample.jpg'))
  ->resize(Resize::pad()->width(150)->height(150)
    ->background(Background::color(Color::PINK)));

Library:

Python:

CloudinaryImage("sample.jpg").image(width=150, height=150, background="pink", crop="pad")

Node.js:

cloudinary.image("sample.jpg", {width: 150, height: 150, background: "pink", crop: "pad"})

Java:

cloudinary.url().transformation(new Transformation().width(150).height(150).background("pink").crop("pad")).imageTag("sample.jpg");

JS:

cloudinary.imageTag('sample.jpg', {width: 150, height: 150, background: "pink", crop: "pad"}).toHtml();

jQuery:

$.cloudinary.image("sample.jpg", {width: 150, height: 150, background: "pink", crop: "pad"})

React:

<Image publicId="sample.jpg" >
  <Transformation width="150" height="150" background="pink" crop="pad" />
</Image>

Vue.js:

<cld-image public-id="sample.jpg" >
  <cld-transformation width="150" height="150" background="pink" crop="pad" />
</cld-image>

Angular:

<cl-image public-id="sample.jpg" >
  <cl-transformation width="150" height="150" background="pink" crop="pad">
  </cl-transformation>
</cl-image>

.NET:

cloudinary.Api.UrlImgUp.Transform(new Transformation().Width(150).Height(150).Background("pink").Crop("pad")).BuildImageTag("sample.jpg")

iOS:

imageView.cldSetImage(cloudinary.createUrl().setTransformation(CLDTransformation().setWidth(150).setHeight(150).setBackground("pink").setCrop("pad")).generate("sample.jpg")!, cloudinary: cloudinary)

Android:

MediaManager.get().url().transformation(new Transformation().width(150).height(150).background("pink").crop("pad")).generate("sample.jpg");

Kotlin:

cloudinary.image {
publicId("sample.jpg")
resize(Resize.pad() {
width(150)
height(150)
background(Background.color(Color.PINK))
})
}.generate()

Add a semi-transparent yellow background color to a text overlay (b_rgb:FEB61FC2,co_yellow,l_text:Arial_100:Flowers/fl_layer_apply)

URL Ruby PHP Python Node.js Java JS jQuery React Vue.js Angular .NET iOS Android Kotlin All

URL:

https://res.cloudinary.com/demo/image/upload/c_scale,w_400/b_rgb:FEB61FC2,co_yellow,l_text:Arial_100:Flowers/fl_layer_apply/flower.jpg

Ruby:

cl_image_tag("flower.jpg", :transformation=>[
  {:width=>400, :crop=>"scale"},
  {:background=>"#FEB61FC2", :color=>"yellow", :overlay=>{:font_family=>"Arial", :font_size=>100, :text=>"Flowers"}},
  {:flags=>"layer_apply"}
  ])

PHP (cloudinary_php v1.x (legacy)):

cl_image_tag("flower.jpg", array("transformation"=>array(
  array("width"=>400, "crop"=>"scale"),
  array("background"=>"#FEB61FC2", "color"=>"yellow", "overlay"=>array("font_family"=>"Arial", "font_size"=>100, "text"=>"Flowers")),
  array("flags"=>"layer_apply")
  )))

Library:

PHP (cloudinary_php v2.x):

(new ImageTag('flower.jpg'))
  ->resize(Resize::scale()->width(400))
  ->overlay(
      Overlay::source(Source::text('Flowers', (new TextStyle('Arial', 100)))
        ->textColor(Color::YELLOW)
        ->backgroundColor(Color::rgb('FEB61FC2'))
  ));

Library:

Python:

CloudinaryImage("flower.jpg").image(transformation=[
  {'width': 400, 'crop': "scale"},
  {'background': "#FEB61FC2", 'color': "yellow", 'overlay': {'font_family': "Arial", 'font_size': 100, 'text': "Flowers"}},
  {'flags': "layer_apply"}
  ])

Node.js:

cloudinary.image("flower.jpg", {transformation: [
  {width: 400, crop: "scale"},
  {background: "#FEB61FC2", color: "yellow", overlay: {font_family: "Arial", font_size: 100, text: "Flowers"}},
  {flags: "layer_apply"}
  ]})

Java:

cloudinary.url().transformation(new Transformation()
  .width(400).crop("scale").chain()
  .background("#FEB61FC2").color("yellow").overlay(new TextLayer().fontFamily("Arial").fontSize(100).text("Flowers")).chain()
  .flags("layer_apply")).imageTag("flower.jpg");

JS:

cloudinary.imageTag('flower.jpg', {transformation: [
  {width: 400, crop: "scale"},
  {background: "#FEB61FC2", color: "yellow", overlay: new cloudinary.TextLayer().fontFamily("Arial").fontSize(100).text("Flowers")},
  {flags: "layer_apply"}
  ]}).toHtml();

jQuery:

$.cloudinary.image("flower.jpg", {transformation: [
  {width: 400, crop: "scale"},
  {background: "#FEB61FC2", color: "yellow", overlay: new cloudinary.TextLayer().fontFamily("Arial").fontSize(100).text("Flowers")},
  {flags: "layer_apply"}
  ]})

React:

<Image publicId="flower.jpg" >
  <Transformation width="400" crop="scale" />
  <Transformation background="#FEB61FC2" color="yellow" overlay={{fontFamily: "Arial", fontSize: 100, text: "Flowers"}} />
  <Transformation flags="layer_apply" />
</Image>

Vue.js:

<cld-image public-id="flower.jpg" >
  <cld-transformation width="400" crop="scale" />
  <cld-transformation background="#FEB61FC2" color="yellow" :overlay="{fontFamily: 'Arial', fontSize: 100, text: 'Flowers'}" />
  <cld-transformation flags="layer_apply" />
</cld-image>

Angular:

<cl-image public-id="flower.jpg" >
  <cl-transformation width="400" crop="scale">
  </cl-transformation>
  <cl-transformation background="#FEB61FC2" color="yellow" overlay="text:Arial_100:Flowers">
  </cl-transformation>
  <cl-transformation flags="layer_apply">
  </cl-transformation>
</cl-image>

.NET:

cloudinary.Api.UrlImgUp.Transform(new Transformation()
  .Width(400).Crop("scale").Chain()
  .Background("#FEB61FC2").Color("yellow").Overlay(new TextLayer().FontFamily("Arial").FontSize(100).Text("Flowers")).Chain()
  .Flags("layer_apply")).BuildImageTag("flower.jpg")

iOS:

imageView.cldSetImage(cloudinary.createUrl().setTransformation(CLDTransformation()
  .setWidth(400).setCrop("scale").chain()
  .setBackground("#FEB61FC2").setColor("yellow").setOverlay("text:Arial_100:Flowers").chain()
  .setFlags("layer_apply")).generate("flower.jpg")!, cloudinary: cloudinary)

Android:

MediaManager.get().url().transformation(new Transformation()
  .width(400).crop("scale").chain()
  .background("#FEB61FC2").color("yellow").overlay(new TextLayer().fontFamily("Arial").fontSize(100).text("Flowers")).chain()
  .flags("layer_apply")).generate("flower.jpg");

Kotlin:

cloudinary.image {
publicId("flower.jpg")
resize(Resize.scale() {
width(400)
})
overlay(Overlay.source(Source.text("Flowers", TextStyle("Arial", 100)) {
textColor(Color.YELLOW)
backgroundColor(Color.rgb("#FEB61FC2"))
}))
}.generate()

Add a background color to a text overlay

b_auto[:<mode>][:<number>][:<direction>][:palette_<color 1>[_..._<color n>]]

A qualifier that automatically selects the background color based on one or more predominant colors in the image, for use with one of the padding crop mode transformations.

Learn more: Content-aware padding

Use with: c_pad | c_lpad | c_mpad | c_fill_pad

Value	Type	Description
mode	constant	The method to use for determining the solid or gradient color(s) to apply. Possible values: To automatically set the background to a single color: `border`: Selects the predominant color, taking only the image border pixels into account. `predominant`: Selects the predominant color while taking all pixels in the image into account. `border_contrast`: Selects the strongest contrasting color to the predominant color, taking only the image border pixels into account. `predominant_contrast`: Selects the strongest contrasting color to the predominant color while taking all pixels in the image into account. To automatically apply a gradient fade to the background with multiple colors: `predominant_gradient`: Bases the gradient fade effect on the predominant colors in the image. `predominant_gradient_contrast`: Bases the gradient fade effect on the colors that contrast the predominant colors in the image. `border_gradient`: Bases the gradient fade effect on the predominant colors in the border pixels of the image. `border_gradient_contrast`: Bases the gradient fade effect on the colors that contrast the predominant colors in the border pixels of the image. Default: `border`.
number	integer	Relevant only when setting `mode` to one of the 'gradient' options. The number of predominant colors to select. Possible values: `2`, `4`. Default: `2`.
direction	constant	Relevant only when setting `mode` to one of the 'gradient' options and when 2 colors are selected for the `number` option. Specifies the direction to blend the 2 colors together. (If 4 colors are selected, each gets interpolated between the four corners and this parameter is ignored.) Possible values: `horizontal`, `vertical`, `diagonal_desc`, `diagonal_asc`. Default: `horizontal`.
color 1 to color n	string	The palette of colors to use in the border. For each color, specify either: A 3- or 4-digit RGB/RGBA hex (e.g. f00) An RGB or RGBA hex triplet or quadruplet (6 or 8 digits) (e.g. f2086a) A named color (e.g. blue)

Examples

Pad an image to a width and height of 150 pixels, and with the background color set to the predominant color from that image (b_auto:predominant,c_pad,h_150,w_150):

URL Ruby PHP Python Node.js Java JS jQuery React Vue.js Angular .NET iOS Android Kotlin All

URL:

https://res.cloudinary.com/demo/image/upload/b_auto:predominant,c_pad,h_150,w_150/sheep.jpg

Ruby:

cl_image_tag("sheep.jpg", :background=>"auto:predominant", :height=>150, :width=>150, :crop=>"pad")

PHP (cloudinary_php v1.x (legacy)):

cl_image_tag("sheep.jpg", array("background"=>"auto:predominant", "height"=>150, "width"=>150, "crop"=>"pad"))

Library:

PHP (cloudinary_php v2.x):

(new ImageTag('sheep.jpg'))
  ->resize(Resize::pad()->width(150)->height(150)
    ->background(Background::predominant()));

Library:

Python:

CloudinaryImage("sheep.jpg").image(background="auto:predominant", height=150, width=150, crop="pad")

Node.js:

cloudinary.image("sheep.jpg", {background: "auto:predominant", height: 150, width: 150, crop: "pad"})

Java:

cloudinary.url().transformation(new Transformation().background("auto:predominant").height(150).width(150).crop("pad")).imageTag("sheep.jpg");

JS:

cloudinary.imageTag('sheep.jpg', {background: "auto:predominant", height: 150, width: 150, crop: "pad"}).toHtml();

jQuery:

$.cloudinary.image("sheep.jpg", {background: "auto:predominant", height: 150, width: 150, crop: "pad"})

React:

<Image publicId="sheep.jpg" >
  <Transformation background="auto:predominant" height="150" width="150" crop="pad" />
</Image>

Vue.js:

<cld-image public-id="sheep.jpg" >
  <cld-transformation background="auto:predominant" height="150" width="150" crop="pad" />
</cld-image>

Angular:

<cl-image public-id="sheep.jpg" >
  <cl-transformation background="auto:predominant" height="150" width="150" crop="pad">
  </cl-transformation>
</cl-image>

.NET:

cloudinary.Api.UrlImgUp.Transform(new Transformation().Background("auto:predominant").Height(150).Width(150).Crop("pad")).BuildImageTag("sheep.jpg")

iOS:

imageView.cldSetImage(cloudinary.createUrl().setTransformation(CLDTransformation().setBackground("auto:predominant").setHeight(150).setWidth(150).setCrop("pad")).generate("sheep.jpg")!, cloudinary: cloudinary)

Android:

MediaManager.get().url().transformation(new Transformation().background("auto:predominant").height(150).width(150).crop("pad")).generate("sheep.jpg");

Kotlin:

cloudinary.image {
publicId("sheep.jpg")
resize(Resize.pad() {
width(150)
height(150)
background(Background.predominant())
})
}.generate()

Pad an image to a width and height of 150 pixels, and with the background color set to the 2 most predominant colors from that image, blended in a diagonally descending direction (b_auto:predominant_gradient:2:diagonal_desc,c_pad,h_150,w_150):

URL Ruby PHP Python Node.js Java JS jQuery React Vue.js Angular .NET iOS Android Kotlin All

URL:

https://res.cloudinary.com/demo/image/upload/b_auto:predominant_gradient:2:diagonal_desc,c_pad,h_150,w_150/sheep.jpg

Ruby:

cl_image_tag("sheep.jpg", :background=>"auto:predominant_gradient:2:diagonal_desc", :height=>150, :width=>150, :crop=>"pad")

PHP (cloudinary_php v1.x (legacy)):

cl_image_tag("sheep.jpg", array("background"=>"auto:predominant_gradient:2:diagonal_desc", "height"=>150, "width"=>150, "crop"=>"pad"))

Library:

PHP (cloudinary_php v2.x):

(new ImageTag('sheep.jpg'))
  ->resize(Resize::pad()->width(150)->height(150)
    ->background(Background::predominantGradient()
      ->gradientDirection(GradientDirection::diagonalDesc())
      ->gradientColors(2)));

Library:

Python:

CloudinaryImage("sheep.jpg").image(background="auto:predominant_gradient:2:diagonal_desc", height=150, width=150, crop="pad")

Node.js:

cloudinary.image("sheep.jpg", {background: "auto:predominant_gradient:2:diagonal_desc", height: 150, width: 150, crop: "pad"})

Java:

cloudinary.url().transformation(new Transformation().background("auto:predominant_gradient:2:diagonal_desc").height(150).width(150).crop("pad")).imageTag("sheep.jpg");

JS:

cloudinary.imageTag('sheep.jpg', {background: "auto:predominant_gradient:2:diagonal_desc", height: 150, width: 150, crop: "pad"}).toHtml();

jQuery:

$.cloudinary.image("sheep.jpg", {background: "auto:predominant_gradient:2:diagonal_desc", height: 150, width: 150, crop: "pad"})

React:

<Image publicId="sheep.jpg" >
  <Transformation background="auto:predominant_gradient:2:diagonal_desc" height="150" width="150" crop="pad" />
</Image>

Vue.js:

<cld-image public-id="sheep.jpg" >
  <cld-transformation background="auto:predominant_gradient:2:diagonal_desc" height="150" width="150" crop="pad" />
</cld-image>

Angular:

<cl-image public-id="sheep.jpg" >
  <cl-transformation background="auto:predominant_gradient:2:diagonal_desc" height="150" width="150" crop="pad">
  </cl-transformation>
</cl-image>

.NET:

cloudinary.Api.UrlImgUp.Transform(new Transformation().Background("auto:predominant_gradient:2:diagonal_desc").Height(150).Width(150).Crop("pad")).BuildImageTag("sheep.jpg")

iOS:

imageView.cldSetImage(cloudinary.createUrl().setTransformation(CLDTransformation().setBackground("auto:predominant_gradient:2:diagonal_desc").setHeight(150).setWidth(150).setCrop("pad")).generate("sheep.jpg")!, cloudinary: cloudinary)

Android:

MediaManager.get().url().transformation(new Transformation().background("auto:predominant_gradient:2:diagonal_desc").height(150).width(150).crop("pad")).generate("sheep.jpg");

Kotlin:

cloudinary.image {
publicId("sheep.jpg")
resize(Resize.pad() {
width(150)
height(150)
background(Background.predominantGradient() {
gradientDirection(GradientDirection.diagonalDesc())
gradientColors(2)
})
})
}.generate()

Pad an image to a width and height of 150 pixels, with a 4 color gradient fade in the auto colored padding, and limiting the possible colors to red, green, blue, and orange (b_auto:predominant_gradient:4:palette_red_green_blue_orange,c_pad,h_150,w_150):

URL Ruby PHP Python Node.js Java JS jQuery React Vue.js Angular .NET iOS Android Kotlin All

URL:

https://res.cloudinary.com/demo/image/upload/b_auto:predominant_gradient:4:palette_red_green_blue_orange,c_pad,h_150,w_150/horse.jpg

Ruby:

cl_image_tag("horse.jpg", :background=>"auto:predominant_gradient:4:palette_red_green_blue_orange", :height=>150, :width=>150, :crop=>"pad")

PHP (cloudinary_php v1.x (legacy)):

cl_image_tag("horse.jpg", array("background"=>"auto:predominant_gradient:4:palette_red_green_blue_orange", "height"=>150, "width"=>150, "crop"=>"pad"))

Library:

PHP (cloudinary_php v2.x):

(new ImageTag('horse.jpg'))
  ->resize(Resize::pad()->width(150)->height(150)
    ->background(Background::predominantGradient()
      ->gradientColors(4)
      ->palette(Color::RED, Color::GREEN, Color::BLUE, Color::ORANGE)));

Library:

Python:

CloudinaryImage("horse.jpg").image(background="auto:predominant_gradient:4:palette_red_green_blue_orange", height=150, width=150, crop="pad")

Node.js:

cloudinary.image("horse.jpg", {background: "auto:predominant_gradient:4:palette_red_green_blue_orange", height: 150, width: 150, crop: "pad"})

Java:

cloudinary.url().transformation(new Transformation().background("auto:predominant_gradient:4:palette_red_green_blue_orange").height(150).width(150).crop("pad")).imageTag("horse.jpg");

JS:

cloudinary.imageTag('horse.jpg', {background: "auto:predominant_gradient:4:palette_red_green_blue_orange", height: 150, width: 150, crop: "pad"}).toHtml();

jQuery:

$.cloudinary.image("horse.jpg", {background: "auto:predominant_gradient:4:palette_red_green_blue_orange", height: 150, width: 150, crop: "pad"})

React:

<Image publicId="horse.jpg" >
  <Transformation background="auto:predominant_gradient:4:palette_red_green_blue_orange" height="150" width="150" crop="pad" />
</Image>

Vue.js:

<cld-image public-id="horse.jpg" >
  <cld-transformation background="auto:predominant_gradient:4:palette_red_green_blue_orange" height="150" width="150" crop="pad" />
</cld-image>

Angular:

<cl-image public-id="horse.jpg" >
  <cl-transformation background="auto:predominant_gradient:4:palette_red_green_blue_orange" height="150" width="150" crop="pad">
  </cl-transformation>
</cl-image>

.NET:

cloudinary.Api.UrlImgUp.Transform(new Transformation().Background("auto:predominant_gradient:4:palette_red_green_blue_orange").Height(150).Width(150).Crop("pad")).BuildImageTag("horse.jpg")

iOS:

imageView.cldSetImage(cloudinary.createUrl().setTransformation(CLDTransformation().setBackground("auto:predominant_gradient:4:palette_red_green_blue_orange").setHeight(150).setWidth(150).setCrop("pad")).generate("horse.jpg")!, cloudinary: cloudinary)

Android:

MediaManager.get().url().transformation(new Transformation().background("auto:predominant_gradient:4:palette_red_green_blue_orange").height(150).width(150).crop("pad")).generate("horse.jpg");

Kotlin:

cloudinary.image {
publicId("horse.jpg")
resize(Resize.pad() {
width(150)
height(150)
background(Background.predominantGradient() {
gradientColors(4)
palette(Color.RED, Color.GREEN, Color.BLUE, Color.ORANGE)
})
})
}.generate()

predominant gradient background with color palette

b_blurred[:<intensity>][:<brightness>]

A qualifier that generates a blurred version of the same video to use as the background with the corresponding padded cropping transformation.

Use with: c_pad | c_fill_pad

Learn more: Pad with blurred video background

Value	Type	Description
intensity	integer	The amount of blurring. Range: `1 to 2000`. Default: `100`.
brightness	integer	The brightness of the blurred background video. Range: `-300 to 100`. Default: `0`.

Example

Pad a portrait video with a blurred background of that same video at an intensity of 400 and a brightness of 15 (b_blurred:400:15):

URL Ruby PHP Python Node.js Java JS jQuery React Vue.js Angular .NET iOS Android Kotlin All

URL:

https://res.cloudinary.com/demo/video/upload/c_scale,h_320/b_blurred:400:15,c_pad,h_320,w_480/e_volume:mute/e_accelerate:100/cld_rubiks_guy.mp4

Ruby:

cl_video_tag("cld_rubiks_guy", :transformation=>[
  {:height=>320, :crop=>"scale"},
  {:background=>"blurred:400:15", :height=>320, :width=>480, :crop=>"pad"},
  {:effect=>"volume:mute"},
  {:effect=>"accelerate:100"}
  ])

PHP (cloudinary_php v1.x (legacy)):

cl_video_tag("cld_rubiks_guy", array("transformation"=>array(
  array("height"=>320, "crop"=>"scale"),
  array("background"=>"blurred:400:15", "height"=>320, "width"=>480, "crop"=>"pad"),
  array("effect"=>"volume:mute"),
  array("effect"=>"accelerate:100")
  )))

Library:

PHP (cloudinary_php v2.x):

(new VideoTag('cld_rubiks_guy.mp4'))
  ->resize(Resize::scale()->height(320))
  ->resize(Resize::pad()->width(480)->height(320)
    ->background(Background::blurred()->intensity(400)->brightness(15)))
  ->videoEdit(VideoEdit::volume(Volume::mute()))
  ->effect(Effect::accelerate()->rate(100));

Library:

Python:

CloudinaryVideo("cld_rubiks_guy").video(transformation=[
  {'height': 320, 'crop': "scale"},
  {'background': "blurred:400:15", 'height': 320, 'width': 480, 'crop': "pad"},
  {'effect': "volume:mute"},
  {'effect': "accelerate:100"}
  ])

Node.js:

cloudinary.video("cld_rubiks_guy", {transformation: [
  {height: 320, crop: "scale"},
  {background: "blurred:400:15", height: 320, width: 480, crop: "pad"},
  {effect: "volume:mute"},
  {effect: "accelerate:100"}
  ]})

Java:

cloudinary.url().transformation(new Transformation()
  .height(320).crop("scale").chain()
  .background("blurred:400:15").height(320).width(480).crop("pad").chain()
  .effect("volume:mute").chain()
  .effect("accelerate:100")).videoTag("cld_rubiks_guy");

JS:

cloudinary.videoTag('cld_rubiks_guy', {transformation: [
  {height: 320, crop: "scale"},
  {background: "blurred:400:15", height: 320, width: 480, crop: "pad"},
  {effect: "volume:mute"},
  {effect: "accelerate:100"}
  ]}).toHtml();

jQuery:

$.cloudinary.video("cld_rubiks_guy", {transformation: [
  {height: 320, crop: "scale"},
  {background: "blurred:400:15", height: 320, width: 480, crop: "pad"},
  {effect: "volume:mute"},
  {effect: "accelerate:100"}
  ]})

React:

<Video publicId="cld_rubiks_guy" >
  <Transformation height="320" crop="scale" />
  <Transformation background="blurred:400:15" height="320" width="480" crop="pad" />
  <Transformation effect="volume:mute" />
  <Transformation effect="accelerate:100" />
</Video>

Vue.js:

<cld-video public-id="cld_rubiks_guy" >
  <cld-transformation height="320" crop="scale" />
  <cld-transformation background="blurred:400:15" height="320" width="480" crop="pad" />
  <cld-transformation effect="volume:mute" />
  <cld-transformation effect="accelerate:100" />
</cld-video>

Angular:

<cl-video public-id="cld_rubiks_guy" >
  <cl-transformation height="320" crop="scale">
  </cl-transformation>
  <cl-transformation background="blurred:400:15" height="320" width="480" crop="pad">
  </cl-transformation>
  <cl-transformation effect="volume:mute">
  </cl-transformation>
  <cl-transformation effect="accelerate:100">
  </cl-transformation>
</cl-video>

.NET:

cloudinary.Api.UrlVideoUp.Transform(new Transformation()
  .Height(320).Crop("scale").Chain()
  .Background("blurred:400:15").Height(320).Width(480).Crop("pad").Chain()
  .Effect("volume:mute").Chain()
  .Effect("accelerate:100")).BuildVideoTag("cld_rubiks_guy")

iOS:

cloudinary.createUrl().setResourceType("video").setTransformation(CLDTransformation()
  .setHeight(320).setCrop("scale").chain()
  .setBackground("blurred:400:15").setHeight(320).setWidth(480).setCrop("pad").chain()
  .setEffect("volume:mute").chain()
  .setEffect("accelerate:100")).generate("cld_rubiks_guy.mp4")

Android:

MediaManager.get().url().transformation(new Transformation()
  .height(320).crop("scale").chain()
  .background("blurred:400:15").height(320).width(480).crop("pad").chain()
  .effect("volume:mute").chain()
  .effect("accelerate:100")).resourceType("video").generate("cld_rubiks_guy.mp4");

Kotlin:

cloudinary.video {
publicId("cld_rubiks_guy.mp4")
resize(Resize.scale() {
height(320)
})
resize(Resize.pad() {
width(480)
height(320)
background(Background.blurred() {
intensity(400)
brightness(15)
})
})
videoEdit(VideoEdit.volume(Volume.mute()))
effect(Effect.accelerate() {
rate(100)
})
}.generate()

bo_<width>_<style>_<color>

Adds a solid border around an image or video.

As a qualifier, adds a border to an overlay.

Use with: l_<image id> | l_fetch | l_subtitles | l_text | l_video

Learn more: Adding borders

Value Type Description

width string Required. The width of the border in pixels (e.g., 40px).

style string Required. Currently, only solid is supported for style.

color

string

Value	Type	Description
width	string	Required. The width of the border in pixels (e.g., `40px`).
style	string	Required. Currently, only `solid` is supported for style.
color	string	Required. The color can be set as: A 3- or 4-digit RGB/RGBA hex An RGB or RGBA hex triplet or quadruplet (6 or 8 digits). A named color When specifying any RGB or RGBA value, always prefix the color value in the URL with `rgb:` (without `#`). For example, `bo_5px_solid_rgb:999` or `bo_5px_solid_rgb:FEB61FC2`. When using a named color, specify only the color name. For example `bo_5px_solid_blue`.

Required. The color can be set as:

A 3- or 4-digit RGB/RGBA hex
An RGB or RGBA hex triplet or quadruplet (6 or 8 digits).
A named color

When specifying any RGB or RGBA value, always prefix the color value in the URL with rgb: (without #). For example, bo_5px_solid_rgb:999 or bo_5px_solid_rgb:FEB61FC2.

When using a named color, specify only the color name. For example bo_5px_solid_blue.

Examples

Add a 40-pixel wide brown border to the image (bo_40px_solid_brown):

URL Ruby PHP Python Node.js Java JS jQuery React Vue.js Angular .NET iOS Android Kotlin All

URL:

https://res.cloudinary.com/demo/image/upload/bo_40px_solid_brown/autumn_leaves.jpg

Ruby:

cl_image_tag("autumn_leaves.jpg", :border=>"40px_solid_brown")

PHP (cloudinary_php v1.x (legacy)):

cl_image_tag("autumn_leaves.jpg", array("border"=>"40px_solid_brown"))

Library:

PHP (cloudinary_php v2.x):

(new ImageTag('autumn_leaves.jpg'))
  ->border(Border::solid(40, Color::BROWN));

Library:

Python:

CloudinaryImage("autumn_leaves.jpg").image(border="40px_solid_brown")

Node.js:

cloudinary.image("autumn_leaves.jpg", {border: "40px_solid_brown"})

Java:

cloudinary.url().transformation(new Transformation().border("40px_solid_brown")).imageTag("autumn_leaves.jpg");

JS:

cloudinary.imageTag('autumn_leaves.jpg', {border: "40px_solid_brown"}).toHtml();

jQuery:

$.cloudinary.image("autumn_leaves.jpg", {border: "40px_solid_brown"})

React:

<Image publicId="autumn_leaves.jpg" >
  <Transformation border="40px_solid_brown" />
</Image>

Vue.js:

<cld-image public-id="autumn_leaves.jpg" >
  <cld-transformation border="40px_solid_brown" />
</cld-image>

Angular:

<cl-image public-id="autumn_leaves.jpg" >
  <cl-transformation border="40px_solid_brown">
  </cl-transformation>
</cl-image>

.NET:

cloudinary.Api.UrlImgUp.Transform(new Transformation().Border("40px_solid_brown")).BuildImageTag("autumn_leaves.jpg")

iOS:

imageView.cldSetImage(cloudinary.createUrl().setTransformation(CLDTransformation().setBorder("40px_solid_brown")).generate("autumn_leaves.jpg")!, cloudinary: cloudinary)

Android:

MediaManager.get().url().transformation(new Transformation().border("40px_solid_brown")).generate("autumn_leaves.jpg");

Kotlin:

cloudinary.image {
publicId("autumn_leaves.jpg")
border(Border.solid(40, Color.BROWN))
}.generate()

Add a 60-pixel wide border of a semi transparent (RGBA hex quadruplet) color - the last 2 digits are the hex value of the alpha channel (bo_60px_solid_rgb:00390b60):

URL Ruby PHP Python Node.js Java JS jQuery React Vue.js Angular .NET iOS Android Kotlin All

URL:

https://res.cloudinary.com/demo/image/upload/bo_60px_solid_rgb:00390b60/autumn_leaves.jpg

Ruby:

cl_image_tag("autumn_leaves.jpg", :border=>"60px_solid_rgb:00390b60")

PHP (cloudinary_php v1.x (legacy)):

cl_image_tag("autumn_leaves.jpg", array("border"=>"60px_solid_rgb:00390b60"))

Library:

PHP (cloudinary_php v2.x):

(new ImageTag('autumn_leaves.jpg'))
  ->border(Border::solid(60, Color::rgb('00390b60')));

Library:

Python:

CloudinaryImage("autumn_leaves.jpg").image(border="60px_solid_rgb:00390b60")

Node.js:

cloudinary.image("autumn_leaves.jpg", {border: "60px_solid_rgb:00390b60"})

Java:

cloudinary.url().transformation(new Transformation().border("60px_solid_rgb:00390b60")).imageTag("autumn_leaves.jpg");

JS:

cloudinary.imageTag('autumn_leaves.jpg', {border: "60px_solid_rgb:00390b60"}).toHtml();

jQuery:

$.cloudinary.image("autumn_leaves.jpg", {border: "60px_solid_rgb:00390b60"})

React:

<Image publicId="autumn_leaves.jpg" >
  <Transformation border="60px_solid_rgb:00390b60" />
</Image>

Vue.js:

<cld-image public-id="autumn_leaves.jpg" >
  <cld-transformation border="60px_solid_rgb:00390b60" />
</cld-image>

Angular:

<cl-image public-id="autumn_leaves.jpg" >
  <cl-transformation border="60px_solid_rgb:00390b60">
  </cl-transformation>
</cl-image>

.NET:

cloudinary.Api.UrlImgUp.Transform(new Transformation().Border("60px_solid_rgb:00390b60")).BuildImageTag("autumn_leaves.jpg")

iOS:

imageView.cldSetImage(cloudinary.createUrl().setTransformation(CLDTransformation().setBorder("60px_solid_rgb:00390b60")).generate("autumn_leaves.jpg")!, cloudinary: cloudinary)

Android:

MediaManager.get().url().transformation(new Transformation().border("60px_solid_rgb:00390b60")).generate("autumn_leaves.jpg");

Kotlin:

cloudinary.image {
publicId("autumn_leaves.jpg")
border(Border.solid(60, Color.rgb("#00390b60")))
}.generate()

A 60 pixels wide border of a semi transparent RGB color

Add multiple 200-pixel wide borders (blue, red and green) to an image, (bo_200px_solid_blue/bo_200px_solid_red/bo_200px_solid_green):

URL Ruby PHP Python Node.js Java JS jQuery React Vue.js Angular .NET iOS Android Kotlin All

URL:

https://res.cloudinary.com/demo/image/upload/bo_200px_solid_blue/bo_200px_solid_red/bo_200px_solid_green/autumn_leaves.jpg

Ruby:

cl_image_tag("autumn_leaves.jpg", :transformation=>[
  {:border=>"200px_solid_blue"},
  {:border=>"200px_solid_red"},
  {:border=>"200px_solid_green"}
  ])

PHP (cloudinary_php v1.x (legacy)):

cl_image_tag("autumn_leaves.jpg", array("transformation"=>array(
  array("border"=>"200px_solid_blue"),
  array("border"=>"200px_solid_red"),
  array("border"=>"200px_solid_green")
  )))

Library:

PHP (cloudinary_php v2.x):

(new ImageTag('autumn_leaves.jpg'))
  ->border(Border::solid(200, Color::BLUE))
  ->border(Border::solid(200, Color::RED))
  ->border(Border::solid(200, Color::GREEN));

Library:

Python:

CloudinaryImage("autumn_leaves.jpg").image(transformation=[
  {'border': "200px_solid_blue"},
  {'border': "200px_solid_red"},
  {'border': "200px_solid_green"}
  ])

Node.js:

cloudinary.image("autumn_leaves.jpg", {transformation: [
  {border: "200px_solid_blue"},
  {border: "200px_solid_red"},
  {border: "200px_solid_green"}
  ]})

Java:

cloudinary.url().transformation(new Transformation()
  .border("200px_solid_blue").chain()
  .border("200px_solid_red").chain()
  .border("200px_solid_green")).imageTag("autumn_leaves.jpg");

JS:

cloudinary.imageTag('autumn_leaves.jpg', {transformation: [
  {border: "200px_solid_blue"},
  {border: "200px_solid_red"},
  {border: "200px_solid_green"}
  ]}).toHtml();

jQuery:

$.cloudinary.image("autumn_leaves.jpg", {transformation: [
  {border: "200px_solid_blue"},
  {border: "200px_solid_red"},
  {border: "200px_solid_green"}
  ]})

React:

<Image publicId="autumn_leaves.jpg" >
  <Transformation border="200px_solid_blue" />
  <Transformation border="200px_solid_red" />
  <Transformation border="200px_solid_green" />
</Image>

Vue.js:

<cld-image public-id="autumn_leaves.jpg" >
  <cld-transformation border="200px_solid_blue" />
  <cld-transformation border="200px_solid_red" />
  <cld-transformation border="200px_solid_green" />
</cld-image>

Angular:

<cl-image public-id="autumn_leaves.jpg" >
  <cl-transformation border="200px_solid_blue">
  </cl-transformation>
  <cl-transformation border="200px_solid_red">
  </cl-transformation>
  <cl-transformation border="200px_solid_green">
  </cl-transformation>
</cl-image>

.NET:

cloudinary.Api.UrlImgUp.Transform(new Transformation()
  .Border("200px_solid_blue").Chain()
  .Border("200px_solid_red").Chain()
  .Border("200px_solid_green")).BuildImageTag("autumn_leaves.jpg")

iOS:

imageView.cldSetImage(cloudinary.createUrl().setTransformation(CLDTransformation()
  .setBorder("200px_solid_blue").chain()
  .setBorder("200px_solid_red").chain()
  .setBorder("200px_solid_green")).generate("autumn_leaves.jpg")!, cloudinary: cloudinary)

Android:

MediaManager.get().url().transformation(new Transformation()
  .border("200px_solid_blue").chain()
  .border("200px_solid_red").chain()
  .border("200px_solid_green")).generate("autumn_leaves.jpg");

Kotlin:

cloudinary.image {
publicId("autumn_leaves.jpg")
border(Border.solid(200, Color.BLUE))
border(Border.solid(200, Color.RED))
border(Border.solid(200, Color.GREEN))
}.generate()

br_<bitrate value>[:constant]

Controls the video bitrate in bits per second. By default, the video uses a variable bitrate (VBR), with this value indicating the maximum bitrate. Supported for codecs: h264, h265 (MPEG-4); vp8, vp9 (WebM)

Learn more: Video settings

Value	Type	Description
bitrate value	integer \| string	Required. The maximum number of bits per second (e.g., `500000`). Can also be specified as a string, supporting `k` and `m` for kilobits and megabits respectively (e.g., `500k` or `1m`).
constant	keyword	If `constant` is specified, the video plays with a constant bitrate (CBR) and the default `quality` setting (or any q (quality) setting explicitly specified) is ignored.

Examples

Set a maximum bitrate of 500000 (br_500000):

URL Ruby PHP Python Node.js Java JS jQuery React Vue.js Angular .NET iOS Android Kotlin All

URL:

https://res.cloudinary.com/demo/video/upload/br_500000/dog.mp4

Ruby:

cl_video_tag("dog", :bit_rate=>"500000")

PHP (cloudinary_php v1.x (legacy)):

cl_video_tag("dog", array("bit_rate"=>"500000"))

Library:

PHP (cloudinary_php v2.x):

(new VideoTag('dog.mp4'))
  ->transcode(Transcode::bitRate(500000));

Library:

Python:

CloudinaryVideo("dog").video(bit_rate="500000")

Node.js:

cloudinary.video("dog", {bit_rate: "500000"})

Java:

cloudinary.url().transformation(new Transformation().bitRate("500000")).videoTag("dog");

JS:

cloudinary.videoTag('dog', {bitRate: "500000"}).toHtml();

jQuery:

$.cloudinary.video("dog", {bit_rate: "500000"})

React:

<Video publicId="dog" >
  <Transformation bitRate="500000" />
</Video>

Vue.js:

<cld-video public-id="dog" >
  <cld-transformation bit-rate="500000" />
</cld-video>

Angular:

<cl-video public-id="dog" >
  <cl-transformation bit-rate="500000">
  </cl-transformation>
</cl-video>

.NET:

cloudinary.Api.UrlVideoUp.Transform(new Transformation().BitRate("500000")).BuildVideoTag("dog")

iOS:

cloudinary.createUrl().setResourceType("video").setTransformation(CLDTransformation().setBitRate("500000")).generate("dog.mp4")

Android:

MediaManager.get().url().transformation(new Transformation().bitRate("500000")).resourceType("video").generate("dog.mp4");

Kotlin:

cloudinary.video {
publicId("dog.mp4")
transcode(Transcode.bitRate(500000))
}.generate()

Set a constant bitrate of 500k (br_500k:constant):

URL Ruby PHP Python Node.js Java JS jQuery React Vue.js Angular .NET iOS Android Kotlin All

URL:

https://res.cloudinary.com/demo/video/upload/br_500k:constant/dog.mp4

Ruby:

cl_video_tag("dog", :bit_rate=>"500k:constant")

PHP (cloudinary_php v1.x (legacy)):

cl_video_tag("dog", array("bit_rate"=>"500k:constant"))

Library:

PHP (cloudinary_php v2.x):

(new VideoTag('dog.mp4'))
  ->transcode(Transcode::bitRate('500k')->constant());

Library:

Python:

CloudinaryVideo("dog").video(bit_rate="500k:constant")

Node.js:

cloudinary.video("dog", {bit_rate: "500k:constant"})

Java:

cloudinary.url().transformation(new Transformation().bitRate("500k:constant")).videoTag("dog");

JS:

cloudinary.videoTag('dog', {bitRate: "500k:constant"}).toHtml();

jQuery:

$.cloudinary.video("dog", {bit_rate: "500k:constant"})

React:

<Video publicId="dog" >
  <Transformation bitRate="500k:constant" />
</Video>

Vue.js:

<cld-video public-id="dog" >
  <cld-transformation bit-rate="500k:constant" />
</cld-video>

Angular:

<cl-video public-id="dog" >
  <cl-transformation bit-rate="500k:constant">
  </cl-transformation>
</cl-video>

.NET:

cloudinary.Api.UrlVideoUp.Transform(new Transformation().BitRate("500k:constant")).BuildVideoTag("dog")

iOS:

cloudinary.createUrl().setResourceType("video").setTransformation(CLDTransformation().setBitRate("500k:constant")).generate("dog.mp4")

Android:

MediaManager.get().url().transformation(new Transformation().bitRate("500k:constant")).resourceType("video").generate("dog.mp4");

Kotlin:

cloudinary.video {
publicId("dog.mp4")
transcode(Transcode.bitRate("500k") {
constant()
})
}.generate()

Changes the size of the delivered asset according to the requested width & height dimensions.

Depending on the selected <crop mode>, parts of the original asset may be cropped out and/or the asset may be resized (scaled up or down).

When using any of the modes that can potentially crop parts of the asset, the selected gravity parameter controls which part of the original asset is kept in the resulting delivered file.

Learn more: Resizing and cropping images | Resizing and cropping videos

c_crop

Extracts the specified size from the original image without distorting or scaling the delivered asset.

By default, the center of the image is kept (extracted) and the top/bottom and/or side edges are evenly cropped to achieve the requested dimensions. You can specify the gravity qualifier to control which part of the image to keep, either as a compass direction (such as south or north_east), one of the special gravity positions (such as faces or ocr_text), AI-based automatic region detection or AI-based object detection.

You can also specify a specific region of the original image to keep by specifying x and y qualifiers together with w (width) and h (height) qualifiers to define an exact bounding box. When using this method, and no gravity is specified, the x and y coordinates are relative to the top-left (north-west) corner of the original asset. You can also use percentage based numbers instead of the exact coordinates for x, y, w and h (e.g., 0.5 for 50%). Use this method only when you already have the required absolute cropping coordinates. For example, you might use this if your application allows a user to upload user-generated content, and your application allows the user to manually select a region to crop from the original image, and you pass those coordinates to build the crop URL.

Required qualifiers

Two of the following: w (width) | h (height) | ar (aspect ratio)

(In rare cases, you may choose to provide only one sizing qualifier)

Optional qualifiers

g (gravity)> | x (x-coordinate) | y (y-coordinate)

Example

Crop an image to a width of 200 pixels, a height of 150 pixels, with northwest gravity (c_crop,g_north_west,h_150,w_200):

URL Ruby PHP Python Node.js Java JS jQuery React Vue.js Angular .NET iOS Android Kotlin All

URL:

https://res.cloudinary.com/demo/image/upload/c_crop,g_north_west,h_150,w_200/sample.jpg

Ruby:

cl_image_tag("sample.jpg", :gravity=>"north_west", :height=>150, :width=>200, :crop=>"crop")

PHP (cloudinary_php v1.x (legacy)):

cl_image_tag("sample.jpg", array("gravity"=>"north_west", "height"=>150, "width"=>200, "crop"=>"crop"))

Library:

PHP (cloudinary_php v2.x):

(new ImageTag('sample.jpg'))
  ->resize(Resize::crop()->width(200)->height(150)
    ->gravity(Gravity::compass(Compass::northWest())));

Library:

Python:

CloudinaryImage("sample.jpg").image(gravity="north_west", height=150, width=200, crop="crop")

Node.js:

cloudinary.image("sample.jpg", {gravity: "north_west", height: 150, width: 200, crop: "crop"})

Java:

cloudinary.url().transformation(new Transformation().gravity("north_west").height(150).width(200).crop("crop")).imageTag("sample.jpg");

JS:

cloudinary.imageTag('sample.jpg', {gravity: "north_west", height: 150, width: 200, crop: "crop"}).toHtml();

jQuery:

$.cloudinary.image("sample.jpg", {gravity: "north_west", height: 150, width: 200, crop: "crop"})

React:

<Image publicId="sample.jpg" >
  <Transformation gravity="north_west" height="150" width="200" crop="crop" />
</Image>

Vue.js:

<cld-image public-id="sample.jpg" >
  <cld-transformation gravity="north_west" height="150" width="200" crop="crop" />
</cld-image>

Angular:

<cl-image public-id="sample.jpg" >
  <cl-transformation gravity="north_west" height="150" width="200" crop="crop">
  </cl-transformation>
</cl-image>

.NET:

cloudinary.Api.UrlImgUp.Transform(new Transformation().Gravity("north_west").Height(150).Width(200).Crop("crop")).BuildImageTag("sample.jpg")

iOS:

imageView.cldSetImage(cloudinary.createUrl().setTransformation(CLDTransformation().setGravity("north_west").setHeight(150).setWidth(200).setCrop("crop")).generate("sample.jpg")!, cloudinary: cloudinary)

Android:

MediaManager.get().url().transformation(new Transformation().gravity("north_west").height(150).width(200).crop("crop")).generate("sample.jpg");

Kotlin:

cloudinary.image {
publicId("sample.jpg")
resize(Resize.crop() {
width(200)
height(150)
gravity(Gravity.compass(Compass.northWest()))
})
}.generate()

Image cropped to 100x150 with west gravity

c_fill

Creates an asset with the exact specified width and height without distorting the asset. This option first scales as much as needed to at least fill both of the specified dimensions. If the requested aspect ratio is different than the original, cropping will occur on the dimension that exceeds the requested size after scaling. You can specify which part of the original asset you want to keep if cropping occurs using the gravity (set to 'center' by default).

Required qualifiers

At least one of the following: w (width) | h (height) | ar (aspect ratio)

(In rare cases, you may choose to provide only one sizing qualifier)

Optional qualifiers

g (gravity)

Examples

Fill to a width and height of 150 pixels (w_150,h_150,c_fill):

URL Ruby PHP Python Node.js Java JS jQuery React Vue.js Angular .NET iOS Android Kotlin All

URL:

https://res.cloudinary.com/demo/image/upload/w_150,h_150,c_fill/sample.jpg

Ruby:

cl_image_tag("sample.jpg", :width=>150, :height=>150, :crop=>"fill")

PHP (cloudinary_php v1.x (legacy)):

cl_image_tag("sample.jpg", array("width"=>150, "height"=>150, "crop"=>"fill"))

Library:

PHP (cloudinary_php v2.x):

(new ImageTag('sample.jpg'))
  ->resize(Resize::fill()->width(150)->height(150));

Library:

Python:

CloudinaryImage("sample.jpg").image(width=150, height=150, crop="fill")

Node.js:

cloudinary.image("sample.jpg", {width: 150, height: 150, crop: "fill"})

Java:

cloudinary.url().transformation(new Transformation().width(150).height(150).crop("fill")).imageTag("sample.jpg");

JS:

cloudinary.imageTag('sample.jpg', {width: 150, height: 150, crop: "fill"}).toHtml();

jQuery:

$.cloudinary.image("sample.jpg", {width: 150, height: 150, crop: "fill"})

React:

<Image publicId="sample.jpg" >
  <Transformation width="150" height="150" crop="fill" />
</Image>

Vue.js:

<cld-image public-id="sample.jpg" >
  <cld-transformation width="150" height="150" crop="fill" />
</cld-image>

Angular:

<cl-image public-id="sample.jpg" >
  <cl-transformation width="150" height="150" crop="fill">
  </cl-transformation>
</cl-image>

.NET:

cloudinary.Api.UrlImgUp.Transform(new Transformation().Width(150).Height(150).Crop("fill")).BuildImageTag("sample.jpg")

iOS:

imageView.cldSetImage(cloudinary.createUrl().setTransformation(CLDTransformation().setWidth(150).setHeight(150).setCrop("fill")).generate("sample.jpg")!, cloudinary: cloudinary)

Android:

MediaManager.get().url().transformation(new Transformation().width(150).height(150).crop("fill")).generate("sample.jpg");

Kotlin:

cloudinary.image {
publicId("sample.jpg")
resize(Resize.fill() {
width(150)
height(150)
})
}.generate()

Image filled to a width and height of 150 pixels

Fill to a width and height of 150 pixels with east gravity (c_fill,g_east,h_150,w_150):

URL Ruby PHP Python Node.js Java JS jQuery React Vue.js Angular .NET iOS Android Kotlin All

URL:

https://res.cloudinary.com/demo/image/upload/c_fill,g_east,h_150,w_150/sample.jpg

Ruby:

cl_image_tag("sample.jpg", :gravity=>"east", :height=>150, :width=>150, :crop=>"fill")

PHP (cloudinary_php v1.x (legacy)):

cl_image_tag("sample.jpg", array("gravity"=>"east", "height"=>150, "width"=>150, "crop"=>"fill"))

Library:

PHP (cloudinary_php v2.x):

(new ImageTag('sample.jpg'))
  ->resize(Resize::fill()->width(150)->height(150)
    ->gravity(Gravity::compass(Compass::east())));

Library:

Python:

CloudinaryImage("sample.jpg").image(gravity="east", height=150, width=150, crop="fill")

Node.js:

cloudinary.image("sample.jpg", {gravity: "east", height: 150, width: 150, crop: "fill"})

Java:

cloudinary.url().transformation(new Transformation().gravity("east").height(150).width(150).crop("fill")).imageTag("sample.jpg");

JS:

cloudinary.imageTag('sample.jpg', {gravity: "east", height: 150, width: 150, crop: "fill"}).toHtml();

jQuery:

$.cloudinary.image("sample.jpg", {gravity: "east", height: 150, width: 150, crop: "fill"})

React:

<Image publicId="sample.jpg" >
  <Transformation gravity="east" height="150" width="150" crop="fill" />
</Image>

Vue.js:

<cld-image public-id="sample.jpg" >
  <cld-transformation gravity="east" height="150" width="150" crop="fill" />
</cld-image>

Angular:

<cl-image public-id="sample.jpg" >
  <cl-transformation gravity="east" height="150" width="150" crop="fill">
  </cl-transformation>
</cl-image>

.NET:

cloudinary.Api.UrlImgUp.Transform(new Transformation().Gravity("east").Height(150).Width(150).Crop("fill")).BuildImageTag("sample.jpg")

iOS:

imageView.cldSetImage(cloudinary.createUrl().setTransformation(CLDTransformation().setGravity("east").setHeight(150).setWidth(150).setCrop("fill")).generate("sample.jpg")!, cloudinary: cloudinary)

Android:

MediaManager.get().url().transformation(new Transformation().gravity("east").height(150).width(150).crop("fill")).generate("sample.jpg");

Kotlin:

cloudinary.image {
publicId("sample.jpg")
resize(Resize.fill() {
width(150)
height(150)
gravity(Gravity.compass(Compass.east()))
})
}.generate()

Image filled to a width and height of 150 pixels with east gravity

c_fill_pad

Tries to prevent a "bad crop" by first attempting to use the fill mode, but adding some padding if the algorithm determines that more of the original image needs to be included in the final image, or if more content in specific frames in a video should be shown. Especially useful if the aspect ratio of the delivered asset is considerably different from the original's aspect ratio. Supported only in conjunction with g_auto.

Note

Not supported for animated images.

Required qualifiers

g_auto

And

Two of the following: w (width) | h (height) | ar (aspect ratio)

(In rare cases, you may choose to provide only one sizing qualifier)

Optional qualifiers

b (background)

Example

Deliver an image as a 25x150 image using the fill_pad mode. (b_auto,c_fill_pad,g_auto,h_150,w_25).
Compare this to the same image delivered using the regular fill mode (shown below on the right).

fill_pad

fill

URL Ruby PHP Python Node.js Java JS jQuery React Vue.js Angular .NET iOS Android Kotlin All

URL:

https://res.cloudinary.com/demo/image/upload/b_auto,c_fill_pad,g_auto,h_400,w_80/lady.jpg

Ruby:

cl_image_tag("lady.jpg", :background=>"auto", :gravity=>"auto", :height=>400, :width=>80, :crop=>"fill_pad")

PHP (cloudinary_php v1.x (legacy)):

cl_image_tag("lady.jpg", array("background"=>"auto", "gravity"=>"auto", "height"=>400, "width"=>80, "crop"=>"fill_pad"))

Library:

PHP (cloudinary_php v2.x):

(new ImageTag('lady.jpg'))
  ->resize(Resize::fillPad()->width(80)->height(400)
    ->gravity(Gravity::autoGravity())
    ->background(Background::auto()));

Library:

Python:

CloudinaryImage("lady.jpg").image(background="auto", gravity="auto", height=400, width=80, crop="fill_pad")

Node.js:

cloudinary.image("lady.jpg", {background: "auto", gravity: "auto", height: 400, width: 80, crop: "fill_pad"})

Java:

cloudinary.url().transformation(new Transformation().background("auto").gravity("auto").height(400).width(80).crop("fill_pad")).imageTag("lady.jpg");

JS:

cloudinary.imageTag('lady.jpg', {background: "auto", gravity: "auto", height: 400, width: 80, crop: "fill_pad"}).toHtml();

jQuery:

$.cloudinary.image("lady.jpg", {background: "auto", gravity: "auto", height: 400, width: 80, crop: "fill_pad"})

React:

<Image publicId="lady.jpg" >
  <Transformation background="auto" gravity="auto" height="400" width="80" crop="fill_pad" />
</Image>

Vue.js:

<cld-image public-id="lady.jpg" >
  <cld-transformation background="auto" gravity="auto" height="400" width="80" crop="fill_pad" />
</cld-image>

Angular:

<cl-image public-id="lady.jpg" >
  <cl-transformation background="auto" gravity="auto" height="400" width="80" crop="fill_pad">
  </cl-transformation>
</cl-image>

.NET:

cloudinary.Api.UrlImgUp.Transform(new Transformation().Background("auto").Gravity("auto").Height(400).Width(80).Crop("fill_pad")).BuildImageTag("lady.jpg")

iOS:

imageView.cldSetImage(cloudinary.createUrl().setTransformation(CLDTransformation().setBackground("auto").setGravity("auto").setHeight(400).setWidth(80).setCrop("fill_pad")).generate("lady.jpg")!, cloudinary: cloudinary)

Android:

MediaManager.get().url().transformation(new Transformation().background("auto").gravity("auto").height(400).width(80).crop("fill_pad")).generate("lady.jpg");

Kotlin:

cloudinary.image {
publicId("lady.jpg")
resize(Resize.fillPad() {
width(80)
height(400)
gravity(Gravity.autoGravity())
background(Background.auto())
})
}.generate()

c_fit

Scales the asset up or down so that it takes up as much space as possible within a bounding box defined by the specified dimension parameters without cropping any of it. The original aspect ratio is retained and all of the original image is visible.

Required qualifiers

Two of the following: w (width) | h (height) | ar (aspect ratio)

(In rare cases, you may choose to provide only one sizing qualifier)

Example

Fit an image within a width and height of 150 pixels (c_fit,h_150,w_150).

URL Ruby PHP Python Node.js Java JS jQuery React Vue.js Angular .NET iOS Android Kotlin All

URL:

https://res.cloudinary.com/demo/image/upload/c_fit,h_150,w_150/sample.jpg

Ruby:

cl_image_tag("sample.jpg", :height=>150, :width=>150, :crop=>"fit")

PHP (cloudinary_php v1.x (legacy)):

cl_image_tag("sample.jpg", array("height"=>150, "width"=>150, "crop"=>"fit"))

Library:

PHP (cloudinary_php v2.x):

(new ImageTag('sample.jpg'))
  ->resize(Resize::fit()->width(150)->height(150));

Library:

Python:

CloudinaryImage("sample.jpg").image(height=150, width=150, crop="fit")

Node.js:

cloudinary.image("sample.jpg", {height: 150, width: 150, crop: "fit"})

Java:

cloudinary.url().transformation(new Transformation().height(150).width(150).crop("fit")).imageTag("sample.jpg");

JS:

cloudinary.imageTag('sample.jpg', {height: 150, width: 150, crop: "fit"}).toHtml();

jQuery:

$.cloudinary.image("sample.jpg", {height: 150, width: 150, crop: "fit"})

React:

<Image publicId="sample.jpg" >
  <Transformation height="150" width="150" crop="fit" />
</Image>

Vue.js:

<cld-image public-id="sample.jpg" >
  <cld-transformation height="150" width="150" crop="fit" />
</cld-image>

Angular:

<cl-image public-id="sample.jpg" >
  <cl-transformation height="150" width="150" crop="fit">
  </cl-transformation>
</cl-image>

.NET:

cloudinary.Api.UrlImgUp.Transform(new Transformation().Height(150).Width(150).Crop("fit")).BuildImageTag("sample.jpg")

iOS:

imageView.cldSetImage(cloudinary.createUrl().setTransformation(CLDTransformation().setHeight(150).setWidth(150).setCrop("fit")).generate("sample.jpg")!, cloudinary: cloudinary)

Android:

MediaManager.get().url().transformation(new Transformation().height(150).width(150).crop("fit")).generate("sample.jpg");

Kotlin:

cloudinary.image {
publicId("sample.jpg")
resize(Resize.fit() {
width(150)
height(150)
})
}.generate()

c_imagga_crop

Requires the Imagga Crop and Scale add-on.
The Imagga Crop and Scale add-on can be used to smartly crop your images based on areas of interest within each specific photo as automatically calculated by the Imagga algorithm.

Required qualifiers

At least one of the following: w (width) | h (height)

Optional qualifiers

ar (aspect_ratio)

Example

Automatically crop an image with with Imagga cropping (c_imagga_crop):

URL Ruby PHP Python Node.js Java JS jQuery React Vue.js Angular .NET iOS Android Kotlin All

URL:

https://res.cloudinary.com/demo/image/upload/c_imagga_crop/family_bench.jpg

Ruby:

cl_image_tag("family_bench.jpg", :crop=>"imagga_crop")

PHP (cloudinary_php v1.x (legacy)):

cl_image_tag("family_bench.jpg", array("crop"=>"imagga_crop"))

Library:

PHP (cloudinary_php v2.x):

(new ImageTag('family_bench.jpg'))
  ->resize(Resize::imaggaCrop());

Library:

Python:

CloudinaryImage("family_bench.jpg").image(crop="imagga_crop")

Node.js:

cloudinary.image("family_bench.jpg", {crop: "imagga_crop"})

Java:

cloudinary.url().transformation(new Transformation().crop("imagga_crop")).imageTag("family_bench.jpg");

JS:

cloudinary.imageTag('family_bench.jpg', {crop: "imagga_crop"}).toHtml();

jQuery:

$.cloudinary.image("family_bench.jpg", {crop: "imagga_crop"})

React:

<Image publicId="family_bench.jpg" >
  <Transformation crop="imagga_crop" />
</Image>

Vue.js:

<cld-image public-id="family_bench.jpg" >
  <cld-transformation crop="imagga_crop" />
</cld-image>

Angular:

<cl-image public-id="family_bench.jpg" >
  <cl-transformation crop="imagga_crop">
  </cl-transformation>
</cl-image>

.NET:

cloudinary.Api.UrlImgUp.Transform(new Transformation().Crop("imagga_crop")).BuildImageTag("family_bench.jpg")

iOS:

imageView.cldSetImage(cloudinary.createUrl().setTransformation(CLDTransformation().setCrop("imagga_crop")).generate("family_bench.jpg")!, cloudinary: cloudinary)

Android:

MediaManager.get().url().transformation(new Transformation().crop("imagga_crop")).generate("family_bench.jpg");

Kotlin:

cloudinary.image {
publicId("family_bench.jpg")
resize(Resize.imaggaCrop())
}.generate()

c_imagga_scale

Requires the Imagga Crop and Scale add-on.
The Imagga Crop and Scale add-on can be used to smartly scale your images based on automatically calculated areas of interest within each specific photo.

Required qualifiers

At least one of the following: w (width) | h (height) | ar (aspect ratio)

(In rare cases, you may choose to provide only one sizing qualifier)

Example

Automatically scale an image with with Imagga scaling and crop if needed (c_imagga_scale,h_150,w_150):

URL Ruby PHP Python Node.js Java JS jQuery React Vue.js Angular .NET iOS Android Kotlin All

URL:

https://res.cloudinary.com/demo/image/upload/c_imagga_scale,h_150,w_150/sample_van.jpg

Ruby:

cl_image_tag("sample_van.jpg", :height=>150, :width=>150, :crop=>"imagga_scale")

PHP (cloudinary_php v1.x (legacy)):

cl_image_tag("sample_van.jpg", array("height"=>150, "width"=>150, "crop"=>"imagga_scale"))

Library:

PHP (cloudinary_php v2.x):

(new ImageTag('sample_van.jpg'))
  ->resize(Resize::imaggaScale()->width(150)->height(150));

Library:

Python:

CloudinaryImage("sample_van.jpg").image(height=150, width=150, crop="imagga_scale")

Node.js:

cloudinary.image("sample_van.jpg", {height: 150, width: 150, crop: "imagga_scale"})

Java:

cloudinary.url().transformation(new Transformation().height(150).width(150).crop("imagga_scale")).imageTag("sample_van.jpg");

JS:

cloudinary.imageTag('sample_van.jpg', {height: 150, width: 150, crop: "imagga_scale"}).toHtml();

jQuery:

$.cloudinary.image("sample_van.jpg", {height: 150, width: 150, crop: "imagga_scale"})

React:

<Image publicId="sample_van.jpg" >
  <Transformation height="150" width="150" crop="imagga_scale" />
</Image>

Vue.js:

<cld-image public-id="sample_van.jpg" >
  <cld-transformation height="150" width="150" crop="imagga_scale" />
</cld-image>

Angular:

<cl-image public-id="sample_van.jpg" >
  <cl-transformation height="150" width="150" crop="imagga_scale">
  </cl-transformation>
</cl-image>

.NET:

cloudinary.Api.UrlImgUp.Transform(new Transformation().Height(150).Width(150).Crop("imagga_scale")).BuildImageTag("sample_van.jpg")

iOS:

imageView.cldSetImage(cloudinary.createUrl().setTransformation(CLDTransformation().setHeight(150).setWidth(150).setCrop("imagga_scale")).generate("sample_van.jpg")!, cloudinary: cloudinary)

Android:

MediaManager.get().url().transformation(new Transformation().height(150).width(150).crop("imagga_scale")).generate("sample_van.jpg");

Kotlin:

cloudinary.image {
publicId("sample_van.jpg")
resize(Resize.imaggaScale() {
width(150)
height(150)
})
}.generate()

c_lfill

The lfill (limit fill) mode is the same as fill but only if the original image is larger than the specified resolution limits, in which case the image is scaled down to fill the specified width and height without distorting the image, and then the dimension that exceeds the request is cropped. If the original dimensions are smaller than the requested size, it is not resized at all. This prevents upscaling. You can specify which part of the original image you want to keep if cropping occurs using the gravity parameter (set to center by default).

Required qualifiers

Two of the following: w (width) | h (height) | ar (aspect ratio)

(In rare cases, you may choose to provide only one sizing qualifier)

Optional qualifiers

g (gravity)

Example

Limit-fill an image to a width and height of 150 pixels (c_lfill,h_150,w_150):

URL Ruby PHP Python Node.js Java JS jQuery React Vue.js Angular .NET iOS Android Kotlin All

URL:

https://res.cloudinary.com/demo/image/upload/c_lfill,h_150,w_150/sample.jpg

Ruby:

cl_image_tag("sample.jpg", :height=>150, :width=>150, :crop=>"lfill")

PHP (cloudinary_php v1.x (legacy)):

cl_image_tag("sample.jpg", array("height"=>150, "width"=>150, "crop"=>"lfill"))

Library:

PHP (cloudinary_php v2.x):

(new ImageTag('sample.jpg'))
  ->resize(Resize::limitFill()->width(150)->height(150));

Library:

Python:

CloudinaryImage("sample.jpg").image(height=150, width=150, crop="lfill")

Node.js:

cloudinary.image("sample.jpg", {height: 150, width: 150, crop: "lfill"})

Java:

cloudinary.url().transformation(new Transformation().height(150).width(150).crop("lfill")).imageTag("sample.jpg");

JS:

cloudinary.imageTag('sample.jpg', {height: 150, width: 150, crop: "lfill"}).toHtml();

jQuery:

$.cloudinary.image("sample.jpg", {height: 150, width: 150, crop: "lfill"})

React:

<Image publicId="sample.jpg" >
  <Transformation height="150" width="150" crop="lfill" />
</Image>

Vue.js:

<cld-image public-id="sample.jpg" >
  <cld-transformation height="150" width="150" crop="lfill" />
</cld-image>

Angular:

<cl-image public-id="sample.jpg" >
  <cl-transformation height="150" width="150" crop="lfill">
  </cl-transformation>
</cl-image>

.NET:

cloudinary.Api.UrlImgUp.Transform(new Transformation().Height(150).Width(150).Crop("lfill")).BuildImageTag("sample.jpg")

iOS:

imageView.cldSetImage(cloudinary.createUrl().setTransformation(CLDTransformation().setHeight(150).setWidth(150).setCrop("lfill")).generate("sample.jpg")!, cloudinary: cloudinary)

Android:

MediaManager.get().url().transformation(new Transformation().height(150).width(150).crop("lfill")).generate("sample.jpg");

Kotlin:

cloudinary.image {
publicId("sample.jpg")
resize(Resize.limitFill() {
width(150)
height(150)
})
}.generate()

Image limit-filled to a width and height of 150 pixels

c_limit

Same as the fit mode but only if the original asset is larger than the specified limit (width and height), in which case the asset is scaled down so that it takes up as much space as possible within a bounding box defined by the specified width and height parameters. The original aspect ratio is retained (by default) and all of the original asset is visible. This mode doesn't scale up the asset if your requested dimensions are larger than the original image size.

Required qualifiers

Two of the following: w (width) | h (height) | ar (aspect ratio)

(In rare cases, you may choose to provide only one sizing qualifier)

Example

Limit an image to a width and height of 150 pixels (c_limit,h_150,w_150):

URL Ruby PHP Python Node.js Java JS jQuery React Vue.js Angular .NET iOS Android Kotlin All

URL:

https://res.cloudinary.com/demo/image/upload/c_limit,h_150,w_150/sample.jpg

Ruby:

cl_image_tag("sample.jpg", :height=>150, :width=>150, :crop=>"limit")

PHP (cloudinary_php v1.x (legacy)):

cl_image_tag("sample.jpg", array("height"=>150, "width"=>150, "crop"=>"limit"))

Library:

PHP (cloudinary_php v2.x):

(new ImageTag('sample.jpg'))
  ->resize(Resize::limitFit()->width(150)->height(150));

Library:

Python:

CloudinaryImage("sample.jpg").image(height=150, width=150, crop="limit")

Node.js:

cloudinary.image("sample.jpg", {height: 150, width: 150, crop: "limit"})

Java:

cloudinary.url().transformation(new Transformation().height(150).width(150).crop("limit")).imageTag("sample.jpg");

JS:

cloudinary.imageTag('sample.jpg', {height: 150, width: 150, crop: "limit"}).toHtml();

jQuery:

$.cloudinary.image("sample.jpg", {height: 150, width: 150, crop: "limit"})

React:

<Image publicId="sample.jpg" >
  <Transformation height="150" width="150" crop="limit" />
</Image>

Vue.js:

<cld-image public-id="sample.jpg" >
  <cld-transformation height="150" width="150" crop="limit" />
</cld-image>

Angular:

<cl-image public-id="sample.jpg" >
  <cl-transformation height="150" width="150" crop="limit">
  </cl-transformation>
</cl-image>

.NET:

cloudinary.Api.UrlImgUp.Transform(new Transformation().Height(150).Width(150).Crop("limit")).BuildImageTag("sample.jpg")

iOS:

imageView.cldSetImage(cloudinary.createUrl().setTransformation(CLDTransformation().setHeight(150).setWidth(150).setCrop("limit")).generate("sample.jpg")!, cloudinary: cloudinary)

Android:

MediaManager.get().url().transformation(new Transformation().height(150).width(150).crop("limit")).generate("sample.jpg");

Kotlin:

cloudinary.image {
publicId("sample.jpg")
resize(Resize.limitFit() {
width(150)
height(150)
})
}.generate()

Image limited to a width and height of 150 pixels

c_lpad

The lpad (limit pad) mode is the same as pad but only if the original asset is larger than the specified limit (width and height), in which case the asset is scaled down to fill the specified width and height while retaining the original aspect ratio (by default) and with all of the original asset visible. This mode doesn't scale up the asset if your requested dimensions are bigger than the original asset size. Instead, if the proportions of the original asset do not match the requested width and height, padding is added to the asset to reach the required size. You can also specify where the original asset is placed by using the gravity parameter (set to center by default). Additionally, you can specify the color of the background in the case that padding is added.

Required qualifiers

Two of the following: w (width) | h (height) | ar (aspect ratio)

(In rare cases, you may choose to provide only one sizing qualifier)

Optional qualifiers

g_<gravity position> | b (background)

Example

Limit-pad an image with a green background to a width and height of 150 pixels (b_green,c_lpad,h_150,w_150):

URL Ruby PHP Python Node.js Java JS jQuery React Vue.js Angular .NET iOS Android Kotlin All

URL:

https://res.cloudinary.com/demo/image/upload/b_green,c_lpad,h_150,w_150/sample.jpg

Ruby:

cl_image_tag("sample.jpg", :background=>"green", :height=>150, :width=>150, :crop=>"lpad")

PHP (cloudinary_php v1.x (legacy)):

cl_image_tag("sample.jpg", array("background"=>"green", "height"=>150, "width"=>150, "crop"=>"lpad"))

Library:

PHP (cloudinary_php v2.x):

(new ImageTag('sample.jpg'))
  ->resize(Resize::limitPad()->width(150)->height(150)
    ->background(Background::color(Color::GREEN)));

Library:

Python:

CloudinaryImage("sample.jpg").image(background="green", height=150, width=150, crop="lpad")

Node.js:

cloudinary.image("sample.jpg", {background: "green", height: 150, width: 150, crop: "lpad"})

Java:

cloudinary.url().transformation(new Transformation().background("green").height(150).width(150).crop("lpad")).imageTag("sample.jpg");

JS:

cloudinary.imageTag('sample.jpg', {background: "green", height: 150, width: 150, crop: "lpad"}).toHtml();

jQuery:

$.cloudinary.image("sample.jpg", {background: "green", height: 150, width: 150, crop: "lpad"})

React:

<Image publicId="sample.jpg" >
  <Transformation background="green" height="150" width="150" crop="lpad" />
</Image>

Vue.js:

<cld-image public-id="sample.jpg" >
  <cld-transformation background="green" height="150" width="150" crop="lpad" />
</cld-image>

Angular:

<cl-image public-id="sample.jpg" >
  <cl-transformation background="green" height="150" width="150" crop="lpad">
  </cl-transformation>
</cl-image>

.NET:

cloudinary.Api.UrlImgUp.Transform(new Transformation().Background("green").Height(150).Width(150).Crop("lpad")).BuildImageTag("sample.jpg")

iOS:

imageView.cldSetImage(cloudinary.createUrl().setTransformation(CLDTransformation().setBackground("green").setHeight(150).setWidth(150).setCrop("lpad")).generate("sample.jpg")!, cloudinary: cloudinary)

Android:

MediaManager.get().url().transformation(new Transformation().background("green").height(150).width(150).crop("lpad")).generate("sample.jpg");

Kotlin:

cloudinary.image {
publicId("sample.jpg")
resize(Resize.limitPad() {
width(150)
height(150)
background(Background.color(Color.GREEN))
})
}.generate()

Image limit-padded to a width and height of 250 pixels

c_mfit

The mfit (minimum fit) mode is the same as fit but only if the original image is smaller than the specified minimum (width and height), in which case the image is scaled up so that it takes up as much space as possible within a bounding box defined by the specified width and height parameters. The original aspect ratio is retained (by default) and all of the original image is visible. This mode doesn't scale down the image if your requested dimensions are smaller than the original image's.

Required qualifiers

Two of the following: w (width) | h (height) | ar (aspect ratio)

(In rare cases, you may choose to provide only one sizing qualifier)

Example

Request to fit a large image to a minimum width and height of 20 pixels while retaining the aspect ratio. This results in delivering the original image without resizing it (c_mfit,h_20,w_20):

URL Ruby PHP Python Node.js Java JS jQuery React Vue.js Angular .NET iOS Android Kotlin All

URL:

https://res.cloudinary.com/demo/image/upload/c_mfit,h_20,w_20/sample.jpg

Ruby:

cl_image_tag("sample.jpg", :height=>20, :width=>20, :crop=>"mfit")

PHP (cloudinary_php v1.x (legacy)):

cl_image_tag("sample.jpg", array("height"=>20, "width"=>20, "crop"=>"mfit"))

Library:

PHP (cloudinary_php v2.x):

(new ImageTag('sample.jpg'))
  ->resize(Resize::minimumFit()->width(20)->height(20));

Library:

Python:

CloudinaryImage("sample.jpg").image(height=20, width=20, crop="mfit")

Node.js:

cloudinary.image("sample.jpg", {height: 20, width: 20, crop: "mfit"})

Java:

cloudinary.url().transformation(new Transformation().height(20).width(20).crop("mfit")).imageTag("sample.jpg");

JS:

cloudinary.imageTag('sample.jpg', {height: 20, width: 20, crop: "mfit"}).toHtml();

jQuery:

$.cloudinary.image("sample.jpg", {height: 20, width: 20, crop: "mfit"})

React:

<Image publicId="sample.jpg" >
  <Transformation height="20" width="20" crop="mfit" />
</Image>

Vue.js:

<cld-image public-id="sample.jpg" >
  <cld-transformation height="20" width="20" crop="mfit" />
</cld-image>

Angular:

<cl-image public-id="sample.jpg" >
  <cl-transformation height="20" width="20" crop="mfit">
  </cl-transformation>
</cl-image>

.NET:

cloudinary.Api.UrlImgUp.Transform(new Transformation().Height(20).Width(20).Crop("mfit")).BuildImageTag("sample.jpg")

iOS:

imageView.cldSetImage(cloudinary.createUrl().setTransformation(CLDTransformation().setHeight(20).setWidth(20).setCrop("mfit")).generate("sample.jpg")!, cloudinary: cloudinary)

Android:

MediaManager.get().url().transformation(new Transformation().height(20).width(20).crop("mfit")).generate("sample.jpg");

Kotlin:

cloudinary.image {
publicId("sample.jpg")
resize(Resize.minimumFit() {
width(20)
height(20)
})
}.generate()

Image mfit to a width and height of 20 pixels

c_mpad

The mpad (minimum pad) mode is the same as pad but only if the original image is smaller than the specified minimum (width and height), in which case the image is unchanged but padding is added to fill the specified dimensions. This mode doesn't scale down the image if your requested dimensions are smaller than the original image's. You can also specify where the original image is placed by using the gravity parameter (set to center by default). Additionally, you can specify the color of the background in the case that padding is added.

Required qualifiers

Two of the following: w (width) | h (height) | ar (aspect ratio)

(In rare cases, you may choose to provide only one sizing qualifier)

Optional qualifiers

g_<gravity position> | b (background)

Examples

Request to pad a large image to a minimum width and height of 20 pixels while retaining the aspect ratio. This results in delivering the original larger image (c_mpad,h_20,w_20):

URL Ruby PHP Python Node.js Java JS jQuery React Vue.js Angular .NET iOS Android Kotlin All

URL:

https://res.cloudinary.com/demo/image/upload/c_mpad,h_20,w_20/sample.jpg

Ruby:

cl_image_tag("sample.jpg", :height=>20, :width=>20, :crop=>"mpad")

PHP (cloudinary_php v1.x (legacy)):

cl_image_tag("sample.jpg", array("height"=>20, "width"=>20, "crop"=>"mpad"))

Library:

PHP (cloudinary_php v2.x):

(new ImageTag('sample.jpg'))
  ->resize(Resize::minimumPad()->width(20)->height(20));

Library:

Python:

CloudinaryImage("sample.jpg").image(height=20, width=20, crop="mpad")

Node.js:

cloudinary.image("sample.jpg", {height: 20, width: 20, crop: "mpad"})

Java:

cloudinary.url().transformation(new Transformation().height(20).width(20).crop("mpad")).imageTag("sample.jpg");

JS:

cloudinary.imageTag('sample.jpg', {height: 20, width: 20, crop: "mpad"}).toHtml();

jQuery:

$.cloudinary.image("sample.jpg", {height: 20, width: 20, crop: "mpad"})

React:

<Image publicId="sample.jpg" >
  <Transformation height="20" width="20" crop="mpad" />
</Image>

Vue.js:

<cld-image public-id="sample.jpg" >
  <cld-transformation height="20" width="20" crop="mpad" />
</cld-image>

Angular:

<cl-image public-id="sample.jpg" >
  <cl-transformation height="20" width="20" crop="mpad">
  </cl-transformation>
</cl-image>

.NET:

cloudinary.Api.UrlImgUp.Transform(new Transformation().Height(20).Width(20).Crop("mpad")).BuildImageTag("sample.jpg")

iOS:

imageView.cldSetImage(cloudinary.createUrl().setTransformation(CLDTransformation().setHeight(20).setWidth(20).setCrop("mpad")).generate("sample.jpg")!, cloudinary: cloudinary)

Android:

MediaManager.get().url().transformation(new Transformation().height(20).width(20).crop("mpad")).generate("sample.jpg");

Kotlin:

cloudinary.image {
publicId("sample.jpg")
resize(Resize.minimumPad() {
width(20)
height(20)
})
}.generate()

Image minimum padded to a width and height of 20 pixels

Request to pad with a green background, a 100-pixel wide image to a minimum width and height of 150 pixels while retaining the aspect ratio (b_green,c_mpad,h_150,w_150):

URL Ruby PHP Python Node.js Java JS jQuery React Vue.js Angular .NET iOS Android Kotlin All

URL:

https://res.cloudinary.com/demo/image/upload/b_green,c_mpad,h_150,w_150/docs/sample_100.jpg

Ruby:

cl_image_tag("docs/sample_100.jpg", :background=>"green", :height=>150, :width=>150, :crop=>"mpad")

PHP (cloudinary_php v1.x (legacy)):

cl_image_tag("docs/sample_100.jpg", array("background"=>"green", "height"=>150, "width"=>150, "crop"=>"mpad"))

Library:

PHP (cloudinary_php v2.x):

(new ImageTag('docs/sample_100.jpg'))
  ->resize(Resize::minimumPad()->width(150)->height(150)
    ->background(Background::color(Color::GREEN)));

Library:

Python:

CloudinaryImage("docs/sample_100.jpg").image(background="green", height=150, width=150, crop="mpad")

Node.js:

cloudinary.image("docs/sample_100.jpg", {background: "green", height: 150, width: 150, crop: "mpad"})

Java:

cloudinary.url().transformation(new Transformation().background("green").height(150).width(150).crop("mpad")).imageTag("docs/sample_100.jpg");

JS:

cloudinary.imageTag('docs/sample_100.jpg', {background: "green", height: 150, width: 150, crop: "mpad"}).toHtml();

jQuery:

$.cloudinary.image("docs/sample_100.jpg", {background: "green", height: 150, width: 150, crop: "mpad"})

React:

<Image publicId="docs/sample_100.jpg" >
  <Transformation background="green" height="150" width="150" crop="mpad" />
</Image>

Vue.js:

<cld-image public-id="docs/sample_100.jpg" >
  <cld-transformation background="green" height="150" width="150" crop="mpad" />
</cld-image>

Angular:

<cl-image public-id="docs/sample_100.jpg" >
  <cl-transformation background="green" height="150" width="150" crop="mpad">
  </cl-transformation>
</cl-image>

.NET:

cloudinary.Api.UrlImgUp.Transform(new Transformation().Background("green").Height(150).Width(150).Crop("mpad")).BuildImageTag("docs/sample_100.jpg")

iOS:

imageView.cldSetImage(cloudinary.createUrl().setTransformation(CLDTransformation().setBackground("green").setHeight(150).setWidth(150).setCrop("mpad")).generate("docs/sample_100.jpg")!, cloudinary: cloudinary)

Android:

MediaManager.get().url().transformation(new Transformation().background("green").height(150).width(150).crop("mpad")).generate("docs/sample_100.jpg");

Kotlin:

cloudinary.image {
publicId("docs/sample_100.jpg")
resize(Resize.minimumPad() {
width(150)
height(150)
background(Background.color(Color.GREEN))
})
}.generate()

c_pad

Resizes the asset to fill the specified width and height while retaining the original aspect ratio (by default) and with all of the original asset visible. If the proportions of the original asset do not match the specified width and height, padding is added to the asset to reach the required size. You can also specify where the original asset is placed using the gravity parameter (set to center by default). Additionally, you can specify the color of the background in the case that padding is added.

Required qualifiers

Two of the following: w (width) | h (height) | ar (aspect ratio)

(In rare cases, you may choose to provide only one sizing qualifier)

Optional qualifiers

g_<gravity position> | b (background)

Example

Pad an image with a black background to a width and height of 150 pixels (b_black,c_pad,h_150,w_150):

URL Ruby PHP Python Node.js Java JS jQuery React Vue.js Angular .NET iOS Android Kotlin All

URL:

https://res.cloudinary.com/demo/image/upload/b_black,c_pad,h_150,w_150/sample.jpg

Ruby:

cl_image_tag("sample.jpg", :background=>"black", :height=>150, :width=>150, :crop=>"pad")

PHP (cloudinary_php v1.x (legacy)):

cl_image_tag("sample.jpg", array("background"=>"black", "height"=>150, "width"=>150, "crop"=>"pad"))

Library:

PHP (cloudinary_php v2.x):

(new ImageTag('sample.jpg'))
  ->resize(Resize::pad()->width(150)->height(150)
    ->background(Background::color(Color::BLACK)));

Library:

Python:

CloudinaryImage("sample.jpg").image(background="black", height=150, width=150, crop="pad")

Node.js:

cloudinary.image("sample.jpg", {background: "black", height: 150, width: 150, crop: "pad"})

Java:

cloudinary.url().transformation(new Transformation().background("black").height(150).width(150).crop("pad")).imageTag("sample.jpg");

JS:

cloudinary.imageTag('sample.jpg', {background: "black", height: 150, width: 150, crop: "pad"}).toHtml();

jQuery:

$.cloudinary.image("sample.jpg", {background: "black", height: 150, width: 150, crop: "pad"})

React:

<Image publicId="sample.jpg" >
  <Transformation background="black" height="150" width="150" crop="pad" />
</Image>

Vue.js:

<cld-image public-id="sample.jpg" >
  <cld-transformation background="black" height="150" width="150" crop="pad" />
</cld-image>

Angular:

<cl-image public-id="sample.jpg" >
  <cl-transformation background="black" height="150" width="150" crop="pad">
  </cl-transformation>
</cl-image>

.NET:

cloudinary.Api.UrlImgUp.Transform(new Transformation().Background("black").Height(150).Width(150).Crop("pad")).BuildImageTag("sample.jpg")

iOS:

imageView.cldSetImage(cloudinary.createUrl().setTransformation(CLDTransformation().setBackground("black").setHeight(150).setWidth(150).setCrop("pad")).generate("sample.jpg")!, cloudinary: cloudinary)

Android:

MediaManager.get().url().transformation(new Transformation().background("black").height(150).width(150).crop("pad")).generate("sample.jpg");

Kotlin:

cloudinary.image {
publicId("sample.jpg")
resize(Resize.pad() {
width(150)
height(150)
background(Background.color(Color.BLACK))
})
}.generate()

Image padded to a width and height of 150 pixels

c_scale

Resizes the asset exactly to the specified width and height. All original asset parts are visible, but might be stretched or shrunk if the dimensions you request have a different aspect ratio than the original.

If only width or only height is specified, then the asset is scaled to the new dimension while retaining the original aspect ratio (unless you also include the fl_ignore_aspect_ratio flag).

Required qualifiers

At least one of the following: w (width) | h (height) | ar (aspect ratio)

Optional qualifiers

fl_ignore_aspect_ratio | g_liquid

See also: Liquid rescaling

Examples

Scale to a width of 150 pixels (maintains the aspect ratio by default) (c_scale,w_150):

URL Ruby PHP Python Node.js Java JS jQuery React Vue.js Angular .NET iOS Android Kotlin All

URL:

https://res.cloudinary.com/demo/image/upload/c_scale,w_150/sample.jpg

Ruby:

cl_image_tag("sample.jpg", :width=>150, :crop=>"scale")

PHP (cloudinary_php v1.x (legacy)):

cl_image_tag("sample.jpg", array("width"=>150, "crop"=>"scale"))

Library:

PHP (cloudinary_php v2.x):

(new ImageTag('sample.jpg'))
  ->resize(Resize::scale()->width(150));

Library:

Python:

CloudinaryImage("sample.jpg").image(width=150, crop="scale")

Node.js:

cloudinary.image("sample.jpg", {width: 150, crop: "scale"})

Java:

cloudinary.url().transformation(new Transformation().width(150).crop("scale")).imageTag("sample.jpg");

JS:

cloudinary.imageTag('sample.jpg', {width: 150, crop: "scale"}).toHtml();

jQuery:

$.cloudinary.image("sample.jpg", {width: 150, crop: "scale"})

React:

<Image publicId="sample.jpg" >
  <Transformation width="150" crop="scale" />
</Image>

Vue.js:

<cld-image public-id="sample.jpg" >
  <cld-transformation width="150" crop="scale" />
</cld-image>

Angular:

<cl-image public-id="sample.jpg" >
  <cl-transformation width="150" crop="scale">
  </cl-transformation>
</cl-image>

.NET:

cloudinary.Api.UrlImgUp.Transform(new Transformation().Width(150).Crop("scale")).BuildImageTag("sample.jpg")

iOS:

imageView.cldSetImage(cloudinary.createUrl().setTransformation(CLDTransformation().setWidth(150).setCrop("scale")).generate("sample.jpg")!, cloudinary: cloudinary)

Android:

MediaManager.get().url().transformation(new Transformation().width(150).crop("scale")).generate("sample.jpg");

Kotlin:

cloudinary.image {
publicId("sample.jpg")
resize(Resize.scale() {
width(150)
})
}.generate()

Scale to a width and height of 150 pixels (does not maintain the aspect ratio) (c_scale,h_150,w_150):

URL Ruby PHP Python Node.js Java JS jQuery React Vue.js Angular .NET iOS Android Kotlin All

URL:

https://res.cloudinary.com/demo/image/upload/c_scale,h_150,w_150/sample.jpg

Ruby:

cl_image_tag("sample.jpg", :height=>150, :width=>150, :crop=>"scale")

PHP (cloudinary_php v1.x (legacy)):

cl_image_tag("sample.jpg", array("height"=>150, "width"=>150, "crop"=>"scale"))

Library:

PHP (cloudinary_php v2.x):

(new ImageTag('sample.jpg'))
  ->resize(Resize::scale()->width(150)->height(150));

Library:

Python:

CloudinaryImage("sample.jpg").image(height=150, width=150, crop="scale")

Node.js:

cloudinary.image("sample.jpg", {height: 150, width: 150, crop: "scale"})

Java:

cloudinary.url().transformation(new Transformation().height(150).width(150).crop("scale")).imageTag("sample.jpg");

JS:

cloudinary.imageTag('sample.jpg', {height: 150, width: 150, crop: "scale"}).toHtml();

jQuery:

$.cloudinary.image("sample.jpg", {height: 150, width: 150, crop: "scale"})

React:

<Image publicId="sample.jpg" >
  <Transformation height="150" width="150" crop="scale" />
</Image>

Vue.js:

<cld-image public-id="sample.jpg" >
  <cld-transformation height="150" width="150" crop="scale" />
</cld-image>

Angular:

<cl-image public-id="sample.jpg" >
  <cl-transformation height="150" width="150" crop="scale">
  </cl-transformation>
</cl-image>

.NET:

cloudinary.Api.UrlImgUp.Transform(new Transformation().Height(150).Width(150).Crop("scale")).BuildImageTag("sample.jpg")

iOS:

imageView.cldSetImage(cloudinary.createUrl().setTransformation(CLDTransformation().setHeight(150).setWidth(150).setCrop("scale")).generate("sample.jpg")!, cloudinary: cloudinary)

Android:

MediaManager.get().url().transformation(new Transformation().height(150).width(150).crop("scale")).generate("sample.jpg");

Kotlin:

cloudinary.image {
publicId("sample.jpg")
resize(Resize.scale() {
width(150)
height(150)
})
}.generate()

Image scaled to a width and height of 150 pixels

c_thumb

Creates image thumbnails from either face-detection or custom coordinates. Must always be accompanied by the g (gravity) parameter set to one of the face detection or on of the g_custom values. This cropping mode generates a thumbnail of an image with the exact specified width and height dimensions and with the original proportions retained, but the resulting image might be scaled to fit in the specified dimensions. You can specify the z (zoom) parameter to determine how much to scale the resulting image within the specified width and height.

Required qualifiers

g (gravity) set to to one of the face detection or custom special gravity positions.

And

Two of the following: w (width) | h (height) | ar (aspect ratio)

(In rare cases, you may choose to provide only one sizing qualifier)

Optional qualifiers

z (zoom)

Example

Crop an image to a 150x150 thumbnail using face detection (c_thumb,g_face,h_150,w_150):

URL Ruby PHP Python Node.js Java JS jQuery React Vue.js Angular .NET iOS Android Kotlin All

URL:

https://res.cloudinary.com/demo/image/upload/c_thumb,g_face,h_150,w_150/woman.jpg

Ruby:

cl_image_tag("woman.jpg", :gravity=>"face", :height=>150, :width=>150, :crop=>"thumb")

PHP (cloudinary_php v1.x (legacy)):

cl_image_tag("woman.jpg", array("gravity"=>"face", "height"=>150, "width"=>150, "crop"=>"thumb"))

Library:

PHP (cloudinary_php v2.x):

(new ImageTag('woman.jpg'))
  ->resize(Resize::thumbnail()->width(150)->height(150)
    ->gravity(Gravity::focusOn(FocusOn::face())));

Library:

Python:

CloudinaryImage("woman.jpg").image(gravity="face", height=150, width=150, crop="thumb")

Node.js:

cloudinary.image("woman.jpg", {gravity: "face", height: 150, width: 150, crop: "thumb"})

Java:

cloudinary.url().transformation(new Transformation().gravity("face").height(150).width(150).crop("thumb")).imageTag("woman.jpg");

JS:

cloudinary.imageTag('woman.jpg', {gravity: "face", height: 150, width: 150, crop: "thumb"}).toHtml();

jQuery:

$.cloudinary.image("woman.jpg", {gravity: "face", height: 150, width: 150, crop: "thumb"})

React:

<Image publicId="woman.jpg" >
  <Transformation gravity="face" height="150" width="150" crop="thumb" />
</Image>

Vue.js:

<cld-image public-id="woman.jpg" >
  <cld-transformation gravity="face" height="150" width="150" crop="thumb" />
</cld-image>

Angular:

<cl-image public-id="woman.jpg" >
  <cl-transformation gravity="face" height="150" width="150" crop="thumb">
  </cl-transformation>
</cl-image>

.NET:

cloudinary.Api.UrlImgUp.Transform(new Transformation().Gravity("face").Height(150).Width(150).Crop("thumb")).BuildImageTag("woman.jpg")

iOS:

imageView.cldSetImage(cloudinary.createUrl().setTransformation(CLDTransformation().setGravity("face").setHeight(150).setWidth(150).setCrop("thumb")).generate("woman.jpg")!, cloudinary: cloudinary)

Android:

MediaManager.get().url().transformation(new Transformation().gravity("face").height(150).width(150).crop("thumb")).generate("woman.jpg");

Kotlin:

cloudinary.image {
publicId("woman.jpg")
resize(Resize.thumbnail() {
width(150)
height(150)
gravity(Gravity.focusOn(FocusOn.face()))
})
}.generate()

co_<color value>

A qualifier that specifies the color to use with the corresponding transformation.

Value Type Description

color value

string

Value	Type	Description
color value	string	Required. The color to apply. It can be set as: A 3- or 4-digit RGB/RGBA hex An RGB or RGBA hex triplet or quadruplet (6 or 8 digits). A named color When specifying any RGB or RGBA value, always prefix the value in the URL with `rgb:` (without `#`). For example, `co_rgb:FEB61FC2` or `co_rgb:999`. When using a named color, specify only the color name. For example `co_blue`.

Required. The color to apply. It can be set as:

A 3- or 4-digit RGB/RGBA hex
An RGB or RGBA hex triplet or quadruplet (6 or 8 digits).
A named color

When specifying any RGB or RGBA value, always prefix the value in the URL with rgb: (without #). For example, co_rgb:FEB61FC2 or co_rgb:999.

When using a named color, specify only the color name. For example co_blue.

Examples

Apply a colorize effect to an image, using an RGB hex triplet to define the green color for the colorize effect (co_rgb:20a020,e_colorize:50).

URL Ruby PHP Python Node.js Java JS jQuery React Vue.js Angular .NET iOS Android Kotlin All

URL:

https://res.cloudinary.com/demo/image/upload/co_rgb:20a020,e_colorize:50/face_top.jpg

Ruby:

cl_image_tag("face_top.jpg", :color=>"#20a020", :effect=>"colorize:50")

PHP (cloudinary_php v1.x (legacy)):

cl_image_tag("face_top.jpg", array("color"=>"#20a020", "effect"=>"colorize:50"))

Library:

PHP (cloudinary_php v2.x):

(new ImageTag('face_top.jpg'))
  ->effect(Effect::colorize()->level(50)
    ->color(Color::rgb('20a020')));

Library:

Python:

CloudinaryImage("face_top.jpg").image(color="#20a020", effect="colorize:50")

Node.js:

cloudinary.image("face_top.jpg", {color: "#20a020", effect: "colorize:50"})

Java:

cloudinary.url().transformation(new Transformation().color("#20a020").effect("colorize:50")).imageTag("face_top.jpg");

JS:

cloudinary.imageTag('face_top.jpg', {color: "#20a020", effect: "colorize:50"}).toHtml();

jQuery:

$.cloudinary.image("face_top.jpg", {color: "#20a020", effect: "colorize:50"})

React:

<Image publicId="face_top.jpg" >
  <Transformation color="#20a020" effect="colorize:50" />
</Image>

Vue.js:

<cld-image public-id="face_top.jpg" >
  <cld-transformation color="#20a020" effect="colorize:50" />
</cld-image>

Angular:

<cl-image public-id="face_top.jpg" >
  <cl-transformation color="#20a020" effect="colorize:50">
  </cl-transformation>
</cl-image>

.NET:

cloudinary.Api.UrlImgUp.Transform(new Transformation().Color("#20a020").Effect("colorize:50")).BuildImageTag("face_top.jpg")

iOS:

imageView.cldSetImage(cloudinary.createUrl().setTransformation(CLDTransformation().setColor("#20a020").setEffect("colorize:50")).generate("face_top.jpg")!, cloudinary: cloudinary)

Android:

MediaManager.get().url().transformation(new Transformation().color("#20a020").effect("colorize:50")).generate("face_top.jpg");

Kotlin:

cloudinary.image {
publicId("face_top.jpg")
effect(Effect.colorize() {
level(50)
color(Color.rgb("#20a020"))
})
}.generate()

Outline a transparent shape, using 'orange' as the outline color (co_orange,e_outline).

URL Ruby PHP Python Node.js Java JS jQuery React Vue.js Angular .NET iOS Android Kotlin All

URL:

https://res.cloudinary.com/demo/image/upload/co_orange,e_outline/ring2.png

Ruby:

cl_image_tag("ring2.png", :color=>"orange", :effect=>"outline")

PHP (cloudinary_php v1.x (legacy)):

cl_image_tag("ring2.png", array("color"=>"orange", "effect"=>"outline"))

Library:

PHP (cloudinary_php v2.x):

(new ImageTag('ring2.png'))
  ->effect(Effect::outline()->color(Color::ORANGE));

Library:

Python:

CloudinaryImage("ring2.png").image(color="orange", effect="outline")

Node.js:

cloudinary.image("ring2.png", {color: "orange", effect: "outline"})

Java:

cloudinary.url().transformation(new Transformation().color("orange").effect("outline")).imageTag("ring2.png");

JS:

cloudinary.imageTag('ring2.png', {color: "orange", effect: "outline"}).toHtml();

jQuery:

$.cloudinary.image("ring2.png", {color: "orange", effect: "outline"})

React:

<Image publicId="ring2.png" >
  <Transformation color="orange" effect="outline" />
</Image>

Vue.js:

<cld-image public-id="ring2.png" >
  <cld-transformation color="orange" effect="outline" />
</cld-image>

Angular:

<cl-image public-id="ring2.png" >
  <cl-transformation color="orange" effect="outline">
  </cl-transformation>
</cl-image>

.NET:

cloudinary.Api.UrlImgUp.Transform(new Transformation().Color("orange").Effect("outline")).BuildImageTag("ring2.png")

iOS:

imageView.cldSetImage(cloudinary.createUrl().setTransformation(CLDTransformation().setColor("orange").setEffect("outline")).generate("ring2.png")!, cloudinary: cloudinary)

Android:

MediaManager.get().url().transformation(new Transformation().color("orange").effect("outline")).generate("ring2.png");

Kotlin:

cloudinary.image {
publicId("ring2.png")
effect(Effect.outline() {
color(Color.ORANGE)
})
}.generate()

Use an orange color for the outline of a transparent shape.

cs_<color space mode>

Controls the color space used for the delivered image or video. If you don't include this parameter in your transformation, the color space of the original asset is generally retained. In some cases for videos, the color space is normalized for web delivery, unless cs_copy is specified.

Value Type Description

color space mode

constant

Value	Type	Description
color space mode	constant	Required. The color space mode to use when delivering the image or video. Possible values: `sRGB`: Renders the image or video in the sRGB color space. `tinysrgb`: Renders the image or video using Facebook's truncated sRGB color space. `cmyk`: Renders the image or video in the CMYK color space. `no_cmyk`: If the original image or video used the CMYK color space, converts it to sRGB. `keep_cmyk`: Retains the CMYK color space when generating derived images or videos. `srgb:truecolor`: Image only. Encodes the image as RGB, rather than palette or grayscale. Not applicable when using q_auto. `cs_icc:[public_id]`: Image only. Renders the image using the specified color space (icc) file. The icc file must be uploaded to your account as a raw and authenticated file. Specify the public ID of your icc file including the file extension. `copy`: Video only. Retains the original color space of the video. This prevents the color space from being normalized when the video is re-encoded by Cloudinary if another transformation is applied.

Required. The color space mode to use when delivering the image or video.

Possible values:

sRGB: Renders the image or video in the sRGB color space.
tinysrgb: Renders the image or video using Facebook's truncated sRGB color space.
cmyk: Renders the image or video in the CMYK color space.
no_cmyk: If the original image or video used the CMYK color space, converts it to sRGB.
keep_cmyk: Retains the CMYK color space when generating derived images or videos.
srgb:truecolor: Image only. Encodes the image as RGB, rather than palette or grayscale. Not applicable when using q_auto.
cs_icc:[public_id]: Image only. Renders the image using the specified color space (icc) file. The icc file must be uploaded to your account as a raw and authenticated file. Specify the public ID of your icc file including the file extension.
copy: Video only. Retains the original color space of the video. This prevents the color space from being normalized when the video is re-encoded by Cloudinary if another transformation is applied.

Examples

Render an image in the sRGB color space (cs_srgb).

URL Ruby PHP Python Node.js Java JS jQuery React Vue.js Angular .NET iOS Android Kotlin All

URL:

https://res.cloudinary.com/demo/image/upload/cs_srgb/face_top.jpg

Ruby:

cl_image_tag("face_top.jpg", :color_space=>"srgb")

PHP (cloudinary_php v1.x (legacy)):

cl_image_tag("face_top.jpg", array("color_space"=>"srgb"))

Library:

PHP (cloudinary_php v2.x):

(new ImageTag('face_top.jpg'))
  ->delivery(Delivery::colorSpace(ColorSpace::srgb()));

Library:

Python:

CloudinaryImage("face_top.jpg").image(color_space="srgb")

Node.js:

cloudinary.image("face_top.jpg", {color_space: "srgb"})

Java:

cloudinary.url().transformation(new Transformation().colorSpace("srgb")).imageTag("face_top.jpg");

JS:

cloudinary.imageTag('face_top.jpg', {colorSpace: "srgb"}).toHtml();

jQuery:

$.cloudinary.image("face_top.jpg", {color_space: "srgb"})

React:

<Image publicId="face_top.jpg" >
  <Transformation colorSpace="srgb" />
</Image>

Vue.js:

<cld-image public-id="face_top.jpg" >
  <cld-transformation color-space="srgb" />
</cld-image>

Angular:

<cl-image public-id="face_top.jpg" >
  <cl-transformation color-space="srgb">
  </cl-transformation>
</cl-image>

.NET:

cloudinary.Api.UrlImgUp.Transform(new Transformation().ColorSpace("srgb")).BuildImageTag("face_top.jpg")

iOS:

imageView.cldSetImage(cloudinary.createUrl().setTransformation(CLDTransformation().setColorSpace("srgb")).generate("face_top.jpg")!, cloudinary: cloudinary)

Android:

MediaManager.get().url().transformation(new Transformation().colorSpace("srgb")).generate("face_top.jpg");

Kotlin:

cloudinary.image {
publicId("face_top.jpg")
delivery(Delivery.colorSpace(ColorSpace.srgb()))
}.generate()

Render an image in the CMYK color space (cs_keep_cmyk).

URL Ruby PHP Python Node.js Java JS jQuery React Vue.js Angular .NET iOS Android Kotlin All

URL:

https://res.cloudinary.com/demo/image/upload/cs_keep_cmyk/face_top.jpg

Ruby:

cl_image_tag("face_top.jpg", :color_space=>"keep_cmyk")

PHP (cloudinary_php v1.x (legacy)):

cl_image_tag("face_top.jpg", array("color_space"=>"keep_cmyk"))

Library:

PHP (cloudinary_php v2.x):

(new ImageTag('face_top.jpg'))
  ->delivery(Delivery::colorSpace(ColorSpace::keepCmyk()));

Library:

Python:

CloudinaryImage("face_top.jpg").image(color_space="keep_cmyk")

Node.js:

cloudinary.image("face_top.jpg", {color_space: "keep_cmyk"})

Java:

cloudinary.url().transformation(new Transformation().colorSpace("keep_cmyk")).imageTag("face_top.jpg");

JS:

cloudinary.imageTag('face_top.jpg', {colorSpace: "keep_cmyk"}).toHtml();

jQuery:

$.cloudinary.image("face_top.jpg", {color_space: "keep_cmyk"})

React:

<Image publicId="face_top.jpg" >
  <Transformation colorSpace="keep_cmyk" />
</Image>

Vue.js:

<cld-image public-id="face_top.jpg" >
  <cld-transformation color-space="keep_cmyk" />
</cld-image>

Angular:

<cl-image public-id="face_top.jpg" >
  <cl-transformation color-space="keep_cmyk">
  </cl-transformation>
</cl-image>

.NET:

cloudinary.Api.UrlImgUp.Transform(new Transformation().ColorSpace("keep_cmyk")).BuildImageTag("face_top.jpg")

iOS:

imageView.cldSetImage(cloudinary.createUrl().setTransformation(CLDTransformation().setColorSpace("keep_cmyk")).generate("face_top.jpg")!, cloudinary: cloudinary)

Android:

MediaManager.get().url().transformation(new Transformation().colorSpace("keep_cmyk")).generate("face_top.jpg");

Kotlin:

cloudinary.image {
publicId("face_top.jpg")
delivery(Delivery.colorSpace(ColorSpace.keepCmyk()))
}.generate()

Retain the CMYK color space when generating a derived image

d_<image asset>

Specifies a backup placeholder image to be delivered in the case that the actual requested delivery image or social media picture does not exist. Any requested transformations are applied on the placeholder image as well.

Learn more: Using a default image placeholder

Value	Type	Description
image asset	string	Required. The public ID of the placeholder image plus the file extension. Specify folders using colon notation.

Example

Return the image with public ID docs/placeholders/samples/avatar as a PNG if the requested image in the URL non_existing_id does not exist (d_docs:placeholders:samples:avatar.png).

URL Ruby PHP Python Node.js Java JS jQuery React Vue.js Angular .NET iOS Android Kotlin All

URL:

https://res.cloudinary.com/demo/image/upload/d_docs:placeholders:samples:avatar.png/non_existing_id.png

Ruby:

cl_image_tag("non_existing_id.png", :default_image=>"docs:placeholders:samples:avatar.png")

PHP (cloudinary_php v1.x (legacy)):

cl_image_tag("non_existing_id.png", array("default_image"=>"docs:placeholders:samples:avatar.png"))

Library:

PHP (cloudinary_php v2.x):

(new ImageTag('non_existing_id.png'))
  ->delivery(Delivery::defaultImage('docs:placeholders:samples:avatar.png'));

Library:

Python:

CloudinaryImage("non_existing_id.png").image(default_image="docs:placeholders:samples:avatar.png")

Node.js:

cloudinary.image("non_existing_id.png", {default_image: "docs:placeholders:samples:avatar.png"})

Java:

cloudinary.url().transformation(new Transformation().defaultImage("docs:placeholders:samples:avatar.png")).imageTag("non_existing_id.png");

JS:

cloudinary.imageTag('non_existing_id.png', {defaultImage: "docs:placeholders:samples:avatar.png"}).toHtml();

jQuery:

$.cloudinary.image("non_existing_id.png", {default_image: "docs:placeholders:samples:avatar.png"})

React:

<Image publicId="non_existing_id.png" >
  <Transformation defaultImage="docs:placeholders:samples:avatar.png" />
</Image>

Vue.js:

<cld-image public-id="non_existing_id.png" >
  <cld-transformation default-image="docs:placeholders:samples:avatar.png" />
</cld-image>

Angular:

<cl-image public-id="non_existing_id.png" >
  <cl-transformation default-image="docs:placeholders:samples:avatar.png">
  </cl-transformation>
</cl-image>

.NET:

cloudinary.Api.UrlImgUp.Transform(new Transformation().DefaultImage("docs:placeholders:samples:avatar.png")).BuildImageTag("non_existing_id.png")

iOS:

imageView.cldSetImage(cloudinary.createUrl().setTransformation(CLDTransformation().setDefaultImage("docs:placeholders:samples:avatar.png")).generate("non_existing_id.png")!, cloudinary: cloudinary)

Android:

MediaManager.get().url().transformation(new Transformation().defaultImage("docs:placeholders:samples:avatar.png")).generate("non_existing_id.png");

Kotlin:

cloudinary.image {
publicId("non_existing_id.png")
delivery(Delivery.defaultImage("docs:placeholders:samples:avatar.png"))
}.generate()

dl_<time value>

Controls the time delay between the frames of a delivered animated image. (The source asset can be an image or a video.)

Value	Type	Description
time	integer	Required. The delay in milliseconds between frames.

Related flag: fl_animated

Example

Convert a video to an animated image, and apply a delay of 200 milliseconds between frames (dl_200).

URL Ruby PHP Python Node.js Java JS jQuery React Vue.js Angular .NET iOS Android Kotlin All

URL:

https://res.cloudinary.com/demo/video/upload/dl_200/dog.gif

Ruby:

cl_image_tag("dog.gif", :delay=>"200", :resource_type=>"video")

PHP (cloudinary_php v1.x (legacy)):

cl_image_tag("dog.gif", array("delay"=>"200", "resource_type"=>"video"))

Library:

PHP (cloudinary_php v2.x):

(new ImageTag('dog.gif'))
  ->animated(Animated::edit()->delay(200))
  ->assetType(AssetType::VIDEO);

Library:

Python:

CloudinaryVideo("dog.gif").image(delay="200")

Node.js:

cloudinary.image("dog.gif", {delay: "200", resource_type: "video"})

Java:

cloudinary.url().transformation(new Transformation().delay("200")).resourceType("video").imageTag("dog.gif");

JS:

cloudinary.videoTag('dog.gif', {delay: "200"}).toHtml();

jQuery:

$.cloudinary.image("dog.gif", {delay: "200", resource_type: "video"})

React:

<Video publicId="dog.gif" resourceType="video">
  <Transformation delay="200" />
</Video>

Vue.js:

<cld-video public-id="dog.gif" resource-type="video">
  <cld-transformation delay="200" />
</cld-video>

Angular:

<cl-video public-id="dog.gif" resource-type="video">
  <cl-transformation delay="200">
  </cl-transformation>
</cl-video>

.NET:

cloudinary.Api.UrlVideoUp.Transform(new Transformation().Delay("200")).BuildImageTag("dog.gif")

iOS:

cloudinary.createUrl().setResourceType("video").setTransformation(CLDTransformation().setDelay("200")).generate("dog.gif")

Android:

MediaManager.get().url().transformation(new Transformation().delay("200")).resourceType("video").generate("dog.gif");

Kotlin:

cloudinary.video {
publicId("dog.gif")
animated(Animated.edit() {
delay(200)
})
assetType("video")
}.generate()

Deliver an animated image based on a video with a delay between frames of 200 milliseconds

dn_<dots per inch>

Controls the density to use when delivering an image or when converting a vector file such as a PDF or EPS document to a web image delivery format.

For web image formats: By default, if an image does not contain resolution information in its embedded metadata, Cloudinary normalizes any derived images for web optimization purposes and delivers them at 150 dpi. Controlling the dpi can be useful when generating a derived image intended for printing.
Tip
You can take advantage of the idn (initial density) value to automatically set the density of your image to the (pre-normalized) initial density of the original image (for example, dn_idn). This value is taken from the original image's metadata.
For vector files (PDF, EPS, etc.): When you deliver a vector file in a web image format, it is delivered by default at 150 dpi.

See also: Arithmetic expressions

Learn more: Deliver a PDF page as an image

Value	Type	Description
dots per inch	integer	Required. The dpi of the delivered image.

Example

Deliver a JPEG image of the first page of the PDF file with a density of 20 (dn_20):

URL Ruby PHP Python Node.js Java JS jQuery React Vue.js Angular .NET iOS Android Kotlin All

URL:

https://res.cloudinary.com/demo/image/upload/dn_20/multi_page_pdf.jpg

Ruby:

cl_image_tag("multi_page_pdf.jpg", :density=>20)

PHP (cloudinary_php v1.x (legacy)):

cl_image_tag("multi_page_pdf.jpg", array("density"=>20))

Library:

PHP (cloudinary_php v2.x):

(new ImageTag('multi_page_pdf.jpg'))
  ->delivery(Delivery::density(20));

Library:

Python:

CloudinaryImage("multi_page_pdf.jpg").image(density=20)

Node.js:

cloudinary.image("multi_page_pdf.jpg", {density: 20})

Java:

cloudinary.url().transformation(new Transformation().density(20)).imageTag("multi_page_pdf.jpg");

JS:

cloudinary.imageTag('multi_page_pdf.jpg', {density: 20}).toHtml();

jQuery:

$.cloudinary.image("multi_page_pdf.jpg", {density: 20})

React:

<Image publicId="multi_page_pdf.jpg" >
  <Transformation density="20" />
</Image>

Vue.js:

<cld-image public-id="multi_page_pdf.jpg" >
  <cld-transformation density="20" />
</cld-image>

Angular:

<cl-image public-id="multi_page_pdf.jpg" >
  <cl-transformation density="20">
  </cl-transformation>
</cl-image>

.NET:

cloudinary.Api.UrlImgUp.Transform(new Transformation().Density(20)).BuildImageTag("multi_page_pdf.jpg")

iOS:

imageView.cldSetImage(cloudinary.createUrl().setTransformation(CLDTransformation().setDensity(20)).generate("multi_page_pdf.jpg")!, cloudinary: cloudinary)

Android:

MediaManager.get().url().transformation(new Transformation().density(20)).generate("multi_page_pdf.jpg");

Kotlin:

cloudinary.image {
publicId("multi_page_pdf.jpg")
delivery(Delivery.density(20))
}.generate()

Sets the device pixel ratio (DPR) for the delivered image or video using a specified value or automatically based on the requesting device.

dpr_<pixel ratio>

Delivers the image or video in the specified device pixel ratio.

Important

When delivering at a DPR value larger than 1, ensure that you also set the desired final display dimensions in your image or video tag. For example, if you set h_300,dpr_2 in your delivery URL, you should also set height=300 in your image tag. Otherwise, the image will be delivered at 2.0 x the requested dimensions (a height of 600px in this example).

Learn more: Set Device Pixel Ratio (DPR)

See also: Arithmetic expressions

Value	Type	Description
pixel ratio	float	Required. A positive value for the device pixel ratio to use when delivering the image or video.

Example

Deliver the image with a dpr of 2.0 (dpr_2.0).

Note

While the code example below shows only the transformation URL, the image tag for the displayed inline image includes a hard-coded height definition in the image tag, to ensure that the doubled-DPR is still delivered within a display of 150px. If you view just the transformed dpr_2 URL outside the image tag, it displays with a height of 300px.

<img title="Deliver the image with a dpr of 2.0" 
    alt="Deliver the image with a dpr of 2.0" 
    style="margin: 0 auto;display: block" 
    src="https://res.cloudinary.com/demo/image/upload/dpr_2.0,h_150/face_top.jpg"
    height="150" 
>

URL Ruby PHP Python Node.js Java JS jQuery React Vue.js Angular .NET iOS Android Kotlin All

URL:

https://res.cloudinary.com/demo/image/upload/dpr_2.0,h_150/face_top.jpg

Ruby:

cl_image_tag("face_top.jpg", :dpr=>2.0, :height=>150, :crop=>"scale")

PHP (cloudinary_php v1.x (legacy)):

cl_image_tag("face_top.jpg", array("dpr"=>"2.0", "height"=>150, "crop"=>"scale"))

Library:

PHP (cloudinary_php v2.x):

(new ImageTag('face_top.jpg'))
  ->resize(Resize::scale()->height(150))
  ->delivery(Delivery::dpr(2.0));

Library:

Python:

CloudinaryImage("face_top.jpg").image(dpr="2.0", height=150, crop="scale")

Node.js:

cloudinary.image("face_top.jpg", {dpr: "2.0", height: 150, crop: "scale"})

Java:

cloudinary.url().transformation(new Transformation().dpr(2.0).height(150).crop("scale")).imageTag("face_top.jpg");

JS:

cloudinary.imageTag('face_top.jpg', {dpr: "2.0", height: 150, crop: "scale"}).toHtml();

jQuery:

$.cloudinary.image("face_top.jpg", {dpr: "2.0", height: 150, crop: "scale"})

React:

<Image publicId="face_top.jpg" >
  <Transformation dpr="2.0" height="150" crop="scale" />
</Image>

Vue.js:

<cld-image public-id="face_top.jpg" >
  <cld-transformation dpr="2.0" height="150" crop="scale" />
</cld-image>

Angular:

<cl-image public-id="face_top.jpg" >
  <cl-transformation dpr="2.0" height="150" crop="scale">
  </cl-transformation>
</cl-image>

.NET:

cloudinary.Api.UrlImgUp.Transform(new Transformation().Dpr(2.0).Height(150).Crop("scale")).BuildImageTag("face_top.jpg")

iOS:

imageView.cldSetImage(cloudinary.createUrl().setTransformation(CLDTransformation().setDpr(2.0).setHeight(150).setCrop("scale")).generate("face_top.jpg")!, cloudinary: cloudinary)

Android:

MediaManager.get().url().transformation(new Transformation().dpr(2.0).height(150).crop("scale")).generate("face_top.jpg");

Kotlin:

cloudinary.image {
publicId("face_top.jpg")
resize(Resize.scale() {
height(150)
})
delivery(Delivery.dpr(2.0f))
}.generate()

dpr_auto

Delivers the image in a resolution that automatically matches the DPR (Device Pixel Ratio) setting of the requesting device, rounded up to the nearest integer. Only works for certain browsers and when Client-Hints are enabled.

Learn more: Automatic DPR

Example

Deliver the image with a DPR automatically set (dpr_auto).

URL Ruby PHP Python Node.js Java JS jQuery React Vue.js Angular .NET iOS Android Kotlin All

URL:

https://res.cloudinary.com/demo/image/upload/dpr_auto,h_150/face_top.jpg

Ruby:

cl_image_tag("face_top.jpg", :dpr=>"auto", :height=>150, :crop=>"scale")

PHP (cloudinary_php v1.x (legacy)):

cl_image_tag("face_top.jpg", array("dpr"=>"auto", "height"=>150, "crop"=>"scale"))

Library:

PHP (cloudinary_php v2.x):

(new ImageTag('face_top.jpg'))
  ->resize(Resize::scale()->height(150))
  ->delivery(Delivery::dpr(Dpr::auto()));

Library:

Python:

CloudinaryImage("face_top.jpg").image(dpr="auto", height=150, crop="scale")

Node.js:

cloudinary.image("face_top.jpg", {dpr: "auto", height: 150, crop: "scale"})

Java:

cloudinary.url().transformation(new Transformation().dpr("auto").height(150).crop("scale")).imageTag("face_top.jpg");

JS:

cloudinary.imageTag('face_top.jpg', {dpr: "auto", height: 150, crop: "scale"}).toHtml();

jQ

Transformation URL API reference