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"
/>

• Expand Snippet
• Collapse Snippet

Tip

The Cloudinary AI Background Removal add-on is required to use this feature.

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"
/>

• Expand Snippet
• Collapse Snippet

Image Background

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

Tip

The Generative AI Background Replace feature can use AI to replace the background with an image based on a prompt, potentially resulting in better results!

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

• Expand Snippet
• Collapse Snippet

Cropping & Resizing

Cropping

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

Note

By default, CldImage uses a gravity of auto, meaning the crop will automatically position the subject in the center of the resulting image.

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

• Expand Snippet
• Collapse Snippet

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"
/>

• Expand Snippet
• Collapse Snippet

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"
/>

• Expand Snippet
• Collapse Snippet

Tip

The generative fill transformation is currently in Beta. Learn more.

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"
/>

• Expand Snippet
• Collapse Snippet

Tip

The generative recolor transformation is currently in Beta. Learn more.

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"
/>

• Expand Snippet
• Collapse Snippet

Tip

The generative remove transformation is currently in Beta. Learn more.

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"
/>

• Expand Snippet
• Collapse Snippet

Tip

The generative replace transformation is currently in Beta. Learn more.

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"
/>

• Expand Snippet
• Collapse Snippet

Tip

The generative replace background transformation is currently in Beta. Learn more.

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"
/>

• Expand Snippet
• Collapse Snippet

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"
/>

• Expand Snippet
• Collapse Snippet

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"
/>

• Expand Snippet
• Collapse Snippet

Pixelate

pixelate: Applies a pixelation effect.

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

• Expand Snippet
• Collapse Snippet

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=""
/>

• Expand Snippet
• Collapse Snippet

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"
/>

• Expand Snippet
• Collapse Snippet

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"
/>

• Expand Snippet
• Collapse Snippet

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"
/>

• Expand Snippet
• Collapse Snippet

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"
/>

• Expand Snippet
• Collapse Snippet

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"
/>

• Expand Snippet
• Collapse Snippet

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"
/>

• Expand Snippet
• Collapse Snippet

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"
/>

• Expand Snippet
• Collapse Snippet

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"
/>

• Expand Snippet
• Collapse Snippet

More Examples

Find more examples on Social Card Templates.