Developers

👋 Discover how Cloudinary helps you build more engaging and performant web and app experiences while making your life easier along the way.

A woman and a golden retriever in the mountains. They're sitting, facing away from the camera while the dog noses the woman. They're surrounded by natural splendor including majestic mountains, puffy clouds, and evergreen-studded hills.
An un-cropped image overlaid with a cropping window showing how it would be cropped by Cloudinary.
An arrow pointing from the original asset to the cropped asset
A woman and a golden retriever in the mountains. They're sitting, facing away from the camera while the dog noses the woman. They're surrounded by natural splendor including majestic mountains, puffy clouds, and evergreen-studded hills.
The same asset cropped using the following settings: Aspect Ratio: 1:2. Crop Mode: Content-Aware.
Images
Videos
Crop Mode
Aspect Ratio
Original
18 MB

We’re showing a resized version of the original asset to avoid slow loading speeds. View the original.

The original asset:
JPEG
135 KB
WebP
135 KB
AVIF
90 KB
JPEG XL
94 KB
The image after being optimized using the following settings: Quality: Auto. Width: 1000px.
Original
18 MB

We’re showing a resized version of the original asset to avoid slow loading speeds. View the original.

The original asset:
JPEG
135 KB
WebP
135 KB
AVIF
90 KB
JPEG XL
94 KB
The image after being optimized using the following settings: Quality: Auto. Width: 1000px.
Images
Videos
Quality
Width
An un-cropped image overlaid with a croppingai window showing how it would be cropped by Cloudinary.
An arrow pointing from the original asset to the cropped asset
The same asset cropped using the following settings: Aspect Ratio: 1:1. Crop Mode: Content-Aware.
Images
Videos
Crop Mode
Aspect Ratio
The original image:
An arrow pointing from the original asset to the transformed asset.
The personalized image:
The original image:
The personalized image:
Product Photos
Backgrounds
Overlays
Duration
Full length video: Surfing Trip
An arrow pointing from the original video to the AI-generated preview.
Duration
A shorter video preview generated by Cloudinary's AI using the following settings: Duration: 15 seconds. Max Clips: 9. Min Clip Length: 1 second.
Videos
Duration
Max Clips
Min Clip Length
URL:
/ar_0.5,c_fill,g_auto,w_433/q_auto/f_auto/hiking_dog_mountain.jpg
cloudinary.image("hiking_dog_mountain.jpg", {transformation: [
  {aspect_ratio: "0.5", gravity: "auto", width: 433, crop: "fill"},
  {quality: "auto"},
  {fetch_format: "auto"}
  ]})
new CloudinaryImage("hiking_dog_mountain.jpg")
  .resize(
    fill()
      .width(433)
      .aspectRatio(0.5)
      .gravity(autoGravity())
  )
  .delivery(quality(auto()))
  .delivery(format(auto()));
new CloudinaryImage("hiking_dog_mountain.jpg")
  .resize(
    fill()
      .width(433)
      .aspectRatio(0.5)
      .gravity(autoGravity())
  )
  .delivery(quality(auto()))
  .delivery(format(auto()));
new CloudinaryImage("hiking_dog_mountain.jpg")
  .resize(
    fill()
      .width(433)
      .aspectRatio(0.5)
      .gravity(autoGravity())
  )
  .delivery(quality(auto()))
  .delivery(format(auto()));
new CloudinaryImage("hiking_dog_mountain.jpg")
  .resize(
    fill()
      .width(433)
      .aspectRatio(0.5)
      .gravity(autoGravity())
  )
  .delivery(quality(auto()))
  .delivery(format(auto()));
CloudinaryImage("hiking_dog_mountain.jpg").image(transformation=[
  {'aspect_ratio': "0.5", 'gravity': "auto", 'width': 433, 'crop': "fill"},
  {'quality': "auto"},
  {'fetch_format': "auto"}
  ])
(new ImageTag('hiking_dog_mountain.jpg'))
	->resize(Resize::fill()->width(433)
->aspectRatio(0.5)
	->gravity(
	Gravity::autoGravity())
	)
	->delivery(Delivery::quality(
	Quality::auto()))
	->delivery(Delivery::format(
	Format::auto()));
