# Image Per Instance workflows

> Step-by-step Image Per Instance recipes in Blender: separate objects, Geometry Nodes instances, arrays, photo walls, card decks and changing images later.

- Page: https://mendboxstudio.com/docs/image-per-instance/workflows
- Updated: 2026-11-16
- Publisher: Mendbox Studio (Dynamic Flower Unipessoal LDA, Portugal)

Every recipe starts the same way: open the sidebar with **N** and go to the **Image Per Instance** tab. Names of controls are explained in the [panel reference](https://mendboxstudio.com/docs/image-per-instance/panel).

## Different images on separate objects

Use this for frames on a wall, book covers or cards that are individual objects.

1. Put your images in one folder, named so they sort the way you want (`01.jpg`, `02.jpg` and so on). Sorting is natural, so `img2` comes before `img10`.
2. Set **Image Folder** to that folder and pick a **Tile Size**.
3. Set **Tile Shape** to the shape of your objects, for example 2 : 3 for book covers, and **Fit** to Fill (crop) if you do not want distortion.
4. Press **Build Atlas**. The label shows "Atlas: N images".
5. Select the mesh objects and press **Apply To Selected Objects**. Objects are taken in name order and get image 1, 2, 3 and so on.

Objects need a UV map that fills the 0 to 1 square (a plane or an unwrapped cover does). If they have no UVs, open **Material** and set **Mapping** to Front, Top or Side first.

## Different images on Geometry Nodes instances

Use this for Instance on Points scatters and collection instances.

1. Build the atlas as above.
2. Make the object that carries your Geometry Nodes modifier the **active** object. It must be a mesh.
3. Press **Add To Instances (Geometry Nodes)**.
4. Read the message at the bottom of Blender: it names the objects that received the material. These are the instanced source objects the add-on found through Object Info and Collection Info nodes, including nested groups.
5. If the message says no instanced source was found, select the source objects in addition to the host, keep the host active, and press the button again.

The add-on puts the **IPI Assign Index** modifier last in the host's modifier stack. It stores an image index on every instance, and the material reads it.

## Arrays and the Array modifier

1. Build the atlas.
2. Make the object with the Array modifier active.
3. Press **Add To Instances (Geometry Nodes)**.
4. If the array source is an object, it is found automatically. If not, select the source and press the button again.
5. To spread images differently, set **Order** to **Shuffle**, change **Seed**, and press the button again.

The modifier cycles through the images: with 12 images and 40 instances, the pattern repeats after 12.

![Blender with 12 numbered instances, each showing its own image, and the Image Per Instance panel in the sidebar](https://mendboxstudio.com/media/ipi-panel-instances.jpg)

## A photo wall or a card deck

1. Model one frame or card, with a UV map, as the source object. Give it extra material slots for edges or a frame if you like: only slot 1 receives the image.
2. Set **Tile Shape** to the card shape (for example 2 : 3) and **Fit** to Fill (crop) or Fit (bars).
3. If you use Fit (bars), set **Bar Colour**. To make the bars transparent, switch on **Use Image Alpha** under **Material**.
4. Press **Build Atlas**.
5. Scatter or array the card, then press **Add To Instances (Geometry Nodes)** on the host.
6. For a screen wall, switch on **Emissive (screen)** under **Material** and raise **Strength**.
7. For a card deck where you want the images to look random, set **Order** to **Shuffle**. Under **Random Variation**, add a little Hue or Brightness, and tick **Flip X** if mirrored images suit the look.

## Putting a specific image on a specific object

1. Build the atlas.
2. Select one or more objects. Open **Choose Images Yourself**.
3. Type a file name in the search field, or set **Image Number**.
4. Press **Assign Image To Selected**.

For many objects, name them after the files (an object `poster_cat` for `cat.png`), select them all and press **Match By Object Name**. The message tells you how many matched and lists the first few without a match.

## Changing the images later

1. Add, remove or rename images in the folder. Replace images by dropping new files in.
2. Press **Build Atlas** again. It replaces the atlas and keeps each object's picture by file name. If you removed files, objects that pointed past the end wrap around to a valid image.
3. Changes to **Material**, **Animate** and **Random Variation** apply immediately, with no second button.
4. Changes to **Seed** or **Order** need another press of **Apply To Selected Objects** or **Add To Instances (Geometry Nodes)**.
5. To change **Tile Size**, **Tile Shape**, **Fit** or **Padding**, press **Build Atlas** again.

## Animating through the images

1. Build the atlas and apply the images as usual.
2. Open **Animate**, tick the box in its header, and set **Frames Per Image**.
3. Play the timeline. Every object steps to the next image after that many frames, starting from its own image and wrapping around at the last one.

## Related

- Product page: [Image Per Instance](https://mendboxstudio.com/addons/image-per-instance)
- [Troubleshooting](https://mendboxstudio.com/docs/image-per-instance/troubleshooting)
- Guide: [different image per instance in Blender](https://mendboxstudio.com/guides/different-image-per-instance)

---
Source: https://mendboxstudio.com/docs/image-per-instance/workflows
