Image & Video APIs

Create image collages

Last updated: Mar-31-2026

Overview

Important
The Image Collage feature using the create_collage method will be deprecated as of September 16, 2025, and will no longer function after that date. Be sure to remove it from any production code.

You can continue creating collages using overlays.

Image collages are composed of several different images, combined together in a specific layout.

You can programmatically create image collages by combining assets that you've already uploaded to your Cloudinary storage. You can specify spacing and colors, and you can choose the composition of the overall collage.

This collage is composed of four images in one row, with black spacing between each:

Fashion collage

Note
Any images that you want to use in the collage must be publicly accessible.

Create collages using overlays

Another way to create collages with Cloudinary is to use overlays. By specifying the positions of the images to be adjacent to one another, rather than overlaying images on top of each other, you can concatenate or append images side by side or vertically.

For full examples and instructions — including a simple two-image arrangement with hard-coded offsets and a multi-image collage using variables — see Placing images side by side, vertically, or in a collage on the image layers page.

✔️ Feedback sent!

Rate this page:

one star two stars three stars four stars five stars