Skip to content

CldImage Examples

Basic Transformations

Cloudinary supports a wide variety of powerful transformations that allow you to not only deliver, but easily edit and build new images on the fly.

Background Removal

Remove Background

removeBackground: Removes the background of the image using AI

---
import { CldImage } from 'astro-cloudinary';
---
<CldImage
src="<Public ID>"
width="<Width>"
height="<Height>"
removeBackground
alt=""
sizes="100vw"
/>
Color Background

background: Specifies a color to use as a background.

---
import { CldImage } from 'astro-cloudinary';
---
<CldImage
src="<Public ID>"
width="<Width>"
height="<Height>"
removeBackground
background="blueviolet"
alt=""
sizes="100vw"
/>
Image Background

underlay: Specifies a public ID to use as an underlaying image.

---
import { CldImage } from 'astro-cloudinary';
---
<CldImage
src="<Public ID>"
width="<Width>"
height="<Height>"
removeBackground
underlay="<Public ID>"
alt=""
sizes="100vw"
/>

Cropping & Resizing

Cropping

crop: Specifies the mode to use when cropping an image based on the given dimensions.

---
import { CldImage } from 'astro-cloudinary';
---
<CldImage
src="<Public ID>"
width="<Width>"
height="<Height>"
crop="fill"
alt=""
sizes="100vw"
/>

Cloudinary additionally supports dynamic crop modes like thumb that may provide a different result based on the given width and height. To help provide more options for controlling cropping images, you can specify and object or array of objects.

For instance, to crop the original source image, which will then later resize it to the initial width and height, you can use:

---
import { CldImage } from 'astro-cloudinary';
---
<CldImage
src="<Public ID>"
width="<Width>"
height="<Height>"
crop={{
width: 600,
height: 600,
type: 'thumb',
source: true
}}
alt=""
sizes="100vw"
/>

Which will provide a consistent crop for all rendered sizes.

Learn more about cropping and responsive images.

Generative Fill

fillBackground: Fills the background of an image using Generative AI

---
import { CldImage } from 'astro-cloudinary';
---
<CldImage
src="<Public ID>"
width="<Width>"
height="<Height>"
crop="pad" // Returns the given size with padding
fillBackground
alt=""
sizes="100vw"
/>

Generative Recolor

recolor: Recolors an object in an image using Generative AI

---
import { CldImage } from 'astro-cloudinary';
---
<CldImage
src="<Public ID>"
width="<Width>"
height="<Height>"
crop="fill"
recolor={['<Object>', '<Color>']}
alt=""
sizes="100vw"
/>

Generative Remove

remove: Removes an object in an image using Generative AI

---
import { CldImage } from 'astro-cloudinary';
---
<CldImage
src="<Public ID>"
width="<Width>"
height="<Height>"
remove={{
prompt: '<Object>',
removeShadow: true
}}
alt=""
sizes="100vw"
/>

Generative Replace

replace: Replaces an object in an image using Generative AI

---
import { CldImage } from 'astro-cloudinary';
---
<CldImage
src="<Public ID>"
width="<Width>"
height="<Height>"
replace={['<Object>', '<Object>']}
alt=""
sizes="100vw"
/>

Generative Replace Background

replaceBackground: Replaces the background of an image with an AI-generated background.

---
import { CldImage } from 'astro-cloudinary';
---
<CldImage
src="<Public ID>"
width="<Width>"
height="<Height>"
crop="fill"
replaceBackground="space galaxy"
alt=""
sizes="100vw"
/>

Filters & Effects

Included in the Cloudinary transformations library are different filters and effects that allow you to recolor, improve, fix, and artistically transform your images.

Blur

blur: Applies a blurring filter to an asset.

---
import { CldImage } from 'astro-cloudinary';
---
<CldImage
src="<Public ID>"
width="<Width>"
height="<Height>"
blur="1200"
alt=""
sizes="100vw"
/>

Grayscale

grayscale: Converts an image to grayscale (multiple shades of gray).

---
import { CldImage } from 'astro-cloudinary';
---
<CldImage
src="<Public ID>"
width="<Width>"
height="<Height>"
grayscale
alt=""
sizes="100vw"
/>

Opacity

opacity: Controls the opacity level of an image.

---
import { CldImage } from 'astro-cloudinary';
---
<CldImage
src="<Public ID>"
width="<Width>"
height="<Height>"
opacity="50"
alt=""
sizes="100vw"
/>

Pixelate

pixelate: Applies a pixelation effect.

---
import { CldImage } from 'astro-cloudinary';
---
<CldImage
src="<Public ID>"
width="<Width>"
height="<Height>"
pixelate
alt=""
sizes="100vw"
/>