cloudinary.url().transformation(new Transformation()
  .aspectRatio("0.5").gravity("auto").width(433).crop("fill").chain()
  .quality("auto").chain()
  .fetchFormat("auto")).imageTag("hiking_dog_mountain.jpg");
cl_image_tag("hiking_dog_mountain.jpg", transformation: [
  {aspect_ratio: "0.5", gravity: "auto", width: 433, crop: "fill"},
  {quality: "auto"},
  {fetch_format: "auto"}
  ])
cloudinary.Api.UrlImgUp.Transform(new Transformation()
  .AspectRatio("0.5").Gravity("auto").Width(433).Crop("fill").Chain()
  .Quality("auto").Chain()
  .FetchFormat("auto")).BuildImageTag("hiking_dog_mountain.jpg")
cloudinary.image('hiking_dog_mountain.jpg').transformation(Transformation()
	.resize(Resize.fill().width(433)
.aspectRatio(0.5)
	.gravity(
	Gravity.autoGravity())
	)
	.delivery(Delivery.quality(
	Quality.auto()))
	.delivery(Delivery.format(
	Format.auto())));
imageView.cldSetImage(cloudinary.createUrl().setTransformation(CLDTransformation()
  .setAspectRatio("0.5").setGravity("auto").setWidth(433).setCrop("fill").chain()
  .setQuality("auto").chain()
  .setFetchFormat("auto")).generate("hiking_dog_mountain.jpg")!, cloudinary: cloudinary)
MediaManager.get().url().transformation(new Transformation()
  .aspectRatio("0.5").gravity("auto").width(433).crop("fill").chain()
  .quality("auto").chain()
  .fetchFormat("auto")).generate("hiking_dog_mountain.jpg");
cloudinary.image('hiking_dog_mountain.jpg').transformation(Transformation()
	.resize(Resize.fill().width(433)
.aspectRatio(0.5)
	.gravity(
	Gravity.autoGravity())
	)
	.delivery(Delivery.quality(
	Quality.auto()))
	.delivery(Delivery.format(
	Format.auto())));
cloudinary.image {
	publicId("hiking_dog_mountain.jpg")
	 resize(Resize.fill() { width(433)
 aspectRatio(0.5F)
	 gravity(
	Gravity.autoGravity())
	 })
	 delivery(Delivery.quality(
	Quality.auto()))
	 delivery(Delivery.format(
	Format.auto())) 
}.generate()
new CloudinaryImage("hiking_dog_mountain.jpg")
  .resize(
    fill()
      .width(433)
      .aspectRatio(0.5)
      .gravity(autoGravity())
  )
  .delivery(quality(auto()))
  .delivery(format(auto()));

Popular With Developers

Optimization

Optimization

Responsive image

Responsive

Video management

Video

Personalization

Personalization

AI Icon

Gen AI

Mobile icon

Mobile

Circles

Developer SDKs

Whatever your tech stack, Cloudinary has you covered with a huge selection of SDKs in all your favorite backend, frontend, and mobile languages and frameworks.

VIEW MORE SDKs →

Node.js
Node.js
 React
React
 NEXT.js
NEXT.js
 JavaScript
JavaScript
 Python
Python
 PHP
PHP
 Astro
Astro
 Java
Java
 .NET
.NET
 Rails
Rails
 iOS
iOS
 Android
Android

Documentation

Check out our extensive developer documentation for quick starts, in-depth feature guides, comprehensive references, code explorers, video tutorials, and more!

Recommended Topics

Image Transformations

IMAGE TRANSFORMATIONS →

Media Optimization

MEDIA OPTIMIZATION →

References

API REFERENCES →

Product Gallery Widget

CLIENT-SIDE WIDGETS →

Platform Integration

PLATFORM INTEGRATIONS →

Code Explorer

CODE EXPLORERS & DEMOS →

EXPLORE DOCUMENTATION

Didn’t Find What You’re Looking For?

Search our extensive documentation to find answers to all your questions.

Ready to Start Using Cloudinary?

Sign up for our free plan and start creating stunning visual experiences in minutes.

SIGN UP FOR FREE