Image Per Instance workflows
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.
Different images on separate objects
Use this for frames on a wall, book covers or cards that are individual objects.
- Put your images in one folder, named so they sort the way you want (
01.jpg,02.jpgand so on). Sorting is natural, soimg2comes beforeimg10. - Set Image Folder to that folder and pick a Tile Size.
- 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.
- Press Build Atlas. The label shows "Atlas: N images".
- 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.
- Build the atlas as above.
- Make the object that carries your Geometry Nodes modifier the active object. It must be a mesh.
- Press Add To Instances (Geometry Nodes).
- 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.
- 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
- Build the atlas.
- Make the object with the Array modifier active.
- Press Add To Instances (Geometry Nodes).
- If the array source is an object, it is found automatically. If not, select the source and press the button again.
- 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.

A photo wall or a card deck
- 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.
- Set Tile Shape to the card shape (for example 2 : 3) and Fit to Fill (crop) or Fit (bars).
- If you use Fit (bars), set Bar Colour. To make the bars transparent, switch on Use Image Alpha under Material.
- Press Build Atlas.
- Scatter or array the card, then press Add To Instances (Geometry Nodes) on the host.
- For a screen wall, switch on Emissive (screen) under Material and raise Strength.
- 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
- Build the atlas.
- Select one or more objects. Open Choose Images Yourself.
- Type a file name in the search field, or set Image Number.
- 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
- Add, remove or rename images in the folder. Replace images by dropping new files in.
- 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.
- Changes to Material, Animate and Random Variation apply immediately, with no second button.
- Changes to Seed or Order need another press of Apply To Selected Objects or Add To Instances (Geometry Nodes).
- To change Tile Size, Tile Shape, Fit or Padding, press Build Atlas again.
Animating through the images
- Build the atlas and apply the images as usual.
- Open Animate, tick the box in its header, and set Frames Per Image.
- 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
- Troubleshooting
- Guide: different image per instance in Blender