Tint

tint: Blends an image with one or more tint colors.

---
import { CldImage } from 'astro-cloudinary';
---
<CldImage
src="<Public ID>"
width="<Width>"
height="<Height>"
sizes="100vw"
tint="equalize:80:blue:blueviolet"
alt=""
/>

Chaining Multiple Effects

effects: An array of objects the configure the effects to apply to an image.

---
import { CldImage } from 'astro-cloudinary';
---
<CldImage
src="<Public ID>"
width="<Width>"
height="<Height>"
effects={[
{
background: 'green'
},
{
gradientFade: true
},
{
gradientFade: 'symetric,x_0.5'
}
]}
alt=""
sizes="100vw"
/>

More Filters & Effects

Learn about what other filters and effects are supported on CldImage Configuration.

Image Overlays

Image overlays allow you to place one or multiple images on top of another image.

Overlay Image by Public ID

overlays: Any array of overlay objects

---
import { CldImage } from 'astro-cloudinary';
---
<CldImage
src="<Public ID>"
width="<Width>"
height="<Height>"
overlays={[{
publicId: "samples/food/fish-vegetables",
position: {
x: 50,
y: 50,
gravity: 'north_east',
},
effects: [{
crop: 'fill',
width: 350,
height: 350,
gravity: 'auto',
border: '5px_solid_yellow'
}]
}]}
alt=""
sizes="100vw"
/>

Overlay Image with Blend Mode

appliedEffects: When configured on an overlay object, allows you to set an effect that applies a blend mode, such as “multiply”

---
import { CldImage } from 'astro-cloudinary';
---
<CldImage
src="<Public ID>"
width="<Width>"
height="<Height>"
overlays={[{
publicId: "samples/animals/cat",
effects: [{
crop: 'fill',
gravity: 'auto',
width: '1.0',
height: '1.0',
}],
flags: ['relative'],
appliedEffects: [{ multiply: true }]
}]}
alt=""
sizes="100vw"
/>

Image Underlays

Image underlays allow you to place one or multiple images behind a base image.

Replace Background with Image

underlay: Public ID of image to use under base image

---
import { CldImage } from 'astro-cloudinary';
---
<CldImage
src="<Public ID>"
width="<Width>"
height="<Height>"
underlay="<Public ID>"
removeBackground
alt=""
sizes="100vw"
/>

Replace Background with Multiple Images

underlays: Array of underlay objects

---
import { CldImage } from 'astro-cloudinary';
---
<CldImage
src="<Public ID>"
width="<Width>"
height="<Height>"
underlays={[
{
publicId: '<Public ID>',
width: '0.5',
height: '1.0',
crop: 'fill',
position: {
gravity: 'north_west'
},
flags: ['relative']
},
{
publicId: '<Public ID>',
width: '0.5',
height: '1.0',
crop: 'fill',
position: {
gravity: 'south_east'
},
flags: ['relative']
},
]}
removeBackground
alt=""
sizes="100vw"
/>

Text Overlays

Text overlays allow you to place text on top of an image.

Adding Custom Text

overlays: Uses overlay objects to add text on top of an image.

---
import { CldImage } from 'astro-cloudinary';
---
<CldImage
src="<Public ID>"
width="<Width>"
height="<Height>"
overlays={[{
position: {
x: 140,
y: 140,
angle: -20,
gravity: 'south_east',
},
text: {
color: 'blueviolet',
fontFamily: 'Source Sans Pro',
fontSize: 280,
fontWeight: 'bold',
textDecoration: 'underline',
letterSpacing: 14,
text: 'Cool Beans'
}
}]}
alt=""
sizes="100vw"
/>

Adding Text with Effects

effects: Applies effects to the overlaid text.

---
import { CldImage } from 'astro-cloudinary';
---
<CldImage
src="<Public ID>"
width="<Width>"
height="<Height>"
overlays={[{
text: {
color: 'white',
fontFamily: 'Source Sans Pro',
fontSize: 400,
fontWeight: 'black',
text: 'Touching Grass'
},
effects: [
{
shear: '40:0',
opacity: 50
}
]
}]}
alt=""
sizes="100vw"
/>

Misc

Video Thumbnail

assetType: Specifies the type of asset to be delivered.

This is handy when wanting to create an image thumbnail from a video, where the asset type would be “video”, yet delivering an image.

---
import { CldImage } from 'astro-cloudinary';
---
<CldImage
src="<Your Video Public ID>"
assetType="video"
width="<Width>"
height="<Height>"
alt=""
sizes="100vw"
/>

More Examples

Find more examples on Social Card Templates.