[{"data":1,"prerenderedAt":2851},["ShallowReactive",2],{"\u002Faddons\u002Fimage-per-instance":3,"\u002Faddons\u002Fimage-per-instance-guides":339,"\u002Faddons\u002Fimage-per-instance-docs":1068},{"id":4,"title":5,"blender":6,"body":7,"buy":314,"description":321,"extension":322,"lite":323,"meta":325,"name":326,"navigation":327,"path":328,"poster":329,"price":275,"problem":330,"rawbody":331,"seo":332,"status":333,"stem":334,"updated":335,"version":336,"video":337,"__hash__":338},"addons\u002Faddons\u002Fimage-per-instance.md","Image Per Instance add-on for Blender","4.2 and newer",{"type":8,"value":9,"toc":302},"minimark",[10,15,19,27,34,38,82,85,89,139,147,151,164,168,220,227,235,239,242,246,266,270],[11,12,14],"h2",{"id":13},"the-problem","The problem",[16,17,18],"p",{},"You have forty picture frames, a shelf of book covers or a wall of cards, and each one needs its own image. In Blender a material points at a single image, and the Image Texture node offers no input that says which picture an individual instance should show. The usual ways out are one material per object, which gets heavy fast, or a hand-built texture atlas with a custom attribute and a pile of math nodes that you have to rebuild every time something changes.",[16,20,21,22,26],{},"Image Per Instance builds that setup for you. You point it at a folder, press ",[23,24,25],"strong",{},"Build Atlas",", and every object, array element or Geometry Nodes instance can show a different image while sharing one material.",[16,28,29],{},[30,31],"img",{"alt":32,"src":33},"Before and after in Blender: the same image on every frame, then a different image on each of the 40 frames","\u002Fmedia\u002Fipi-before-after.jpg",[11,35,37],{"id":36},"what-it-does","What it does",[39,40,41,56,62,72],"ul",{},[42,43,44,46,47,51,52,55],"li",{},[23,45,25],{}," reads every image in a folder, resizes each one into a tile, and packs them into a single atlas image stored inside your .blend file. The atlas is always in natural file-name order (",[48,49,50],"code",{},"img2"," before ",[48,53,54],{},"img10","), so Image Number 3 is always the third file.",[42,57,58,61],{},[23,59,60],{},"Apply To Selected Objects"," gives each selected mesh its own tile. The image index is stored as a custom property on the object.",[42,63,64,67,68,71],{},[23,65,66],{},"Add To Instances (Geometry Nodes)"," is for Instance on Points, the Array modifier and collection instances. It looks through the host's Geometry Nodes for the objects being instanced (Object Info and Collection Info nodes, including nested groups), puts the shared material on them, and adds a modifier called ",[23,69,70],{},"IPI Assign Index"," to the host. That modifier writes an image number onto every instance, and the material reads it.",[42,73,74,77,78,81],{},[23,75,76],{},"Order"," can be \"By file name\" or \"Shuffle\". Shuffle uses every image once before any repeats, and a ",[23,79,80],{},"Seed"," field gives you other arrangements.",[16,83,84],{},"One material, one atlas, and the material is made of ordinary Blender nodes.",[11,86,88],{"id":87},"beyond-the-basics-full-version","Beyond the basics (full version)",[39,90,91,97,115,121,127,133],{},[42,92,93,96],{},[23,94,95],{},"Tile shape and fit:"," pick a tile shape (1:1, 2:3, 3:2, 3:4, 4:3, 16:9, 9:16) and a fit mode (Stretch, Fit with bars in a colour you choose, or Fill with crop) so pictures are not squashed.",[42,98,99,102,103,106,107,110,111,114],{},[23,100,101],{},"Choose images yourself:"," pick an image by number or by name, or use ",[23,104,105],{},"Match By Object Name"," so an object called ",[48,108,109],{},"poster_cat"," shows ",[48,112,113],{},"cat.png",".",[42,116,117,120],{},[23,118,119],{},"Material options:"," use image alpha, make the image glow like a screen, set roughness.",[42,122,123,126],{},[23,124,125],{},"Mapping without UVs:"," project from the front, top or side across the whole object.",[42,128,129,132],{},[23,130,131],{},"Animate:"," every object steps through the images every N frames, each starting at its own image.",[42,134,135,138],{},[23,136,137],{},"Random variation:"," shift hue, saturation and brightness per object, and mirror a random half of the objects.",[16,140,141,142,114],{},"Every control is listed in the ",[143,144,146],"a",{"href":145},"\u002Fdocs\u002Fimage-per-instance\u002Fpanel","panel reference",[11,148,150],{"id":149},"what-you-can-use-it-for","What you can use it for",[16,152,153,154,158,159,163],{},"Book spines and covers, posters, paintings and photo frames, cards and tiles, packaging and props, video-wall panels and billboards, and anything scattered or arrayed with Geometry Nodes. Step-by-step recipes are in the ",[143,155,157],{"href":156},"\u002Fdocs\u002Fimage-per-instance\u002Fworkflows","workflows page",", and the guide ",[143,160,162],{"href":161},"\u002Fguides\u002Fdifferent-image-per-instance","different image per instance in Blender"," shows the manual method first.",[11,165,167],{"id":166},"honest-limits","Honest limits",[39,169,170,180,187,194,201,204,217],{},[42,171,172,173,175,176,114],{},"One atlas per .blend file. Pressing ",[23,174,25],{}," again replaces it, and objects keep their pictures by file name. See ",[143,177,179],{"href":178},"\u002Fdocs\u002Fimage-per-instance\u002Ftroubleshooting#why-did-my-images-change-after-pressing-build-atlas-again","rebuilding the atlas",[42,181,182,183,114],{},"The atlas can be at most 16384 px on each side. For example 256 images at 1024 px fit exactly, 257 do not. See ",[143,184,186],{"href":185},"\u002Fdocs\u002Fimage-per-instance\u002Ftroubleshooting#what-if-the-atlas-is-too-big-limit-16384","the atlas size limit",[42,188,189,190,114],{},"Front, Top and Side mapping projects straight through the object's bounding box from one direction. Faces that turn away from that direction smear the image into streaks, so give such objects a UV map. See ",[143,191,193],{"href":192},"\u002Fdocs\u002Fimage-per-instance\u002Ftroubleshooting#why-do-some-faces-look-streaked-with-front-top-or-side-mapping","streaked faces",[42,195,196,197,114],{},"With few images the Shuffle order can show a visible rhythm. See ",[143,198,200],{"href":199},"\u002Fdocs\u002Fimage-per-instance\u002Ftroubleshooting#why-does-shuffle-look-repetitive","repetitive shuffle",[42,202,203],{},"The image goes on material slot 1 of each object. Other slots stay untouched.",[42,205,206,209,210,212,213,114],{},[23,207,208],{},"Assign Image To Selected"," and ",[23,211,105],{}," work on separate objects, not on Geometry Nodes instances. See ",[143,214,216],{"href":215},"\u002Fdocs\u002Fimage-per-instance\u002Ftroubleshooting#why-does-the-instances-button-say-no-instanced-source-found","no instanced source found",[42,218,219],{},"It is not a replacement for UDIM or texture painting.",[16,221,222,223,114],{},"More cases are covered in ",[143,224,226],{"href":225},"\u002Fdocs\u002Fimage-per-instance\u002Ftroubleshooting","troubleshooting",[16,228,229,230,234],{},"Built and tested by Pavel at Mendbox Studio (",[143,231,233],{"href":232},"\u002Fabout","about",").",[11,236,238],{"id":237},"requirements","Requirements",[16,240,241],{},"Blender 4.2 or newer. The add-on's test scripts run on Blender 4.2.23 LTS, 4.5.14 LTS and 5.2.2 LTS. The add-on is pure Python, needs no internet and no extra software, and is licensed GPL-3.0-or-later.",[11,243,245],{"id":244},"free-lite-version","Free Lite version",[16,247,248,249,209,251,253,254,260,261,265],{},"Image Per Instance Lite is a separate free download. It has ",[23,250,25],{},[23,252,60],{}," for separate objects, with up to 20 images. Instances, Shuffle, fit modes, assign by name, alpha and emission, mapping without UVs, animation and variation are in the full version only. ",[143,255,259],{"href":256,"rel":257},"https:\u002F\u002Fgithub.com\u002Fmendbox\u002Fimage-per-instance-lite",[258],"nofollow","Get Lite on GitHub",", and see the ",[143,262,264],{"href":263},"\u002Fdocs\u002Fimage-per-instance\u002Finstall","install page"," for the differences.",[11,267,269],{"id":268},"how-to-buy","How to buy",[16,271,272,273,276,277,282,283,288,289,292,293,297,298,114],{},"The full version is ",[23,274,275],{},"$12",". Buy it on ",[143,278,281],{"href":279,"rel":280},"https:\u002F\u002Fquadfix.gumroad.com\u002Fl\u002Fimage-per-instance?utm_source=mendboxstudio&utm_medium=addon-page&utm_campaign=image-per-instance",[258],"Gumroad"," or ",[143,284,287],{"href":285,"rel":286},"https:\u002F\u002Fsuperhivemarket.com\u002Fproducts\u002Fimage-per-instance?utm_source=mendboxstudio&utm_medium=addon-page&utm_campaign=image-per-instance",[258],"Superhive",", then install the zip in Blender as described in the ",[143,290,291],{"href":263},"install guide",". The ",[143,294,296],{"href":295},"\u002Fdocs\u002Fimage-per-instance","full documentation"," lists every page, including the ",[143,299,301],{"href":300},"\u002Fdocs\u002Fimage-per-instance\u002Fchangelog","changelog",{"title":303,"searchDepth":304,"depth":304,"links":305},"",2,[306,307,308,309,310,311,312,313],{"id":13,"depth":304,"text":14},{"id":36,"depth":304,"text":37},{"id":87,"depth":304,"text":88},{"id":149,"depth":304,"text":150},{"id":166,"depth":304,"text":167},{"id":237,"depth":304,"text":238},{"id":244,"depth":304,"text":245},{"id":268,"depth":304,"text":269},[315,318],{"label":316,"to":317},"Buy on Gumroad","https:\u002F\u002Fquadfix.gumroad.com\u002Fl\u002Fimage-per-instance",{"label":319,"to":320},"Buy on Superhive","https:\u002F\u002Fsuperhivemarket.com\u002Fproducts\u002Fimage-per-instance","Blender add-on that packs a folder of images into one atlas and gives every object, array element or Geometry Nodes instance its own picture on one material.","md",{"summary":324,"to":256},"Free and open source (GPL). Builds the atlas and puts a different image on separate objects, up to 20 images. No Geometry Nodes instances.",{},"Image Per Instance",true,"\u002Faddons\u002Fimage-per-instance","\u002Fmedia\u002Fipi.jpg","How do I put a different image on every object in Blender?","---\ntitle: \"Image Per Instance add-on for Blender\"\ndescription: \"Blender add-on that packs a folder of images into one atlas and gives every object, array element or Geometry Nodes instance its own picture on one material.\"\nname: \"Image Per Instance\"\nprice: \"$12\"\nstatus: released\nproblem: \"How do I put a different image on every object in Blender?\"\nversion: \"0.2.0\"\nblender: \"4.2 and newer\"\nvideo: \u002Fmedia\u002Fipi.mp4\nposter: \u002Fmedia\u002Fipi.jpg\nbuy:\n  - label: \"Buy on Gumroad\"\n    to: \"https:\u002F\u002Fquadfix.gumroad.com\u002Fl\u002Fimage-per-instance\"\n  - label: \"Buy on Superhive\"\n    to: \"https:\u002F\u002Fsuperhivemarket.com\u002Fproducts\u002Fimage-per-instance\"\nlite:\n  summary: \"Free and open source (GPL). Builds the atlas and puts a different image on separate objects, up to 20 images. No Geometry Nodes instances.\"\n  to: \"https:\u002F\u002Fgithub.com\u002Fmendbox\u002Fimage-per-instance-lite\"\nupdated: 2026-11-16\n---\n\n## The problem\n\nYou have forty picture frames, a shelf of book covers or a wall of cards, and each one needs its own image. In Blender a material points at a single image, and the Image Texture node offers no input that says which picture an individual instance should show. The usual ways out are one material per object, which gets heavy fast, or a hand-built texture atlas with a custom attribute and a pile of math nodes that you have to rebuild every time something changes.\n\nImage Per Instance builds that setup for you. You point it at a folder, press **Build Atlas**, and every object, array element or Geometry Nodes instance can show a different image while sharing one material.\n\n![Before and after in Blender: the same image on every frame, then a different image on each of the 40 frames](\u002Fmedia\u002Fipi-before-after.jpg)\n\n## What it does\n\n- **Build Atlas** reads every image in a folder, resizes each one into a tile, and packs them into a single atlas image stored inside your .blend file. The atlas is always in natural file-name order (`img2` before `img10`), so Image Number 3 is always the third file.\n- **Apply To Selected Objects** gives each selected mesh its own tile. The image index is stored as a custom property on the object.\n- **Add To Instances (Geometry Nodes)** is for Instance on Points, the Array modifier and collection instances. It looks through the host's Geometry Nodes for the objects being instanced (Object Info and Collection Info nodes, including nested groups), puts the shared material on them, and adds a modifier called **IPI Assign Index** to the host. That modifier writes an image number onto every instance, and the material reads it.\n- **Order** can be \"By file name\" or \"Shuffle\". Shuffle uses every image once before any repeats, and a **Seed** field gives you other arrangements.\n\nOne material, one atlas, and the material is made of ordinary Blender nodes.\n\n## Beyond the basics (full version)\n\n- **Tile shape and fit:** pick a tile shape (1:1, 2:3, 3:2, 3:4, 4:3, 16:9, 9:16) and a fit mode (Stretch, Fit with bars in a colour you choose, or Fill with crop) so pictures are not squashed.\n- **Choose images yourself:** pick an image by number or by name, or use **Match By Object Name** so an object called `poster_cat` shows `cat.png`.\n- **Material options:** use image alpha, make the image glow like a screen, set roughness.\n- **Mapping without UVs:** project from the front, top or side across the whole object.\n- **Animate:** every object steps through the images every N frames, each starting at its own image.\n- **Random variation:** shift hue, saturation and brightness per object, and mirror a random half of the objects.\n\nEvery control is listed in the [panel reference](\u002Fdocs\u002Fimage-per-instance\u002Fpanel).\n\n## What you can use it for\n\nBook spines and covers, posters, paintings and photo frames, cards and tiles, packaging and props, video-wall panels and billboards, and anything scattered or arrayed with Geometry Nodes. Step-by-step recipes are in the [workflows page](\u002Fdocs\u002Fimage-per-instance\u002Fworkflows), and the guide [different image per instance in Blender](\u002Fguides\u002Fdifferent-image-per-instance) shows the manual method first.\n\n## Honest limits\n\n- One atlas per .blend file. Pressing **Build Atlas** again replaces it, and objects keep their pictures by file name. See [rebuilding the atlas](\u002Fdocs\u002Fimage-per-instance\u002Ftroubleshooting#why-did-my-images-change-after-pressing-build-atlas-again).\n- The atlas can be at most 16384 px on each side. For example 256 images at 1024 px fit exactly, 257 do not. See [the atlas size limit](\u002Fdocs\u002Fimage-per-instance\u002Ftroubleshooting#what-if-the-atlas-is-too-big-limit-16384).\n- Front, Top and Side mapping projects straight through the object's bounding box from one direction. Faces that turn away from that direction smear the image into streaks, so give such objects a UV map. See [streaked faces](\u002Fdocs\u002Fimage-per-instance\u002Ftroubleshooting#why-do-some-faces-look-streaked-with-front-top-or-side-mapping).\n- With few images the Shuffle order can show a visible rhythm. See [repetitive shuffle](\u002Fdocs\u002Fimage-per-instance\u002Ftroubleshooting#why-does-shuffle-look-repetitive).\n- The image goes on material slot 1 of each object. Other slots stay untouched.\n- **Assign Image To Selected** and **Match By Object Name** work on separate objects, not on Geometry Nodes instances. See [no instanced source found](\u002Fdocs\u002Fimage-per-instance\u002Ftroubleshooting#why-does-the-instances-button-say-no-instanced-source-found).\n- It is not a replacement for UDIM or texture painting.\n\nMore cases are covered in [troubleshooting](\u002Fdocs\u002Fimage-per-instance\u002Ftroubleshooting).\n\nBuilt and tested by Pavel at Mendbox Studio ([about](\u002Fabout)).\n\n## Requirements\n\nBlender 4.2 or newer. The add-on's test scripts run on Blender 4.2.23 LTS, 4.5.14 LTS and 5.2.2 LTS. The add-on is pure Python, needs no internet and no extra software, and is licensed GPL-3.0-or-later.\n\n## Free Lite version\n\nImage Per Instance Lite is a separate free download. It has **Build Atlas** and **Apply To Selected Objects** for separate objects, with up to 20 images. Instances, Shuffle, fit modes, assign by name, alpha and emission, mapping without UVs, animation and variation are in the full version only. [Get Lite on GitHub](https:\u002F\u002Fgithub.com\u002Fmendbox\u002Fimage-per-instance-lite), and see the [install page](\u002Fdocs\u002Fimage-per-instance\u002Finstall) for the differences.\n\n## How to buy\n\nThe full version is **$12**. Buy it on [Gumroad](https:\u002F\u002Fquadfix.gumroad.com\u002Fl\u002Fimage-per-instance?utm_source=mendboxstudio&utm_medium=addon-page&utm_campaign=image-per-instance) or [Superhive](https:\u002F\u002Fsuperhivemarket.com\u002Fproducts\u002Fimage-per-instance?utm_source=mendboxstudio&utm_medium=addon-page&utm_campaign=image-per-instance), then install the zip in Blender as described in the [install guide](\u002Fdocs\u002Fimage-per-instance\u002Finstall). The [full documentation](\u002Fdocs\u002Fimage-per-instance) lists every page, including the [changelog](\u002Fdocs\u002Fimage-per-instance\u002Fchangelog).\n",{"title":5,"description":321},"released","addons\u002Fimage-per-instance","2026-11-16","0.2.0","\u002Fmedia\u002Fipi.mp4","54Wmn5jGdlRjQ-6eDveUyo_uk8jHjm5YvLuKUbAr1rk",[340],{"id":341,"title":342,"addon":343,"body":344,"description":1062,"extension":322,"meta":1063,"navigation":327,"path":161,"poster":329,"rawbody":1064,"seo":1065,"stem":1066,"updated":335,"video":337,"__hash__":1067},"guides\u002Fguides\u002Fdifferent-image-per-instance.md","Different image on each instance in Blender","image-per-instance",{"type":8,"value":345,"toc":1046},[346,349,353,368,371,375,378,410,413,417,420,425,428,443,447,471,599,605,609,626,630,633,682,685,712,715,719,722,790,800,806,810,820,837,840,844,851,854,858,893,897,986,990,998,1001,1035,1042],[16,347,348],{},"Blender has no \"image index per object\" input, so one shared material shows one image everywhere. To give each object or instance its own picture, either use one material per image, or pack all images into one atlas and let each object pick its cell through a number the shader can read (an object custom property, or a named attribute stored on a Geometry Nodes instance). The first is fine for a handful of images. The second is the one that scales to dozens, and I ran every step below in Blender 4.2, 4.5 and 5.2.",[11,350,352],{"id":351},"why-the-obvious-node-setup-only-gives-colours","Why the obvious node setup only gives colours",[16,354,355,356,359,360,363,364,367],{},"The first thing most people try is ",[23,357,358],{},"Object Info",". Its ",[23,361,362],{},"Random"," output is a different number from 0 to 1 for every object, and for every Geometry Nodes instance too. Plug it into a ",[23,365,366],{},"Color Ramp"," and each object gets its own colour.",[16,369,370],{},"That is a colour, not a picture. The Image Texture node loads one image and has no socket for \"which image\". Random into a Color Ramp suits randomised tints and stops there. What you need is a number per object that chooses an image.",[11,372,374],{"id":373},"method-1-one-material-per-image","Method 1: one material per image",[16,376,377],{},"For a handful of pictures this is the simplest thing that works and needs no node maths.",[379,380,381,388,403],"ol",{},[42,382,383,384,387],{},"Select the object and open the ",[23,385,386],{},"Material Properties"," tab.",[42,389,390,391,394,395,398,399,402],{},"Create a material, add an ",[23,392,393],{},"Image Texture"," node, open the picture and connect ",[23,396,397],{},"Color"," to the ",[23,400,401],{},"Base Color"," of the Principled BSDF.",[42,404,405,406,409],{},"Duplicate the object (",[23,407,408],{},"Shift D",") and give the copy the next material, one object per picture.",[16,411,412],{},"It breaks down when pictures multiply: every new one means a new material and a manual assignment. Instances from Instance on Points or the Array modifier share the material of their source, so they cannot get different pictures this way at all.",[11,414,416],{"id":415},"method-2-an-atlas-with-a-uv-offset-per-object","Method 2: an atlas with a UV offset per object",[16,418,419],{},"This is the method that scales. All pictures go into one image laid out in a grid, and the shader shifts the UVs so each object looks at one cell.",[421,422,424],"h3",{"id":423},"make-the-atlas","Make the atlas",[16,426,427],{},"Put your pictures into a grid of equal cells in any image editor, for example 2 columns by 2 rows for four images, and save one image. Cell 0 is bottom-left, cell 1 is to its right, and rows count upward, because UV space starts at the bottom-left.",[16,429,430,431,434,435,438,439,442],{},"Set the Image Texture node's ",[23,432,433],{},"Interpolation"," to ",[23,436,437],{},"Closest"," while you test. With ",[23,440,441],{},"Linear",", neighbouring cells can bleed into each other at the edges, so leave a few pixels of padding between pictures when you switch it back.",[421,444,446],{"id":445},"build-the-shader","Build the shader",[16,448,449,450,453,454,457,458,461,462,464,465,467,468,114],{},"Use an index number ",[48,451,452],{},"i"," from 0 to the number of cells minus one. For a grid with ",[48,455,456],{},"cols"," columns and ",[48,459,460],{},"rows"," rows, the cell column is ",[48,463,452],{}," modulo ",[48,466,456],{}," and the row is ",[48,469,470],{},"floor(i \u002F cols)",[379,472,473,494,519,533,550,574,583],{},[42,474,475,476,479,480,483,484,487,488,434,491,114],{},"Add ",[23,477,478],{},"Texture Coordinate"," and take its ",[23,481,482],{},"UV"," output into a ",[23,485,486],{},"Mapping"," node. Set ",[23,489,490],{},"Type",[23,492,493],{},"Point",[42,495,496,497,434,500,503,504,503,507,510,511,503,514,503,516,518],{},"Set Mapping ",[23,498,499],{},"Scale",[48,501,502],{},"1\u002Fcols",", ",[48,505,506],{},"1\u002Frows",[48,508,509],{},"1",". For the 2 by 2 atlas that is ",[48,512,513],{},"0.5",[48,515,513],{},[48,517,509],{},". This shrinks the UV square to one cell.",[42,520,521,522,525,526,529,530,532],{},"Add a ",[23,523,524],{},"Math"," node set to ",[23,527,528],{},"Floored Modulo"," with the second value ",[48,531,456],{},". This is the column.",[42,534,521,535,525,537,540,541,543,544,525,546,549],{},[23,536,524],{},[23,538,539],{},"Divide"," by ",[48,542,456],{},", then a ",[23,545,524],{},[23,547,548],{},"Floor",". This is the row.",[42,551,552,553,555,556,558,559,562,563,209,566,569,570,573],{},"Divide the column by ",[48,554,456],{}," and the row by ",[48,557,460],{}," with two more ",[23,560,561],{},"Math > Divide"," nodes, and put the results into ",[23,564,565],{},"X",[23,567,568],{},"Y"," of a ",[23,571,572],{},"Combine XYZ"," node.",[42,575,576,577,398,579,582],{},"Connect ",[23,578,572],{},[23,580,581],{},"Location"," input of the Mapping node.",[42,584,585,586,589,590,592,593,595,596,598],{},"Connect Mapping ",[23,587,588],{},"Vector"," to the Image Texture ",[23,591,588],{},", and its ",[23,594,397],{}," to the Principled BSDF ",[23,597,401],{}," (or to an Emission node for a screen).",[16,600,601,602,604],{},"Now the only missing piece is how the index ",[48,603,452],{}," gets to each object.",[421,606,608],{"id":607},"option-a-random-index-from-object-info","Option A: random index from Object Info",[16,610,576,611,614,615,618,619,622,623,625],{},[23,612,613],{},"Object Info > Random"," to a ",[23,616,617],{},"Math > Multiply"," by the number of cells, then to a ",[23,620,621],{},"Math > Floor",", and feed the result into the chain above as ",[48,624,452],{},". In my test, four planes with one shared material got green, blue, blue and red. Random picks repeat, with few objects some pictures may not appear at all, and you cannot choose which object shows what.",[421,627,629],{"id":628},"option-b-a-custom-property-per-object","Option B: a custom property per object",[16,631,632],{},"When you want control, or no repeats:",[379,634,635,657,660],{},[42,636,637,638,641,642,645,646,649,650,653,654,114],{},"Select an object. Open the ",[23,639,640],{},"Object Properties"," tab, ",[23,643,644],{},"Custom Properties"," panel, and press ",[23,647,648],{},"New",". Name it ",[48,651,652],{},"img_index",", type ",[23,655,656],{},"Float",[42,658,659],{},"Type the cell number as the value.",[42,661,662,663,666,667,434,669,209,672,434,675,677,678,681],{},"In the shader add an ",[23,664,665],{},"Attribute"," node, set ",[23,668,490],{},[23,670,671],{},"Object",[23,673,674],{},"Name",[48,676,652],{},", and connect its ",[23,679,680],{},"Fac"," output to the index chain.",[16,683,684],{},"For many objects, set it from the Scripting workspace:",[686,687,691],"pre",{"className":688,"code":689,"language":690,"meta":303,"style":303},"language-python shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","import bpy\nfor i, ob in enumerate(bpy.context.selected_objects):\n    ob[\"img_index\"] = float(i % 4)\n","python",[48,692,693,701,706],{"__ignoreMap":303},[694,695,698],"span",{"class":696,"line":697},"line",1,[694,699,700],{},"import bpy\n",[694,702,703],{"class":696,"line":304},[694,704,705],{},"for i, ob in enumerate(bpy.context.selected_objects):\n",[694,707,709],{"class":696,"line":708},3,[694,710,711],{},"    ob[\"img_index\"] = float(i % 4)\n",[16,713,714],{},"In my test, planes given 3, 0, 2 and 1 showed the cells 3, 0, 2 and 1 of the atlas.",[421,716,718],{"id":717},"option-c-geometry-nodes-instances","Option C: Geometry Nodes instances",[16,720,721],{},"Instances do not have custom properties, but they can carry a named attribute.",[379,723,724,746,769],{},[42,725,726,727,730,731,487,734,434,737,209,739,434,742,745],{},"In your Geometry Nodes tree, after ",[23,728,729],{},"Instance on Points",", add a ",[23,732,733],{},"Store Named Attribute",[23,735,736],{},"Data Type",[23,738,656],{},[23,740,741],{},"Domain",[23,743,744],{},"Instance",". The domain is the thing people miss, because the default is Point.",[42,747,748,749,434,751,753,754,757,758,760,761,764,765,768],{},"Set the ",[23,750,674],{},[48,752,652],{},", and connect ",[23,755,756],{},"Index"," (from the ",[23,759,756],{}," node) to ",[23,762,763],{},"Value",". Use a ",[23,766,767],{},"Math > Modulo"," if you have more instances than images.",[42,770,771,772,774,775,777,778,209,781,783,784,786,787,789],{},"In the shader, add an ",[23,773,665],{}," node with ",[23,776,490],{}," set to ",[23,779,780],{},"Instancer",[23,782,674],{}," ",[48,785,652],{},", and feed its ",[23,788,680],{}," into the same index chain.",[16,791,792,793,796,797,799],{},"The instanced geometry must use that material (a ",[23,794,795],{},"Set Material"," node before Instance on Points). My four instances showed four different cells. For random picks only, ",[23,798,613],{}," also differs per instance, so Option A works on instances without any attribute.",[801,802,803],"blockquote",{},[16,804,805],{},"The Index node follows the order the points were generated, which for a Grid is column by column in my test. To put a specific picture at a specific place, check the order first.",[11,807,809],{"id":808},"method-3-udim-tiles","Method 3: UDIM tiles",[16,811,812,813,209,816,819],{},"A UDIM image has numbered tiles. Tile 1001 is the UV square from 0 to 1, tile 1002 the next square to the right, and so on. You can load files named ",[48,814,815],{},"name.1001.png",[48,817,818],{},"name.1002.png"," as one tiled image.",[16,821,822,823,825,826,829,830,832,833,836],{},"Each object still has to look at its own tile, so the shader is the same job as the atlas: a ",[23,824,486],{}," node whose ",[23,827,828],{},"Location X"," comes from an ",[23,831,665],{}," node. I tested it. With a custom property ",[48,834,835],{},"udim_u"," of 0 or 1 on four planes, they showed tile 1001 and tile 1002 alternately.",[16,838,839],{},"UDIM does not save work here. You still need an index per object, plus one file per tile and the naming convention. It suits one model with several high-resolution texture areas, not a hundred different posters.",[11,841,843],{"id":842},"method-4-an-image-sequence-with-a-frame-offset","Method 4: an image sequence with a frame offset",[16,845,846,847,850],{},"An image sequence is a numbered series of files that Blender steps through by frame. Set the Image Texture node to a sequence and use its ",[23,848,849],{},"Offset"," to shift where each material starts.",[16,852,853],{},"The offset belongs to the node, so every object with that material shares it. I rendered three planes with three materials at offsets 0, 1 and 2 on frame 1 and got three different pictures. That works, but it is Method 1 again: one material per offset. I did not find a stock way to drive the offset per object from one material, so for a different picture per object an atlas is easier.",[11,855,857],{"id":856},"what-goes-wrong","What goes wrong",[39,859,860,866,872,878,887],{},[42,861,862,865],{},[23,863,864],{},"Pictures look squashed."," A portrait picture in a square cell is stretched. Make the cells the shape of your pictures.",[42,867,868,871],{},[23,869,870],{},"Seams show neighbouring pictures."," Linear filtering reads across cell borders. Leave padding or inset the UVs a pixel or two.",[42,873,874,877],{},[23,875,876],{},"All instances show the same cell."," The named attribute is stored on the Point domain, not Instance, or the shader Attribute node is set to Geometry instead of Instancer.",[42,879,880,883,884,886],{},[23,881,882],{},"Every object shows the first picture."," The Attribute node finds no attribute with that name and returns 0. Check that ",[48,885,652],{}," is spelled the same in the property or Store Named Attribute and in the Attribute node. I tested a misspelled name and a missing property in 4.2.23 and 5.2.2, and all four planes showed cell 0.",[42,888,889,890,114],{},"More fixes are on the ",[143,891,892],{"href":225},"Image Per Instance troubleshooting page",[11,894,896],{"id":895},"which-method-fits","Which method fits",[898,899,900,916],"table",{},[901,902,903],"thead",{},[904,905,906,910,913],"tr",{},[907,908,909],"th",{},"Method",[907,911,912],{},"Good for",[907,914,915],{},"Breaks when",[917,918,919,931,942,953,964,975],"tbody",{},[904,920,921,925,928],{},[922,923,924],"td",{},"One material per image",[922,926,927],{},"Up to about ten pictures",[922,929,930],{},"Instances, many pictures, later changes",[904,932,933,936,939],{},[922,934,935],{},"Atlas + Object Info Random",[922,937,938],{},"Random look on many objects",[922,940,941],{},"You need a chosen or even spread",[904,943,944,947,950],{},[922,945,946],{},"Atlas + custom property",[922,948,949],{},"Chosen picture per separate object",[922,951,952],{},"Instances, since they have no custom properties",[904,954,955,958,961],{},[922,956,957],{},"Atlas + Store Named Attribute",[922,959,960],{},"Array and Instance on Points",[922,962,963],{},"Needs a Geometry Nodes tree and a shader chain",[904,965,966,969,972],{},[922,967,968],{},"UDIM",[922,970,971],{},"One model with several texture areas",[922,973,974],{},"Many different pictures",[904,976,977,980,983],{},[922,978,979],{},"Image sequence",[922,981,982],{},"Animated or numbered pictures",[922,984,985],{},"Per-object offset on one material",[11,987,989],{"id":988},"faster-with-image-per-instance","Faster with Image Per Instance",[16,991,992,994,995,997],{},[143,993,326],{"href":328}," builds the atlas method for you, using the same technique as above. It stores an ",[48,996,652],{}," value (an object custom property on separate objects, and a Store Named Attribute on the Instance domain on instances), and one shared material reads it with an Attribute node. That is the setup you just built by hand.",[16,999,1000],{},"What it does in practice:",[379,1002,1003,1015,1023],{},[42,1004,1005,1006,503,1009,1011,1012,1014],{},"Pick a folder of images in the sidebar tab (",[23,1007,1008],{},"N",[23,1010,326],{},") and press ",[23,1013,25],{},". The images are packed into one atlas inside the .blend, in file-name order.",[42,1016,1017,1018,1020,1021,114],{},"Select objects and press ",[23,1019,60],{},", or make the object with the Instance on Points or Array modifier active and press ",[23,1022,66],{},[42,1024,1025,1026,434,1028,1031,1032,1034],{},"Set ",[23,1027,76],{},[23,1029,1030],{},"Shuffle"," to use every image once before any repeats, and change the ",[23,1033,80],{}," for another arrangement.",[16,1036,1037,1038,1041],{},"It also covers padding between cells, tile shape and fit modes so pictures are not squashed, choosing a picture per object or matching it by object name, and mapping without UVs. The limits (one atlas per file, 16384 px per side) are on the product page, and the steps are in the ",[143,1039,1040],{"href":156},"Image Per Instance workflows",". It needs Blender 4.2 or newer. The free Image Per Instance Lite builds the atlas and applies it to separate objects, up to 20 images, without Geometry Nodes instances or Shuffle. For a few pictures once, the manual atlas above is free and works.",[1043,1044,1045],"style",{},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":303,"searchDepth":304,"depth":304,"links":1047},[1048,1049,1050,1057,1058,1059,1060,1061],{"id":351,"depth":304,"text":352},{"id":373,"depth":304,"text":374},{"id":415,"depth":304,"text":416,"children":1051},[1052,1053,1054,1055,1056],{"id":423,"depth":708,"text":424},{"id":445,"depth":708,"text":446},{"id":607,"depth":708,"text":608},{"id":628,"depth":708,"text":629},{"id":717,"depth":708,"text":718},{"id":808,"depth":304,"text":809},{"id":842,"depth":304,"text":843},{"id":856,"depth":304,"text":857},{"id":895,"depth":304,"text":896},{"id":988,"depth":304,"text":989},"Give every object, array copy or Geometry Nodes instance its own image in Blender: one material per image, an atlas with UV offsets, UDIM, or a faster add-on.",{},"---\ntitle: \"Different image on each instance in Blender\"\ndescription: \"Give every object, array copy or Geometry Nodes instance its own image in Blender: one material per image, an atlas with UV offsets, UDIM, or a faster add-on.\"\naddon: image-per-instance\nvideo: \u002Fmedia\u002Fipi.mp4\nposter: \u002Fmedia\u002Fipi.jpg\nupdated: 2026-11-16\n---\n\nBlender has no \"image index per object\" input, so one shared material shows one image everywhere. To give each object or instance its own picture, either use one material per image, or pack all images into one atlas and let each object pick its cell through a number the shader can read (an object custom property, or a named attribute stored on a Geometry Nodes instance). The first is fine for a handful of images. The second is the one that scales to dozens, and I ran every step below in Blender 4.2, 4.5 and 5.2.\n\n## Why the obvious node setup only gives colours\n\nThe first thing most people try is **Object Info**. Its **Random** output is a different number from 0 to 1 for every object, and for every Geometry Nodes instance too. Plug it into a **Color Ramp** and each object gets its own colour.\n\nThat is a colour, not a picture. The Image Texture node loads one image and has no socket for \"which image\". Random into a Color Ramp suits randomised tints and stops there. What you need is a number per object that chooses an image.\n\n## Method 1: one material per image\n\nFor a handful of pictures this is the simplest thing that works and needs no node maths.\n\n1. Select the object and open the **Material Properties** tab.\n2. Create a material, add an **Image Texture** node, open the picture and connect **Color** to the **Base Color** of the Principled BSDF.\n3. Duplicate the object (**Shift D**) and give the copy the next material, one object per picture.\n\nIt breaks down when pictures multiply: every new one means a new material and a manual assignment. Instances from Instance on Points or the Array modifier share the material of their source, so they cannot get different pictures this way at all.\n\n## Method 2: an atlas with a UV offset per object\n\nThis is the method that scales. All pictures go into one image laid out in a grid, and the shader shifts the UVs so each object looks at one cell.\n\n### Make the atlas\n\nPut your pictures into a grid of equal cells in any image editor, for example 2 columns by 2 rows for four images, and save one image. Cell 0 is bottom-left, cell 1 is to its right, and rows count upward, because UV space starts at the bottom-left.\n\nSet the Image Texture node's **Interpolation** to **Closest** while you test. With **Linear**, neighbouring cells can bleed into each other at the edges, so leave a few pixels of padding between pictures when you switch it back.\n\n### Build the shader\n\nUse an index number `i` from 0 to the number of cells minus one. For a grid with `cols` columns and `rows` rows, the cell column is `i` modulo `cols` and the row is `floor(i \u002F cols)`.\n\n1. Add **Texture Coordinate** and take its **UV** output into a **Mapping** node. Set **Type** to **Point**.\n2. Set Mapping **Scale** to `1\u002Fcols`, `1\u002Frows`, `1`. For the 2 by 2 atlas that is `0.5`, `0.5`, `1`. This shrinks the UV square to one cell.\n3. Add a **Math** node set to **Floored Modulo** with the second value `cols`. This is the column.\n4. Add a **Math** node set to **Divide** by `cols`, then a **Math** node set to **Floor**. This is the row.\n5. Divide the column by `cols` and the row by `rows` with two more **Math > Divide** nodes, and put the results into **X** and **Y** of a **Combine XYZ** node.\n6. Connect **Combine XYZ** to the **Location** input of the Mapping node.\n7. Connect Mapping **Vector** to the Image Texture **Vector**, and its **Color** to the Principled BSDF **Base Color** (or to an Emission node for a screen).\n\nNow the only missing piece is how the index `i` gets to each object.\n\n### Option A: random index from Object Info\n\nConnect **Object Info > Random** to a **Math > Multiply** by the number of cells, then to a **Math > Floor**, and feed the result into the chain above as `i`. In my test, four planes with one shared material got green, blue, blue and red. Random picks repeat, with few objects some pictures may not appear at all, and you cannot choose which object shows what.\n\n### Option B: a custom property per object\n\nWhen you want control, or no repeats:\n\n1. Select an object. Open the **Object Properties** tab, **Custom Properties** panel, and press **New**. Name it `img_index`, type **Float**.\n2. Type the cell number as the value.\n3. In the shader add an **Attribute** node, set **Type** to **Object** and **Name** to `img_index`, and connect its **Fac** output to the index chain.\n\nFor many objects, set it from the Scripting workspace:\n\n```python\nimport bpy\nfor i, ob in enumerate(bpy.context.selected_objects):\n    ob[\"img_index\"] = float(i % 4)\n```\n\nIn my test, planes given 3, 0, 2 and 1 showed the cells 3, 0, 2 and 1 of the atlas.\n\n### Option C: Geometry Nodes instances\n\nInstances do not have custom properties, but they can carry a named attribute.\n\n1. In your Geometry Nodes tree, after **Instance on Points**, add a **Store Named Attribute** node. Set **Data Type** to **Float** and **Domain** to **Instance**. The domain is the thing people miss, because the default is Point.\n2. Set the **Name** to `img_index`, and connect **Index** (from the **Index** node) to **Value**. Use a **Math > Modulo** if you have more instances than images.\n3. In the shader, add an **Attribute** node with **Type** set to **Instancer** and **Name** `img_index`, and feed its **Fac** into the same index chain.\n\nThe instanced geometry must use that material (a **Set Material** node before Instance on Points). My four instances showed four different cells. For random picks only, **Object Info > Random** also differs per instance, so Option A works on instances without any attribute.\n\n> The Index node follows the order the points were generated, which for a Grid is column by column in my test. To put a specific picture at a specific place, check the order first.\n\n## Method 3: UDIM tiles\n\nA UDIM image has numbered tiles. Tile 1001 is the UV square from 0 to 1, tile 1002 the next square to the right, and so on. You can load files named `name.1001.png` and `name.1002.png` as one tiled image.\n\nEach object still has to look at its own tile, so the shader is the same job as the atlas: a **Mapping** node whose **Location X** comes from an **Attribute** node. I tested it. With a custom property `udim_u` of 0 or 1 on four planes, they showed tile 1001 and tile 1002 alternately.\n\nUDIM does not save work here. You still need an index per object, plus one file per tile and the naming convention. It suits one model with several high-resolution texture areas, not a hundred different posters.\n\n## Method 4: an image sequence with a frame offset\n\nAn image sequence is a numbered series of files that Blender steps through by frame. Set the Image Texture node to a sequence and use its **Offset** to shift where each material starts.\n\nThe offset belongs to the node, so every object with that material shares it. I rendered three planes with three materials at offsets 0, 1 and 2 on frame 1 and got three different pictures. That works, but it is Method 1 again: one material per offset. I did not find a stock way to drive the offset per object from one material, so for a different picture per object an atlas is easier.\n\n## What goes wrong\n\n- **Pictures look squashed.** A portrait picture in a square cell is stretched. Make the cells the shape of your pictures.\n- **Seams show neighbouring pictures.** Linear filtering reads across cell borders. Leave padding or inset the UVs a pixel or two.\n- **All instances show the same cell.** The named attribute is stored on the Point domain, not Instance, or the shader Attribute node is set to Geometry instead of Instancer.\n- **Every object shows the first picture.** The Attribute node finds no attribute with that name and returns 0. Check that `img_index` is spelled the same in the property or Store Named Attribute and in the Attribute node. I tested a misspelled name and a missing property in 4.2.23 and 5.2.2, and all four planes showed cell 0.\n- More fixes are on the [Image Per Instance troubleshooting page](\u002Fdocs\u002Fimage-per-instance\u002Ftroubleshooting).\n\n## Which method fits\n\n| Method | Good for | Breaks when |\n|---|---|---|\n| One material per image | Up to about ten pictures | Instances, many pictures, later changes |\n| Atlas + Object Info Random | Random look on many objects | You need a chosen or even spread |\n| Atlas + custom property | Chosen picture per separate object | Instances, since they have no custom properties |\n| Atlas + Store Named Attribute | Array and Instance on Points | Needs a Geometry Nodes tree and a shader chain |\n| UDIM | One model with several texture areas | Many different pictures |\n| Image sequence | Animated or numbered pictures | Per-object offset on one material |\n\n## Faster with Image Per Instance\n\n[Image Per Instance](\u002Faddons\u002Fimage-per-instance) builds the atlas method for you, using the same technique as above. It stores an `img_index` value (an object custom property on separate objects, and a Store Named Attribute on the Instance domain on instances), and one shared material reads it with an Attribute node. That is the setup you just built by hand.\n\nWhat it does in practice:\n\n1. Pick a folder of images in the sidebar tab (**N**, **Image Per Instance**) and press **Build Atlas**. The images are packed into one atlas inside the .blend, in file-name order.\n2. Select objects and press **Apply To Selected Objects**, or make the object with the Instance on Points or Array modifier active and press **Add To Instances (Geometry Nodes)**.\n3. Set **Order** to **Shuffle** to use every image once before any repeats, and change the **Seed** for another arrangement.\n\nIt also covers padding between cells, tile shape and fit modes so pictures are not squashed, choosing a picture per object or matching it by object name, and mapping without UVs. The limits (one atlas per file, 16384 px per side) are on the product page, and the steps are in the [Image Per Instance workflows](\u002Fdocs\u002Fimage-per-instance\u002Fworkflows). It needs Blender 4.2 or newer. The free Image Per Instance Lite builds the atlas and applies it to separate objects, up to 20 images, without Geometry Nodes instances or Shuffle. For a few pictures once, the manual atlas above is free and works.\n\n",{"title":342,"description":1062},"guides\u002Fdifferent-image-per-instance","ymzHDoZ-AQtQ92lHUzBlryC9kbv16MS3nnFdblJlXqM",[1069,1239,1532,2116,2463,2707],{"id":1070,"title":1071,"addon":343,"body":1072,"description":1233,"extension":322,"meta":1234,"navigation":327,"order":697,"path":295,"rawbody":1235,"seo":1236,"stem":1237,"updated":335,"__hash__":1238},"docs\u002Fdocs\u002Fimage-per-instance\u002Findex.md","Image Per Instance documentation",{"type":8,"value":1073,"toc":1226},[1074,1078,1083,1086,1090,1154,1158,1188,1194,1198,1206,1210],[11,1075,1077],{"id":1076},"what-this-add-on-does","What this add-on does",[16,1079,1080,1082],{},[143,1081,326],{"href":328}," puts a different image on every object, array element or Geometry Nodes instance while all of them share one material. It reads a folder of images, packs them into one atlas stored in your .blend file, and stores an image number on each object or instance. The material reads that number and shows the matching tile.",[16,1084,1085],{},"This documentation covers version 0.2.0 for Blender 4.2 and newer.",[11,1087,1089],{"id":1088},"pages","Pages",[898,1091,1092,1102],{},[901,1093,1094],{},[904,1095,1096,1099],{},[907,1097,1098],{},"Page",[907,1100,1101],{},"What is in it",[917,1103,1104,1114,1124,1134,1144],{},[904,1105,1106,1111],{},[922,1107,1108],{},[143,1109,1110],{"href":263},"Install",[922,1112,1113],{},"Installing the zip, where the panel is, updating, removing, Lite versus full",[904,1115,1116,1121],{},[922,1117,1118],{},[143,1119,1120],{"href":145},"Panel reference",[922,1122,1123],{},"Every field, button and option with defaults and ranges",[904,1125,1126,1131],{},[922,1127,1128],{},[143,1129,1130],{"href":156},"Workflows",[922,1132,1133],{},"Step-by-step recipes for objects, Geometry Nodes instances, arrays, photo walls and later changes",[904,1135,1136,1141],{},[922,1137,1138],{},[143,1139,1140],{"href":225},"Troubleshooting",[922,1142,1143],{},"Error messages and limits, and what to do about each",[904,1145,1146,1151],{},[922,1147,1148],{},[143,1149,1150],{"href":300},"Changelog",[922,1152,1153],{},"What changed in each version",[11,1155,1157],{"id":1156},"the-idea-in-one-minute","The idea in one minute",[379,1159,1160,1173,1179],{},[42,1161,1162,1163,1166,1167,1170,1171,114],{},"Choose an ",[23,1164,1165],{},"Image Folder"," and a ",[23,1168,1169],{},"Tile Size",", then press ",[23,1172,25],{},[42,1174,1175,1176,1178],{},"If the pictures go on separate meshes, select those meshes and press ",[23,1177,60],{},". Each one gets its own tile.",[42,1180,1181,1182,1184,1185,1187],{},"If you use an Array modifier or Instance on Points, click the host object so it is active and press ",[23,1183,66],{},". The add-on finds the objects being instanced, gives them the shared material and adds an ",[23,1186,70],{}," modifier to the host.",[16,1189,1190,1191,1193],{},"If you are new to the problem, read the guide ",[143,1192,162],{"href":161}," first. It explains the manual method and why an atlas helps.",[11,1195,1197],{"id":1196},"support","Support",[16,1199,1200,1201,1205],{},"Write to ",[143,1202,1204],{"href":1203},"mailto:support@mendboxstudio.com","support@mendboxstudio.com"," and include your Blender version, the add-on version shown at the bottom of the panel, and the message Blender showed.",[11,1207,1209],{"id":1208},"related","Related",[39,1211,1212,1217,1221],{},[42,1213,1214,1215],{},"Product page: ",[143,1216,326],{"href":328},[42,1218,1219],{},[143,1220,1140],{"href":225},[42,1222,1223,1224],{},"Guide: ",[143,1225,162],{"href":161},{"title":303,"searchDepth":304,"depth":304,"links":1227},[1228,1229,1230,1231,1232],{"id":1076,"depth":304,"text":1077},{"id":1088,"depth":304,"text":1089},{"id":1156,"depth":304,"text":1157},{"id":1196,"depth":304,"text":1197},{"id":1208,"depth":304,"text":1209},"Docs for Image Per Instance, the Blender add-on that gives every object or instance its own image: install, panel reference, workflows and troubleshooting.",{},"---\ntitle: \"Image Per Instance documentation\"\ndescription: \"Docs for Image Per Instance, the Blender add-on that gives every object or instance its own image: install, panel reference, workflows and troubleshooting.\"\naddon: image-per-instance\norder: 1\nupdated: 2026-11-16\n---\n\n## What this add-on does\n\n[Image Per Instance](\u002Faddons\u002Fimage-per-instance) puts a different image on every object, array element or Geometry Nodes instance while all of them share one material. It reads a folder of images, packs them into one atlas stored in your .blend file, and stores an image number on each object or instance. The material reads that number and shows the matching tile.\n\nThis documentation covers version 0.2.0 for Blender 4.2 and newer.\n\n## Pages\n\n| Page | What is in it |\n|---|---|\n| [Install](\u002Fdocs\u002Fimage-per-instance\u002Finstall) | Installing the zip, where the panel is, updating, removing, Lite versus full |\n| [Panel reference](\u002Fdocs\u002Fimage-per-instance\u002Fpanel) | Every field, button and option with defaults and ranges |\n| [Workflows](\u002Fdocs\u002Fimage-per-instance\u002Fworkflows) | Step-by-step recipes for objects, Geometry Nodes instances, arrays, photo walls and later changes |\n| [Troubleshooting](\u002Fdocs\u002Fimage-per-instance\u002Ftroubleshooting) | Error messages and limits, and what to do about each |\n| [Changelog](\u002Fdocs\u002Fimage-per-instance\u002Fchangelog) | What changed in each version |\n\n## The idea in one minute\n\n1. Choose an **Image Folder** and a **Tile Size**, then press **Build Atlas**.\n2. If the pictures go on separate meshes, select those meshes and press **Apply To Selected Objects**. Each one gets its own tile.\n3. If you use an Array modifier or Instance on Points, click the host object so it is active and press **Add To Instances (Geometry Nodes)**. The add-on finds the objects being instanced, gives them the shared material and adds an **IPI Assign Index** modifier to the host.\n\nIf you are new to the problem, read the guide [different image per instance in Blender](\u002Fguides\u002Fdifferent-image-per-instance) first. It explains the manual method and why an atlas helps.\n\n## Support\n\nWrite to support@mendboxstudio.com and include your Blender version, the add-on version shown at the bottom of the panel, and the message Blender showed.\n\n## Related\n\n- Product page: [Image Per Instance](\u002Faddons\u002Fimage-per-instance)\n- [Troubleshooting](\u002Fdocs\u002Fimage-per-instance\u002Ftroubleshooting)\n- Guide: [different image per instance in Blender](\u002Fguides\u002Fdifferent-image-per-instance)\n",{"title":1071,"description":1233},"docs\u002Fimage-per-instance\u002Findex","nvPcxYtdq4OoSWwvD1tI5AeAY9jaK-lqeCAIxutySt0",{"id":1240,"title":1241,"addon":343,"body":1242,"description":1526,"extension":322,"meta":1527,"navigation":327,"order":304,"path":263,"rawbody":1528,"seo":1529,"stem":1530,"updated":335,"__hash__":1531},"docs\u002Fdocs\u002Fimage-per-instance\u002Finstall.md","Install Image Per Instance in Blender",{"type":8,"value":1243,"toc":1517},[1244,1246,1249,1253,1273,1277,1292,1310,1314,1323,1327,1347,1351,1361,1489,1492,1501,1503],[11,1245,238],{"id":237},[16,1247,1248],{},"Blender 4.2 or newer. The add-on is distributed as an extension zip. It has no external dependencies, needs no internet connection and installs no extra software.",[11,1250,1252],{"id":1251},"install-from-disk","Install from disk",[379,1254,1255,1258,1264,1270],{},[42,1256,1257],{},"Download the zip from Gumroad or Superhive. Do not unzip it.",[42,1259,1260,1261,114],{},"In Blender open ",[23,1262,1263],{},"Edit > Preferences > Get Extensions",[42,1265,1266,1267,114],{},"Open the arrow menu at the top right and choose ",[23,1268,1269],{},"Install from Disk",[42,1271,1272],{},"Pick the zip file.",[11,1274,1276],{"id":1275},"where-the-panel-is","Where the panel is",[16,1278,1279,1280,1282,1283,1285,1286,1288,1289,114],{},"Hover over the 3D viewport and press ",[23,1281,1008],{}," to open the sidebar. The add-on has its own tab named ",[23,1284,326],{},". The panel inside it is called ",[23,1287,326],{},", and the version number is shown at the bottom, for example ",[48,1290,1291],{},"Image Per Instance v0.2.0",[16,1293,1294,1295,503,1298,503,1301,209,1304,292,1307,1309],{},"Four sub-panels sit below the main buttons and start collapsed: ",[23,1296,1297],{},"Choose Images Yourself",[23,1299,1300],{},"Material",[23,1302,1303],{},"Animate",[23,1305,1306],{},"Random Variation",[143,1308,146],{"href":145}," describes all of them.",[11,1311,1313],{"id":1312},"update","Update",[16,1315,1316,1317,1319,1320,1322],{},"Install the newer zip with ",[23,1318,1269],{}," in the same way. Check the version at the bottom of the panel afterwards. Pressing ",[23,1321,25],{}," again keeps each object's picture when the file names are the same.",[11,1324,1326],{"id":1325},"uninstall","Uninstall",[16,1328,1329,1330,1332,1333,1336,1337,1340,1341,1343,1344,1346],{},"Open ",[23,1331,1263],{},", find the add-on in the list and remove it. What the add-on created in your file is ordinary Blender data: the material ",[48,1334,1335],{},"IPI_Material",", the atlas image ",[48,1338,1339],{},"IPI_Atlas",", a custom property ",[48,1342,652],{}," on separate objects, and a modifier named ",[48,1345,70],{}," on instance hosts. You can delete these by hand if you no longer need them.",[11,1348,1350],{"id":1349},"lite-versus-full","Lite versus full",[16,1352,1353,1354,1358,1359,114],{},"The free ",[143,1355,1357],{"href":256,"rel":1356},[258],"Image Per Instance Lite"," is a separate download. Its tab is named ",[23,1360,1357],{},[898,1362,1363,1376],{},[901,1364,1365],{},[904,1366,1367,1370,1373],{},[907,1368,1369],{},"Feature",[907,1371,1372],{},"Lite",[907,1374,1375],{},"Full",[917,1377,1378,1388,1397,1408,1417,1427,1435,1444,1453,1462,1471,1480],{},[904,1379,1380,1383,1386],{},[922,1381,1382],{},"Build Atlas from a folder, Apply To Selected Objects",[922,1384,1385],{},"yes",[922,1387,1385],{},[904,1389,1390,1393,1395],{},[922,1391,1392],{},"One shared material",[922,1394,1385],{},[922,1396,1385],{},[904,1398,1399,1402,1405],{},[922,1400,1401],{},"Images per atlas",[922,1403,1404],{},"up to 20",[922,1406,1407],{},"no limit in the add-on",[904,1409,1410,1413,1415],{},[922,1411,1412],{},"Natural file order",[922,1414,1385],{},[922,1416,1385],{},[904,1418,1419,1422,1425],{},[922,1420,1421],{},"Geometry Nodes instances, Array modifier",[922,1423,1424],{},"no",[922,1426,1385],{},[904,1428,1429,1431,1433],{},[922,1430,1030],{},[922,1432,1424],{},[922,1434,1385],{},[904,1436,1437,1440,1442],{},[922,1438,1439],{},"Tile shape and fit modes",[922,1441,1424],{},[922,1443,1385],{},[904,1445,1446,1449,1451],{},[922,1447,1448],{},"Assign by number, name or picker",[922,1450,1424],{},[922,1452,1385],{},[904,1454,1455,1458,1460],{},[922,1456,1457],{},"Alpha and emission",[922,1459,1424],{},[922,1461,1385],{},[904,1463,1464,1467,1469],{},[922,1465,1466],{},"Mapping without UVs",[922,1468,1424],{},[922,1470,1385],{},[904,1472,1473,1476,1478],{},[922,1474,1475],{},"Animation",[922,1477,1424],{},[922,1479,1385],{},[904,1481,1482,1485,1487],{},[922,1483,1484],{},"Random variation",[922,1486,1424],{},[922,1488,1385],{},[16,1490,1491],{},"When Lite finds more than 20 images, it stops with the message \"This free version supports up to 20 images\".",[16,1493,1494,1495,1497,1498,114],{},"Next: the ",[143,1496,146],{"href":145}," or the ",[143,1499,1500],{"href":156},"workflows",[11,1502,1209],{"id":1208},[39,1504,1505,1509,1513],{},[42,1506,1214,1507],{},[143,1508,326],{"href":328},[42,1510,1511],{},[143,1512,1140],{"href":225},[42,1514,1223,1515],{},[143,1516,162],{"href":161},{"title":303,"searchDepth":304,"depth":304,"links":1518},[1519,1520,1521,1522,1523,1524,1525],{"id":237,"depth":304,"text":238},{"id":1251,"depth":304,"text":1252},{"id":1275,"depth":304,"text":1276},{"id":1312,"depth":304,"text":1313},{"id":1325,"depth":304,"text":1326},{"id":1349,"depth":304,"text":1350},{"id":1208,"depth":304,"text":1209},"How to install, find, update and remove the Image Per Instance add-on in Blender 4.2 and newer, and how the free Lite version differs from the full one.",{},"---\ntitle: \"Install Image Per Instance in Blender\"\ndescription: \"How to install, find, update and remove the Image Per Instance add-on in Blender 4.2 and newer, and how the free Lite version differs from the full one.\"\naddon: image-per-instance\norder: 2\nupdated: 2026-11-16\n---\n\n## Requirements\n\nBlender 4.2 or newer. The add-on is distributed as an extension zip. It has no external dependencies, needs no internet connection and installs no extra software.\n\n## Install from disk\n\n1. Download the zip from Gumroad or Superhive. Do not unzip it.\n2. In Blender open **Edit > Preferences > Get Extensions**.\n3. Open the arrow menu at the top right and choose **Install from Disk**.\n4. Pick the zip file.\n\n## Where the panel is\n\nHover over the 3D viewport and press **N** to open the sidebar. The add-on has its own tab named **Image Per Instance**. The panel inside it is called **Image Per Instance**, and the version number is shown at the bottom, for example `Image Per Instance v0.2.0`.\n\nFour sub-panels sit below the main buttons and start collapsed: **Choose Images Yourself**, **Material**, **Animate** and **Random Variation**. The [panel reference](\u002Fdocs\u002Fimage-per-instance\u002Fpanel) describes all of them.\n\n## Update\n\nInstall the newer zip with **Install from Disk** in the same way. Check the version at the bottom of the panel afterwards. Pressing **Build Atlas** again keeps each object's picture when the file names are the same.\n\n## Uninstall\n\nOpen **Edit > Preferences > Get Extensions**, find the add-on in the list and remove it. What the add-on created in your file is ordinary Blender data: the material `IPI_Material`, the atlas image `IPI_Atlas`, a custom property `img_index` on separate objects, and a modifier named `IPI Assign Index` on instance hosts. You can delete these by hand if you no longer need them.\n\n## Lite versus full\n\nThe free [Image Per Instance Lite](https:\u002F\u002Fgithub.com\u002Fmendbox\u002Fimage-per-instance-lite) is a separate download. Its tab is named **Image Per Instance Lite**.\n\n| Feature | Lite | Full |\n|---|---|---|\n| Build Atlas from a folder, Apply To Selected Objects | yes | yes |\n| One shared material | yes | yes |\n| Images per atlas | up to 20 | no limit in the add-on |\n| Natural file order | yes | yes |\n| Geometry Nodes instances, Array modifier | no | yes |\n| Shuffle | no | yes |\n| Tile shape and fit modes | no | yes |\n| Assign by number, name or picker | no | yes |\n| Alpha and emission | no | yes |\n| Mapping without UVs | no | yes |\n| Animation | no | yes |\n| Random variation | no | yes |\n\nWhen Lite finds more than 20 images, it stops with the message \"This free version supports up to 20 images\".\n\nNext: the [panel reference](\u002Fdocs\u002Fimage-per-instance\u002Fpanel) or the [workflows](\u002Fdocs\u002Fimage-per-instance\u002Fworkflows).\n\n## Related\n\n- Product page: [Image Per Instance](\u002Faddons\u002Fimage-per-instance)\n- [Troubleshooting](\u002Fdocs\u002Fimage-per-instance\u002Ftroubleshooting)\n- Guide: [different image per instance in Blender](\u002Fguides\u002Fdifferent-image-per-instance)\n",{"title":1241,"description":1526},"docs\u002Fimage-per-instance\u002Finstall","XImq1D0SPLXcR1dDWHpVYP8bVTntBVzsgcH9KLvsNlA",{"id":1533,"title":1534,"addon":343,"body":1535,"description":2110,"extension":322,"meta":2111,"navigation":327,"order":708,"path":145,"rawbody":2112,"seo":2113,"stem":2114,"updated":335,"__hash__":2115},"docs\u002Fdocs\u002Fimage-per-instance\u002Fpanel.md","Image Per Instance panel reference",{"type":8,"value":1536,"toc":2100},[1537,1546,1550,1668,1672,1735,1744,1747,1750,1818,1821,1824,1904,1907,1910,1945,1948,1951,2016,2020,2076,2084,2086],[16,1538,1539,1540,1542,1543,1545],{},"All controls live in the 3D viewport sidebar (",[23,1541,1008],{},"), in the ",[23,1544,326],{}," tab. This page follows the panel from top to bottom. Version 0.2.0.",[11,1547,1549],{"id":1548},"main-panel-atlas-settings","Main panel: atlas settings",[898,1551,1552,1564],{},[901,1553,1554],{},[904,1555,1556,1559,1561],{},[907,1557,1558],{},"Control",[907,1560,37],{},[907,1562,1563],{},"Default \u002F range",[917,1565,1566,1576,1586,1597,1619,1632,1643,1657],{},[904,1567,1568,1570,1573],{},[922,1569,1165],{},[922,1571,1572],{},"Folder with your images. Only files directly inside it are read, not subfolders. Supported types: png, jpg, jpeg, tif, tiff, bmp, webp, exr, tga.",[922,1574,1575],{},"empty",[904,1577,1578,1580,1583],{},[922,1579,1169],{},[922,1581,1582],{},"Size of one atlas tile in pixels: 128, 256, 512, 1024 or 2048. With a non-square Tile Shape this is the length of the longer side.",[922,1584,1585],{},"512 px",[904,1587,1588,1591,1594],{},[922,1589,1590],{},"Tile Shape",[922,1592,1593],{},"Shape of one tile: 1 : 1, 2 : 3, 3 : 2, 3 : 4, 4 : 3, 16 : 9 or 9 : 16. Pick the shape of your frames, covers or screens.",[922,1595,1596],{},"1 : 1",[904,1598,1599,1602,1617],{},[922,1600,1601],{},"Fit",[922,1603,1604,1605,1608,1609,1612,1613,1616],{},"What happens when an image has a different shape than the tile. ",[23,1606,1607],{},"Stretch"," fills the tile and distorts the image. ",[23,1610,1611],{},"Fit (bars)"," shows the whole image with bars around it. ",[23,1614,1615],{},"Fill (crop)"," covers the whole tile and crops the edges.",[922,1618,1607],{},[904,1620,1621,1624,1629],{},[922,1622,1623],{},"Bar Colour",[922,1625,1626,1627,114],{},"Colour of the bars. Only shown when Fit is ",[23,1628,1611],{},[922,1630,1631],{},"black, 0 to 1 per channel",[904,1633,1634,1637,1640],{},[922,1635,1636],{},"Padding",[922,1638,1639],{},"Edge padding in pixels that hides bleeding between neighbouring tiles.",[922,1641,1642],{},"4, range 0 to 32",[904,1644,1645,1647,1655],{},[922,1646,76],{},[922,1648,1649,282,1652,1654],{},[23,1650,1651],{},"By file name",[23,1653,1030],{},". Shuffle uses every image once before any repeats. It changes which image an object or instance gets, not the order inside the atlas.",[922,1656,1651],{},[904,1658,1659,1661,1666],{},[922,1660,80],{},[922,1662,1663,1664,114],{},"Picks the shuffled arrangement. Only shown when Order is ",[23,1665,1030],{},[922,1667,509],{},[11,1669,1671],{"id":1670},"main-panel-buttons-and-labels","Main panel: buttons and labels",[898,1673,1674,1682],{},[901,1675,1676],{},[904,1677,1678,1680],{},[907,1679,1558],{},[907,1681,37],{},[917,1683,1684,1691,1699,1712,1719,1727],{},[904,1685,1686,1688],{},[922,1687,25],{},[922,1689,1690],{},"Packs all images from the folder into one atlas and creates the shared material. The atlas is always in natural file-name order, so Image Number N is the N-th file. Pressing it again replaces the atlas. Objects keep the picture they showed, matched by file name.",[904,1692,1693,1696],{},[922,1694,1695],{},"Atlas label",[922,1697,1698],{},"Shows \"Atlas: N images\", or \"Atlas: not built\" before the first build.",[904,1700,1701,1703],{},[922,1702,60],{},[922,1704,1705,1706,1708,1709,1711],{},"Gives each selected mesh object its own image and puts the shared material on it. With Order ",[23,1707,1651],{},", objects are sorted by name (natural order) and get images 1, 2, 3 and so on, wrapping around when there are more objects than images. With ",[23,1710,1030],{},", the objects are shuffled using the Seed.",[904,1713,1714,1716],{},[922,1715,66],{},[922,1717,1718],{},"The active object is the host with your Array or Instance on Points modifier. The add-on finds the instanced source objects, sets the shared material on them, and adds a modifier named \"IPI Assign Index\" on the host. Selected mesh objects are added as sources too. Press it again after changing Seed or Order to update the modifier.",[904,1720,1721,1724],{},[922,1722,1723],{},"\"Press again after changing Seed to re-shuffle\"",[922,1725,1726],{},"A hint. Change Seed, then press Apply To Selected Objects or Add To Instances again.",[904,1728,1729,1732],{},[922,1730,1731],{},"Version label",[922,1733,1734],{},"\"Image Per Instance v\" followed by the version number.",[16,1736,1737,1738,1740,1741,1743],{},"How the atlas is laid out: the number of columns is chosen from the image count and the tile shape, so the atlas stays roughly square. The atlas image is named ",[48,1739,1339],{},", the material ",[48,1742,1335],{},". The atlas can be at most 16384 px on each side.",[11,1745,1297],{"id":1746},"choose-images-yourself",[16,1748,1749],{},"Collapsed by default. Applies to separate objects only, as the panel says.",[898,1751,1752,1762],{},[901,1753,1754],{},[904,1755,1756,1758,1760],{},[907,1757,1558],{},[907,1759,37],{},[907,1761,1563],{},[917,1763,1764,1775,1785,1794],{},[904,1765,1766,1769,1772],{},[922,1767,1768],{},"Image Number",[922,1770,1771],{},"Number of the image in the atlas. 1 is the first file. Changing it updates the Image field.",[922,1773,1774],{},"1, minimum 1",[904,1776,1777,1780,1783],{},[922,1778,1779],{},"Image (search field)",[922,1781,1782],{},"Pick the image by file name, you can type to search. Choosing a name sets Image Number.",[922,1784,1575],{},[904,1786,1787,1789,1792],{},[922,1788,208],{},[922,1790,1791],{},"Gives every selected mesh object the image with the chosen number, and the shared material. Fails with a message if the number is higher than the number of images.",[922,1793],{},[904,1795,1796,1798,1816],{},[922,1797,105],{},[922,1799,1800,1801,1804,1805,1808,1809,1811,1812,1815],{},"Each selected object gets the image whose file name equals the object name. If there is no exact match, the longest file name that appears as a whole word in the object name wins (",[48,1802,1803],{},"card_10"," gets ",[48,1806,1807],{},"10",", not ",[48,1810,509],{},"), then the longest file name contained in the name. A Blender duplicate suffix such as ",[48,1813,1814],{},".001"," is ignored, and case does not matter. Objects without a match are listed in the message.",[922,1817],{},[11,1819,1300],{"id":1820},"material",[16,1822,1823],{},"Collapsed by default. These options update the material at once, without pressing a button again, as long as the atlas is built.",[898,1825,1826,1836],{},[901,1827,1828],{},[904,1829,1830,1832,1834],{},[907,1831,1558],{},[907,1833,37],{},[907,1835,1563],{},[917,1837,1838,1861,1872,1882,1893],{},[904,1839,1840,1842,1859],{},[922,1841,486],{},[922,1843,1844,1845,1848,1849,503,1852,209,1855,1858],{},"Where the image sits on the object. ",[23,1846,1847],{},"UV Map"," uses the object's UV map, which must fill the 0 to 1 square. ",[23,1850,1851],{},"Front (no UVs)",[23,1853,1854],{},"Top (no UVs)",[23,1856,1857],{},"Side (no UVs)"," project the image across the whole object from the front, top or right side.",[922,1860,1847],{},[904,1862,1863,1866,1869],{},[922,1864,1865],{},"Use Image Alpha",[922,1867,1868],{},"PNG transparency cuts the shape out (stickers, round cards, the bars of Fit mode). Sets the material render method to Dithered.",[922,1870,1871],{},"off",[904,1873,1874,1877,1880],{},[922,1875,1876],{},"Emissive (screen)",[922,1878,1879],{},"The image glows by itself, for video walls, billboards and screens.",[922,1881,1871],{},[904,1883,1884,1887,1890],{},[922,1885,1886],{},"Strength",[922,1888,1889],{},"Emission strength. Only shown when Emissive is on.",[922,1891,1892],{},"1.0, minimum 0, soft maximum 10",[904,1894,1895,1898,1901],{},[922,1896,1897],{},"Roughness",[922,1899,1900],{},"Roughness of the material.",[922,1902,1903],{},"0.5, range 0 to 1",[11,1905,1303],{"id":1906},"animate",[16,1908,1909],{},"Collapsed by default. The checkbox in the sub-panel header switches animation on.",[898,1911,1912,1922],{},[901,1913,1914],{},[904,1915,1916,1918,1920],{},[907,1917,1558],{},[907,1919,37],{},[907,1921,1563],{},[917,1923,1924,1934],{},[904,1925,1926,1929,1932],{},[922,1927,1928],{},"Animate (checkbox)",[922,1930,1931],{},"Every object steps through the images over time, each starting at its own image.",[922,1933,1871],{},[904,1935,1936,1939,1942],{},[922,1937,1938],{},"Frames Per Image",[922,1940,1941],{},"How many frames each image stays before the next one.",[922,1943,1944],{},"24, minimum 1, soft maximum 240",[11,1946,1306],{"id":1947},"random-variation",[16,1949,1950],{},"Collapsed by default. All values start at zero, which adds no nodes to the material.",[898,1952,1953,1963],{},[901,1954,1955],{},[904,1956,1957,1959,1961],{},[907,1958,1558],{},[907,1960,37],{},[907,1962,1563],{},[917,1964,1965,1976,1986,1996,2006],{},[904,1966,1967,1970,1973],{},[922,1968,1969],{},"Hue",[922,1971,1972],{},"Random hue shift per object.",[922,1974,1975],{},"0, range 0 to 1",[904,1977,1978,1981,1984],{},[922,1979,1980],{},"Saturation",[922,1982,1983],{},"Random saturation change per object.",[922,1985,1975],{},[904,1987,1988,1991,1994],{},[922,1989,1990],{},"Brightness",[922,1992,1993],{},"Random brightness change per object.",[922,1995,1975],{},[904,1997,1998,2001,2004],{},[922,1999,2000],{},"Flip X",[922,2002,2003],{},"Mirrors a random half of the objects left to right.",[922,2005,1871],{},[904,2007,2008,2011,2014],{},[922,2009,2010],{},"Flip Y",[922,2012,2013],{},"Mirrors a random half of the objects top to bottom.",[922,2015,1871],{},[11,2017,2019],{"id":2018},"what-the-add-on-creates-in-your-file","What the add-on creates in your file",[898,2021,2022,2031],{},[901,2023,2024],{},[904,2025,2026,2028],{},[907,2027,674],{},[907,2029,2030],{},"What it is",[917,2032,2033,2042,2051,2060],{},[904,2034,2035,2039],{},[922,2036,2037],{},[48,2038,1339],{},[922,2040,2041],{},"The packed atlas image",[904,2043,2044,2048],{},[922,2045,2046],{},[48,2047,1335],{},[922,2049,2050],{},"The shared material, used in slot 1 of each affected object",[904,2052,2053,2057],{},[922,2054,2055],{},[48,2056,652],{},[922,2058,2059],{},"Custom property on separate objects holding the image index (the first image is 0)",[904,2061,2062,2066],{},[922,2063,2064],{},[48,2065,70],{},[922,2067,2068,2069,2072,2073,2075],{},"Geometry Nodes modifier on the host, using the node group ",[48,2070,2071],{},"IPI_Assign_Index"," with inputs Image Count, Shuffle, Seed and Shuffle Step. It stores ",[48,2074,652],{}," on every instance.",[16,2077,2078,2079,2081,2082,114],{},"For recipes, see the ",[143,2080,1500],{"href":156},". For problems, see ",[143,2083,226],{"href":225},[11,2085,1209],{"id":1208},[39,2087,2088,2092,2096],{},[42,2089,1214,2090],{},[143,2091,326],{"href":328},[42,2093,2094],{},[143,2095,1140],{"href":225},[42,2097,1223,2098],{},[143,2099,162],{"href":161},{"title":303,"searchDepth":304,"depth":304,"links":2101},[2102,2103,2104,2105,2106,2107,2108,2109],{"id":1548,"depth":304,"text":1549},{"id":1670,"depth":304,"text":1671},{"id":1746,"depth":304,"text":1297},{"id":1820,"depth":304,"text":1300},{"id":1906,"depth":304,"text":1303},{"id":1947,"depth":304,"text":1306},{"id":2018,"depth":304,"text":2019},{"id":1208,"depth":304,"text":1209},"Every field, button and option of the Image Per Instance panel in Blender: atlas settings, material, animation and random variation, with defaults and ranges.",{},"---\ntitle: \"Image Per Instance panel reference\"\ndescription: \"Every field, button and option of the Image Per Instance panel in Blender: atlas settings, material, animation and random variation, with defaults and ranges.\"\naddon: image-per-instance\norder: 3\nupdated: 2026-11-16\n---\n\nAll controls live in the 3D viewport sidebar (**N**), in the **Image Per Instance** tab. This page follows the panel from top to bottom. Version 0.2.0.\n\n## Main panel: atlas settings\n\n| Control | What it does | Default \u002F range |\n|---|---|---|\n| Image Folder | Folder with your images. Only files directly inside it are read, not subfolders. Supported types: png, jpg, jpeg, tif, tiff, bmp, webp, exr, tga. | empty |\n| Tile Size | Size of one atlas tile in pixels: 128, 256, 512, 1024 or 2048. With a non-square Tile Shape this is the length of the longer side. | 512 px |\n| Tile Shape | Shape of one tile: 1 : 1, 2 : 3, 3 : 2, 3 : 4, 4 : 3, 16 : 9 or 9 : 16. Pick the shape of your frames, covers or screens. | 1 : 1 |\n| Fit | What happens when an image has a different shape than the tile. **Stretch** fills the tile and distorts the image. **Fit (bars)** shows the whole image with bars around it. **Fill (crop)** covers the whole tile and crops the edges. | Stretch |\n| Bar Colour | Colour of the bars. Only shown when Fit is **Fit (bars)**. | black, 0 to 1 per channel |\n| Padding | Edge padding in pixels that hides bleeding between neighbouring tiles. | 4, range 0 to 32 |\n| Order | **By file name** or **Shuffle**. Shuffle uses every image once before any repeats. It changes which image an object or instance gets, not the order inside the atlas. | By file name |\n| Seed | Picks the shuffled arrangement. Only shown when Order is **Shuffle**. | 1 |\n\n## Main panel: buttons and labels\n\n| Control | What it does |\n|---|---|\n| Build Atlas | Packs all images from the folder into one atlas and creates the shared material. The atlas is always in natural file-name order, so Image Number N is the N-th file. Pressing it again replaces the atlas. Objects keep the picture they showed, matched by file name. |\n| Atlas label | Shows \"Atlas: N images\", or \"Atlas: not built\" before the first build. |\n| Apply To Selected Objects | Gives each selected mesh object its own image and puts the shared material on it. With Order **By file name**, objects are sorted by name (natural order) and get images 1, 2, 3 and so on, wrapping around when there are more objects than images. With **Shuffle**, the objects are shuffled using the Seed. |\n| Add To Instances (Geometry Nodes) | The active object is the host with your Array or Instance on Points modifier. The add-on finds the instanced source objects, sets the shared material on them, and adds a modifier named \"IPI Assign Index\" on the host. Selected mesh objects are added as sources too. Press it again after changing Seed or Order to update the modifier. |\n| \"Press again after changing Seed to re-shuffle\" | A hint. Change Seed, then press Apply To Selected Objects or Add To Instances again. |\n| Version label | \"Image Per Instance v\" followed by the version number. |\n\nHow the atlas is laid out: the number of columns is chosen from the image count and the tile shape, so the atlas stays roughly square. The atlas image is named `IPI_Atlas`, the material `IPI_Material`. The atlas can be at most 16384 px on each side.\n\n## Choose Images Yourself\n\nCollapsed by default. Applies to separate objects only, as the panel says.\n\n| Control | What it does | Default \u002F range |\n|---|---|---|\n| Image Number | Number of the image in the atlas. 1 is the first file. Changing it updates the Image field. | 1, minimum 1 |\n| Image (search field) | Pick the image by file name, you can type to search. Choosing a name sets Image Number. | empty |\n| Assign Image To Selected | Gives every selected mesh object the image with the chosen number, and the shared material. Fails with a message if the number is higher than the number of images. | |\n| Match By Object Name | Each selected object gets the image whose file name equals the object name. If there is no exact match, the longest file name that appears as a whole word in the object name wins (`card_10` gets `10`, not `1`), then the longest file name contained in the name. A Blender duplicate suffix such as `.001` is ignored, and case does not matter. Objects without a match are listed in the message. | |\n\n## Material\n\nCollapsed by default. These options update the material at once, without pressing a button again, as long as the atlas is built.\n\n| Control | What it does | Default \u002F range |\n|---|---|---|\n| Mapping | Where the image sits on the object. **UV Map** uses the object's UV map, which must fill the 0 to 1 square. **Front (no UVs)**, **Top (no UVs)** and **Side (no UVs)** project the image across the whole object from the front, top or right side. | UV Map |\n| Use Image Alpha | PNG transparency cuts the shape out (stickers, round cards, the bars of Fit mode). Sets the material render method to Dithered. | off |\n| Emissive (screen) | The image glows by itself, for video walls, billboards and screens. | off |\n| Strength | Emission strength. Only shown when Emissive is on. | 1.0, minimum 0, soft maximum 10 |\n| Roughness | Roughness of the material. | 0.5, range 0 to 1 |\n\n## Animate\n\nCollapsed by default. The checkbox in the sub-panel header switches animation on.\n\n| Control | What it does | Default \u002F range |\n|---|---|---|\n| Animate (checkbox) | Every object steps through the images over time, each starting at its own image. | off |\n| Frames Per Image | How many frames each image stays before the next one. | 24, minimum 1, soft maximum 240 |\n\n## Random Variation\n\nCollapsed by default. All values start at zero, which adds no nodes to the material.\n\n| Control | What it does | Default \u002F range |\n|---|---|---|\n| Hue | Random hue shift per object. | 0, range 0 to 1 |\n| Saturation | Random saturation change per object. | 0, range 0 to 1 |\n| Brightness | Random brightness change per object. | 0, range 0 to 1 |\n| Flip X | Mirrors a random half of the objects left to right. | off |\n| Flip Y | Mirrors a random half of the objects top to bottom. | off |\n\n## What the add-on creates in your file\n\n| Name | What it is |\n|---|---|\n| `IPI_Atlas` | The packed atlas image |\n| `IPI_Material` | The shared material, used in slot 1 of each affected object |\n| `img_index` | Custom property on separate objects holding the image index (the first image is 0) |\n| `IPI Assign Index` | Geometry Nodes modifier on the host, using the node group `IPI_Assign_Index` with inputs Image Count, Shuffle, Seed and Shuffle Step. It stores `img_index` on every instance. |\n\nFor recipes, see the [workflows](\u002Fdocs\u002Fimage-per-instance\u002Fworkflows). For problems, see [troubleshooting](\u002Fdocs\u002Fimage-per-instance\u002Ftroubleshooting).\n\n## Related\n\n- Product page: [Image Per Instance](\u002Faddons\u002Fimage-per-instance)\n- [Troubleshooting](\u002Fdocs\u002Fimage-per-instance\u002Ftroubleshooting)\n- Guide: [different image per instance in Blender](\u002Fguides\u002Fdifferent-image-per-instance)\n",{"title":1534,"description":2110},"docs\u002Fimage-per-instance\u002Fpanel","N-1LWe8YGeCnfGgAY49syq9q-tLfOayf5wOWzx0sG1k",{"id":2117,"title":1040,"addon":343,"body":2118,"description":2456,"extension":322,"meta":2457,"navigation":327,"order":2458,"path":156,"rawbody":2459,"seo":2460,"stem":2461,"updated":335,"__hash__":2462},"docs\u002Fdocs\u002Fimage-per-instance\u002Fworkflows.md",{"type":8,"value":2119,"toc":2446},[2120,2131,2135,2138,2182,2191,2195,2198,2220,2226,2230,2256,2259,2265,2269,2327,2331,2349,2361,2365,2411,2415,2430,2432],[16,2121,2122,2123,2125,2126,2128,2129,114],{},"Every recipe starts the same way: open the sidebar with ",[23,2124,1008],{}," and go to the ",[23,2127,326],{}," tab. Names of controls are explained in the ",[143,2130,146],{"href":145},[11,2132,2134],{"id":2133},"different-images-on-separate-objects","Different images on separate objects",[16,2136,2137],{},"Use this for frames on a wall, book covers or cards that are individual objects.",[379,2139,2140,2155,2162,2170,2176],{},[42,2141,2142,2143,503,2146,2149,2150,2152,2153,114],{},"Put your images in one folder, named so they sort the way you want (",[48,2144,2145],{},"01.jpg",[48,2147,2148],{},"02.jpg"," and so on). Sorting is natural, so ",[48,2151,50],{}," comes before ",[48,2154,54],{},[42,2156,1025,2157,2159,2160,114],{},[23,2158,1165],{}," to that folder and pick a ",[23,2161,1169],{},[42,2163,1025,2164,2166,2167,2169],{},[23,2165,1590],{}," to the shape of your objects, for example 2 : 3 for book covers, and ",[23,2168,1601],{}," to Fill (crop) if you do not want distortion.",[42,2171,2172,2173,2175],{},"Press ",[23,2174,25],{},". The label shows \"Atlas: N images\".",[42,2177,2178,2179,2181],{},"Select the mesh objects and press ",[23,2180,60],{},". Objects are taken in name order and get image 1, 2, 3 and so on.",[16,2183,2184,2185,2187,2188,2190],{},"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 ",[23,2186,1300],{}," and set ",[23,2189,486],{}," to Front, Top or Side first.",[11,2192,2194],{"id":2193},"different-images-on-geometry-nodes-instances","Different images on Geometry Nodes instances",[16,2196,2197],{},"Use this for Instance on Points scatters and collection instances.",[379,2199,2200,2203,2210,2214,2217],{},[42,2201,2202],{},"Build the atlas as above.",[42,2204,2205,2206,2209],{},"Make the object that carries your Geometry Nodes modifier the ",[23,2207,2208],{},"active"," object. It must be a mesh.",[42,2211,2172,2212,114],{},[23,2213,66],{},[42,2215,2216],{},"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.",[42,2218,2219],{},"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.",[16,2221,2222,2223,2225],{},"The add-on puts the ",[23,2224,70],{}," modifier last in the host's modifier stack. It stores an image index on every instance, and the material reads it.",[11,2227,2229],{"id":2228},"arrays-and-the-array-modifier","Arrays and the Array modifier",[379,2231,2232,2235,2238,2242,2245],{},[42,2233,2234],{},"Build the atlas.",[42,2236,2237],{},"Make the object with the Array modifier active.",[42,2239,2172,2240,114],{},[23,2241,66],{},[42,2243,2244],{},"If the array source is an object, it is found automatically. If not, select the source and press the button again.",[42,2246,2247,2248,434,2250,2252,2253,2255],{},"To spread images differently, set ",[23,2249,76],{},[23,2251,1030],{},", change ",[23,2254,80],{},", and press the button again.",[16,2257,2258],{},"The modifier cycles through the images: with 12 images and 40 instances, the pattern repeats after 12.",[16,2260,2261],{},[30,2262],{"alt":2263,"src":2264},"Blender with 12 numbered instances, each showing its own image, and the Image Per Instance panel in the sidebar","\u002Fmedia\u002Fipi-panel-instances.jpg",[11,2266,2268],{"id":2267},"a-photo-wall-or-a-card-deck","A photo wall or a card deck",[379,2270,2271,2274,2282,2293,2297,2303,2313],{},[42,2272,2273],{},"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.",[42,2275,1025,2276,2278,2279,2281],{},[23,2277,1590],{}," to the card shape (for example 2 : 3) and ",[23,2280,1601],{}," to Fill (crop) or Fit (bars).",[42,2283,2284,2285,2287,2288,2290,2291,114],{},"If you use Fit (bars), set ",[23,2286,1623],{},". To make the bars transparent, switch on ",[23,2289,1865],{}," under ",[23,2292,1300],{},[42,2294,2172,2295,114],{},[23,2296,25],{},[42,2298,2299,2300,2302],{},"Scatter or array the card, then press ",[23,2301,66],{}," on the host.",[42,2304,2305,2306,2290,2308,2310,2311,114],{},"For a screen wall, switch on ",[23,2307,1876],{},[23,2309,1300],{}," and raise ",[23,2312,1886],{},[42,2314,2315,2316,434,2318,2320,2321,2323,2324,2326],{},"For a card deck where you want the images to look random, set ",[23,2317,76],{},[23,2319,1030],{},". Under ",[23,2322,1306],{},", add a little Hue or Brightness, and tick ",[23,2325,2000],{}," if mirrored images suit the look.",[11,2328,2330],{"id":2329},"putting-a-specific-image-on-a-specific-object","Putting a specific image on a specific object",[379,2332,2333,2335,2340,2345],{},[42,2334,2234],{},[42,2336,2337,2338,114],{},"Select one or more objects. Open ",[23,2339,1297],{},[42,2341,2342,2343,114],{},"Type a file name in the search field, or set ",[23,2344,1768],{},[42,2346,2172,2347,114],{},[23,2348,208],{},[16,2350,2351,2352,2354,2355,2357,2358,2360],{},"For many objects, name them after the files (an object ",[48,2353,109],{}," for ",[48,2356,113],{},"), select them all and press ",[23,2359,105],{},". The message tells you how many matched and lists the first few without a match.",[11,2362,2364],{"id":2363},"changing-the-images-later","Changing the images later",[379,2366,2367,2370,2375,2385,2396],{},[42,2368,2369],{},"Add, remove or rename images in the folder. Replace images by dropping new files in.",[42,2371,2172,2372,2374],{},[23,2373,25],{}," 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.",[42,2376,2377,2378,503,2380,209,2382,2384],{},"Changes to ",[23,2379,1300],{},[23,2381,1303],{},[23,2383,1306],{}," apply immediately, with no second button.",[42,2386,2377,2387,282,2389,2391,2392,282,2394,114],{},[23,2388,80],{},[23,2390,76],{}," need another press of ",[23,2393,60],{},[23,2395,66],{},[42,2397,2398,2399,503,2401,503,2403,282,2405,2407,2408,2410],{},"To change ",[23,2400,1169],{},[23,2402,1590],{},[23,2404,1601],{},[23,2406,1636],{},", press ",[23,2409,25],{}," again.",[11,2412,2414],{"id":2413},"animating-through-the-images","Animating through the images",[379,2416,2417,2420,2427],{},[42,2418,2419],{},"Build the atlas and apply the images as usual.",[42,2421,1329,2422,2424,2425,114],{},[23,2423,1303],{},", tick the box in its header, and set ",[23,2426,1938],{},[42,2428,2429],{},"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.",[11,2431,1209],{"id":1208},[39,2433,2434,2438,2442],{},[42,2435,1214,2436],{},[143,2437,326],{"href":328},[42,2439,2440],{},[143,2441,1140],{"href":225},[42,2443,1223,2444],{},[143,2445,162],{"href":161},{"title":303,"searchDepth":304,"depth":304,"links":2447},[2448,2449,2450,2451,2452,2453,2454,2455],{"id":2133,"depth":304,"text":2134},{"id":2193,"depth":304,"text":2194},{"id":2228,"depth":304,"text":2229},{"id":2267,"depth":304,"text":2268},{"id":2329,"depth":304,"text":2330},{"id":2363,"depth":304,"text":2364},{"id":2413,"depth":304,"text":2414},{"id":1208,"depth":304,"text":1209},"Step-by-step Image Per Instance recipes in Blender: separate objects, Geometry Nodes instances, arrays, photo walls, card decks and changing images later.",{},4,"---\ntitle: \"Image Per Instance workflows\"\ndescription: \"Step-by-step Image Per Instance recipes in Blender: separate objects, Geometry Nodes instances, arrays, photo walls, card decks and changing images later.\"\naddon: image-per-instance\norder: 4\nupdated: 2026-11-16\n---\n\nEvery 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](\u002Fdocs\u002Fimage-per-instance\u002Fpanel).\n\n## Different images on separate objects\n\nUse this for frames on a wall, book covers or cards that are individual objects.\n\n1. 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`.\n2. Set **Image Folder** to that folder and pick a **Tile Size**.\n3. 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.\n4. Press **Build Atlas**. The label shows \"Atlas: N images\".\n5. 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.\n\nObjects 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.\n\n## Different images on Geometry Nodes instances\n\nUse this for Instance on Points scatters and collection instances.\n\n1. Build the atlas as above.\n2. Make the object that carries your Geometry Nodes modifier the **active** object. It must be a mesh.\n3. Press **Add To Instances (Geometry Nodes)**.\n4. 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.\n5. 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.\n\nThe 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.\n\n## Arrays and the Array modifier\n\n1. Build the atlas.\n2. Make the object with the Array modifier active.\n3. Press **Add To Instances (Geometry Nodes)**.\n4. If the array source is an object, it is found automatically. If not, select the source and press the button again.\n5. To spread images differently, set **Order** to **Shuffle**, change **Seed**, and press the button again.\n\nThe modifier cycles through the images: with 12 images and 40 instances, the pattern repeats after 12.\n\n![Blender with 12 numbered instances, each showing its own image, and the Image Per Instance panel in the sidebar](\u002Fmedia\u002Fipi-panel-instances.jpg)\n\n## A photo wall or a card deck\n\n1. 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.\n2. Set **Tile Shape** to the card shape (for example 2 : 3) and **Fit** to Fill (crop) or Fit (bars).\n3. If you use Fit (bars), set **Bar Colour**. To make the bars transparent, switch on **Use Image Alpha** under **Material**.\n4. Press **Build Atlas**.\n5. Scatter or array the card, then press **Add To Instances (Geometry Nodes)** on the host.\n6. For a screen wall, switch on **Emissive (screen)** under **Material** and raise **Strength**.\n7. 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.\n\n## Putting a specific image on a specific object\n\n1. Build the atlas.\n2. Select one or more objects. Open **Choose Images Yourself**.\n3. Type a file name in the search field, or set **Image Number**.\n4. Press **Assign Image To Selected**.\n\nFor 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.\n\n## Changing the images later\n\n1. Add, remove or rename images in the folder. Replace images by dropping new files in.\n2. 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.\n3. Changes to **Material**, **Animate** and **Random Variation** apply immediately, with no second button.\n4. Changes to **Seed** or **Order** need another press of **Apply To Selected Objects** or **Add To Instances (Geometry Nodes)**.\n5. To change **Tile Size**, **Tile Shape**, **Fit** or **Padding**, press **Build Atlas** again.\n\n## Animating through the images\n\n1. Build the atlas and apply the images as usual.\n2. Open **Animate**, tick the box in its header, and set **Frames Per Image**.\n3. 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.\n\n## Related\n\n- Product page: [Image Per Instance](\u002Faddons\u002Fimage-per-instance)\n- [Troubleshooting](\u002Fdocs\u002Fimage-per-instance\u002Ftroubleshooting)\n- Guide: [different image per instance in Blender](\u002Fguides\u002Fdifferent-image-per-instance)\n",{"title":1040,"description":2456},"docs\u002Fimage-per-instance\u002Fworkflows","WuHQgMIbTwtxhYNSMzs4I0ljgQEoZvBeUboCTFs0Kn0",{"id":2464,"title":2465,"addon":343,"body":2466,"description":2700,"extension":322,"meta":2701,"navigation":327,"order":2702,"path":225,"rawbody":2703,"seo":2704,"stem":2705,"updated":335,"__hash__":2706},"docs\u002Fdocs\u002Fimage-per-instance\u002Ftroubleshooting.md","Image Per Instance troubleshooting",{"type":8,"value":2467,"toc":2678},[2468,2474,2478,2486,2490,2493,2497,2506,2510,2513,2517,2523,2527,2541,2545,2548,2552,2560,2564,2567,2571,2576,2580,2583,2587,2593,2597,2600,2604,2610,2614,2622,2626,2629,2633,2643,2647,2655,2659,2662,2664],[16,2469,2470,2471,2473],{},"Each answer below uses the message text the add-on shows at the bottom of Blender. If your problem is not here, write to ",[143,2472,1204],{"href":1203}," with your Blender version and the add-on version shown at the bottom of the panel.",[11,2475,2477],{"id":2476},"what-does-choose-an-image-folder-first-mean","What does \"Choose an image folder first\" mean?",[16,2479,2480,2482,2483,2485],{},[23,2481,25],{}," was pressed while ",[23,2484,1165],{}," is empty. Click the folder icon next to Image Folder and choose a folder.",[11,2487,2489],{"id":2488},"why-does-blender-say-no-images-found-in-my-folder","Why does Blender say \"No images found\" in my folder?",[16,2491,2492],{},"The folder exists but holds no supported files directly inside it. Supported types are png, jpg, jpeg, tif, tiff, bmp, webp, exr and tga. Subfolders are not searched, so move the images up one level or point to the subfolder. The message includes the folder path it looked in, so check it for typos.",[11,2494,2496],{"id":2495},"what-if-the-atlas-is-too-big-limit-16384","What if the atlas is too big (limit 16384)?",[16,2498,2499,2500,2502,2503,2505],{},"The message reads \"Atlas would be W x H px (limit 16384). Use a smaller tile size or fewer images\". The atlas can be at most 16384 px on each side. 256 images at 1024 px fit exactly. 257 do not. Lower ",[23,2501,1169],{},", or use fewer images. A non-square ",[23,2504,1590],{}," changes the sizes too.",[11,2507,2509],{"id":2508},"why-does-the-lite-version-say-this-free-version-supports-up-to-20-images","Why does the Lite version say \"This free version supports up to 20 images\"?",[16,2511,2512],{},"Lite builds atlases of up to 20 images. Move extra files out of the folder, or use the full version, which has no image limit in the add-on.",[11,2514,2516],{"id":2515},"why-are-some-images-black-or-missing-in-the-atlas","Why are some images black or missing in the atlas?",[16,2518,2519,2520,2522],{},"If a file cannot be read, ",[23,2521,25],{}," reports \"Skipped\" with the file name and the reason, and that tile stays black. Open the file in Blender's image editor to see whether it loads, or convert it to png or jpg.",[11,2524,2526],{"id":2525},"why-does-blender-say-build-the-atlas-first","Why does Blender say \"Build the atlas first\"?",[16,2528,2529,503,2531,503,2533,209,2535,2537,2538,2540],{},[23,2530,60],{},[23,2532,66],{},[23,2534,208],{},[23,2536,105],{}," need an atlas in the current file. Press ",[23,2539,25],{}," first. The atlas is stored in the .blend, so this also appears in a file where it was never built.",[11,2542,2544],{"id":2543},"why-does-blender-say-select-mesh-objects","Why does Blender say \"Select mesh objects\"?",[16,2546,2547],{},"The buttons act only on selected objects of type mesh. Curves, empties, lights and cameras are ignored.",[11,2549,2551],{"id":2550},"why-does-my-object-show-one-stretched-colour-instead-of-an-image","Why does my object show one stretched colour instead of an image?",[16,2553,2554,2555,2290,2557,2559],{},"The object probably has no UV map, or its UVs do not cover the whole 0 to 1 square, so only a small part of the atlas is sampled. Unwrap the object so the UVs fill the square, or switch ",[23,2556,486],{},[23,2558,1300],{}," to Front, Top or Side (no UVs).",[11,2561,2563],{"id":2562},"why-do-some-faces-look-streaked-with-front-top-or-side-mapping","Why do some faces look streaked with Front, Top or Side mapping?",[16,2565,2566],{},"These modes are one flat projection across the object's bounding box, not triplanar. Faces that point in other directions stretch the image into a streak. Use a UV map for objects where those faces matter.",[11,2568,2570],{"id":2569},"why-does-the-instances-button-say-no-instanced-source-found","Why does the instances button say \"No instanced source found\"?",[16,2572,2573,2574,2410],{},"The full message is \"No instanced source found: select the source objects and press again\". The add-on looks for objects used by Object Info and Collection Info nodes in the host's Geometry Nodes modifiers, including nested groups. If your setup gets its objects some other way, select the source meshes together with the host, keep the host active, and press ",[23,2575,66],{},[11,2577,2579],{"id":2578},"why-does-it-say-make-the-object-with-your-array-instance-on-points-modifier-active","Why does it say \"Make the object with your Array \u002F Instance on Points modifier active\"?",[16,2581,2582],{},"The active object must be a mesh. Click the host in the outliner so it is the active one, then press the button.",[11,2584,2586],{"id":2585},"why-do-my-instances-all-show-the-same-image","Why do my instances all show the same image?",[16,2588,2589,2590,2592],{},"Instances show the material of their source objects, not of the host. Check that the source objects have the shared material in slot 1 (the message after the button lists them). The image index is stored on the instance domain by the last modifier, so instances must still exist at that point. If an earlier modifier or node realizes the instances before the ",[23,2591,70],{}," modifier runs, there is nothing to store the index on. Keep the instances unrealized up to the end of the stack.",[11,2594,2596],{"id":2595},"why-did-my-images-change-after-pressing-build-atlas-again","Why did my images change after pressing Build Atlas again?",[16,2598,2599],{},"The atlas is always in natural file-name order. Rebuilding keeps each object's picture by file name, but if you renamed or removed files, the objects that pointed at them cannot be matched. They keep their old number, which wraps around if it is beyond the new image count.",[11,2601,2603],{"id":2602},"why-does-match-by-object-name-say-press-build-atlas-again","Why does Match By Object Name say \"Press Build Atlas again\"?",[16,2605,2606,2607,2609],{},"The message is \"Press Build Atlas again: this file has no image names stored yet\". The file was built with an older version that did not store the file names. Press ",[23,2608,25],{}," and try again.",[11,2611,2613],{"id":2612},"why-does-match-by-object-name-say-no-object-name-matches-an-image-file-name","Why does Match By Object Name say \"No object name matches an image file name\"?",[16,2615,2616,2617,2619,2620,114],{},"None of the selected objects have a name equal to, or containing, a file name. The match ignores case and a trailing ",[48,2618,1814],{},". Rename the objects, or use ",[23,2621,208],{},[11,2623,2625],{"id":2624},"why-does-assign-image-to-selected-say-the-image-number-is-too-high","Why does Assign Image To Selected say the Image Number is too high?",[16,2627,2628],{},"The message reads \"Image Number N is too high: the atlas has M images\". Lower the number, or rebuild the atlas with more images.",[11,2630,2632],{"id":2631},"why-do-two-files-like-catpng-and-catjpg-appear-as-one-name","Why do two files like cat.png and cat.jpg appear as one name?",[16,2634,2635,2636,2639,2640,2642],{},"The picker uses file names without the extension, so both show as ",[48,2637,2638],{},"cat",". Choose them by ",[23,2641,1768],{}," instead.",[11,2644,2646],{"id":2645},"why-does-shuffle-look-repetitive","Why does Shuffle look repetitive?",[16,2648,2649,2650,2652,2653,114],{},"Shuffle spreads images evenly, but with few images the pattern can show a rhythm. Change ",[23,2651,80],{}," and press the button again, or add ",[23,2654,1306],{},[11,2656,2658],{"id":2657},"do-the-instances-and-the-separate-objects-shuffle-the-same-way","Do the instances and the separate objects shuffle the same way?",[16,2660,2661],{},"No. For separate objects the add-on shuffles the object list with the Seed. For instances the modifier steps through the images with a step that fits the image count and an offset taken from the Seed.",[11,2663,1209],{"id":1208},[39,2665,2666,2670,2674],{},[42,2667,1214,2668],{},[143,2669,326],{"href":328},[42,2671,2672],{},[143,2673,1130],{"href":156},[42,2675,1223,2676],{},[143,2677,162],{"href":161},{"title":303,"searchDepth":304,"depth":304,"links":2679},[2680,2681,2682,2683,2684,2685,2686,2687,2688,2689,2690,2691,2692,2693,2694,2695,2696,2697,2698,2699],{"id":2476,"depth":304,"text":2477},{"id":2488,"depth":304,"text":2489},{"id":2495,"depth":304,"text":2496},{"id":2508,"depth":304,"text":2509},{"id":2515,"depth":304,"text":2516},{"id":2525,"depth":304,"text":2526},{"id":2543,"depth":304,"text":2544},{"id":2550,"depth":304,"text":2551},{"id":2562,"depth":304,"text":2563},{"id":2569,"depth":304,"text":2570},{"id":2578,"depth":304,"text":2579},{"id":2585,"depth":304,"text":2586},{"id":2595,"depth":304,"text":2596},{"id":2602,"depth":304,"text":2603},{"id":2612,"depth":304,"text":2613},{"id":2624,"depth":304,"text":2625},{"id":2631,"depth":304,"text":2632},{"id":2645,"depth":304,"text":2646},{"id":2657,"depth":304,"text":2658},{"id":1208,"depth":304,"text":1209},"Fixes for Image Per Instance in Blender: what each error message means, atlas size limits, missing UVs, instances not found, repeated images and Lite limits.",{},8,"---\ntitle: \"Image Per Instance troubleshooting\"\ndescription: \"Fixes for Image Per Instance in Blender: what each error message means, atlas size limits, missing UVs, instances not found, repeated images and Lite limits.\"\naddon: image-per-instance\norder: 8\nupdated: 2026-11-16\n---\n\nEach answer below uses the message text the add-on shows at the bottom of Blender. If your problem is not here, write to support@mendboxstudio.com with your Blender version and the add-on version shown at the bottom of the panel.\n\n## What does \"Choose an image folder first\" mean?\n\n**Build Atlas** was pressed while **Image Folder** is empty. Click the folder icon next to Image Folder and choose a folder.\n\n## Why does Blender say \"No images found\" in my folder?\n\nThe folder exists but holds no supported files directly inside it. Supported types are png, jpg, jpeg, tif, tiff, bmp, webp, exr and tga. Subfolders are not searched, so move the images up one level or point to the subfolder. The message includes the folder path it looked in, so check it for typos.\n\n## What if the atlas is too big (limit 16384)?\n\nThe message reads \"Atlas would be W x H px (limit 16384). Use a smaller tile size or fewer images\". The atlas can be at most 16384 px on each side. 256 images at 1024 px fit exactly. 257 do not. Lower **Tile Size**, or use fewer images. A non-square **Tile Shape** changes the sizes too.\n\n## Why does the Lite version say \"This free version supports up to 20 images\"?\n\nLite builds atlases of up to 20 images. Move extra files out of the folder, or use the full version, which has no image limit in the add-on.\n\n## Why are some images black or missing in the atlas?\n\nIf a file cannot be read, **Build Atlas** reports \"Skipped\" with the file name and the reason, and that tile stays black. Open the file in Blender's image editor to see whether it loads, or convert it to png or jpg.\n\n## Why does Blender say \"Build the atlas first\"?\n\n**Apply To Selected Objects**, **Add To Instances (Geometry Nodes)**, **Assign Image To Selected** and **Match By Object Name** need an atlas in the current file. Press **Build Atlas** first. The atlas is stored in the .blend, so this also appears in a file where it was never built.\n\n## Why does Blender say \"Select mesh objects\"?\n\nThe buttons act only on selected objects of type mesh. Curves, empties, lights and cameras are ignored.\n\n## Why does my object show one stretched colour instead of an image?\n\nThe object probably has no UV map, or its UVs do not cover the whole 0 to 1 square, so only a small part of the atlas is sampled. Unwrap the object so the UVs fill the square, or switch **Mapping** under **Material** to Front, Top or Side (no UVs).\n\n## Why do some faces look streaked with Front, Top or Side mapping?\n\nThese modes are one flat projection across the object's bounding box, not triplanar. Faces that point in other directions stretch the image into a streak. Use a UV map for objects where those faces matter.\n\n## Why does the instances button say \"No instanced source found\"?\n\nThe full message is \"No instanced source found: select the source objects and press again\". The add-on looks for objects used by Object Info and Collection Info nodes in the host's Geometry Nodes modifiers, including nested groups. If your setup gets its objects some other way, select the source meshes together with the host, keep the host active, and press **Add To Instances (Geometry Nodes)** again.\n\n## Why does it say \"Make the object with your Array \u002F Instance on Points modifier active\"?\n\nThe active object must be a mesh. Click the host in the outliner so it is the active one, then press the button.\n\n## Why do my instances all show the same image?\n\nInstances show the material of their source objects, not of the host. Check that the source objects have the shared material in slot 1 (the message after the button lists them). The image index is stored on the instance domain by the last modifier, so instances must still exist at that point. If an earlier modifier or node realizes the instances before the **IPI Assign Index** modifier runs, there is nothing to store the index on. Keep the instances unrealized up to the end of the stack.\n\n## Why did my images change after pressing Build Atlas again?\n\nThe atlas is always in natural file-name order. Rebuilding keeps each object's picture by file name, but if you renamed or removed files, the objects that pointed at them cannot be matched. They keep their old number, which wraps around if it is beyond the new image count.\n\n## Why does Match By Object Name say \"Press Build Atlas again\"?\n\nThe message is \"Press Build Atlas again: this file has no image names stored yet\". The file was built with an older version that did not store the file names. Press **Build Atlas** and try again.\n\n## Why does Match By Object Name say \"No object name matches an image file name\"?\n\nNone of the selected objects have a name equal to, or containing, a file name. The match ignores case and a trailing `.001`. Rename the objects, or use **Assign Image To Selected**.\n\n## Why does Assign Image To Selected say the Image Number is too high?\n\nThe message reads \"Image Number N is too high: the atlas has M images\". Lower the number, or rebuild the atlas with more images.\n\n## Why do two files like cat.png and cat.jpg appear as one name?\n\nThe picker uses file names without the extension, so both show as `cat`. Choose them by **Image Number** instead.\n\n## Why does Shuffle look repetitive?\n\nShuffle spreads images evenly, but with few images the pattern can show a rhythm. Change **Seed** and press the button again, or add **Random Variation**.\n\n## Do the instances and the separate objects shuffle the same way?\n\nNo. For separate objects the add-on shuffles the object list with the Seed. For instances the modifier steps through the images with a step that fits the image count and an offset taken from the Seed.\n\n## Related\n\n- Product page: [Image Per Instance](\u002Faddons\u002Fimage-per-instance)\n- [Workflows](\u002Fdocs\u002Fimage-per-instance\u002Fworkflows)\n- Guide: [different image per instance in Blender](\u002Fguides\u002Fdifferent-image-per-instance)\n",{"title":2465,"description":2700},"docs\u002Fimage-per-instance\u002Ftroubleshooting","EVdj8OznOTzKrt69rJ8yq1Jb9Lob1CqXBu4VHVfIaVs",{"id":2708,"title":2709,"addon":343,"body":2710,"description":2844,"extension":322,"meta":2845,"navigation":327,"order":2846,"path":300,"rawbody":2847,"seo":2848,"stem":2849,"updated":335,"__hash__":2850},"docs\u002Fdocs\u002Fimage-per-instance\u002Fchangelog.md","Image Per Instance changelog",{"type":8,"value":2711,"toc":2834},[2712,2716,2755,2759,2764,2768,2776,2780,2785,2789,2794,2798,2803,2807,2812,2818,2820],[11,2713,2715],{"id":2714},"_020-2026-11-10","0.2.0 (2026-11-10)",[39,2717,2718,2721,2724,2727,2730,2733,2736,2743,2746,2749,2752],{},[42,2719,2720],{},"Tile shape and fit modes: Stretch, Fit with bars (Bar Colour) and Fill (crop).",[42,2722,2723],{},"Assign Image To Selected, Match By Object Name and an image picker with a search field.",[42,2725,2726],{},"Material options: Use Image Alpha, Emissive (screen) with Strength, and Roughness, applied at once.",[42,2728,2729],{},"Mapping without UVs: Front, Top and Side.",[42,2731,2732],{},"Animate with Frames Per Image.",[42,2734,2735],{},"Random Variation: Hue, Saturation, Brightness, Flip X and Flip Y.",[42,2737,2738,2739,2152,2741,114],{},"Natural file order, so ",[48,2740,50],{},[48,2742,54],{},[42,2744,2745],{},"Build Atlas again keeps each object's picture, matched by file name.",[42,2747,2748],{},"Fixed brightness of 16-bit and EXR source images.",[42,2750,2751],{},"The 3D view now redraws right after a button press.",[42,2753,2754],{},"With Order set to Shuffle, the atlas stays in file-name order.",[11,2756,2758],{"id":2757},"_017-2026-10-03","0.1.7 (2026-10-03)",[39,2760,2761],{},[42,2762,2763],{},"The image goes only on material slot 1. Other slots on your source object stay untouched.",[11,2765,2767],{"id":2766},"_016","0.1.6",[39,2769,2770,2773],{},[42,2771,2772],{},"An empty or wrong folder gives a clear error message.",[42,2774,2775],{},"The version is shown in the panel.",[11,2777,2779],{"id":2778},"_015","0.1.5",[39,2781,2782],{},[42,2783,2784],{},"Shuffle never reverses the order.",[11,2786,2788],{"id":2787},"_014","0.1.4",[39,2790,2791],{},[42,2792,2793],{},"Version number added to the panel.",[11,2795,2797],{"id":2796},"_013","0.1.3",[39,2799,2800],{},[42,2801,2802],{},"Shuffle spreads images instead of shifting them.",[11,2804,2806],{"id":2805},"_012-and-earlier","0.1.2 and earlier",[39,2808,2809],{},[42,2810,2811],{},"First working builds, Geometry Nodes instances and fixes from testing in the Blender interface.",[16,2813,2814,2815,2817],{},"The free Lite version has its own history: Lite 0.2.0 added natural file order, the brightness fix for 16-bit and EXR images, the redraw fix and a rebuild that keeps pictures, and Lite 0.1.7 put the image on slot 1 only. See the ",[143,2816,264],{"href":263}," for what Lite includes.",[11,2819,1209],{"id":1208},[39,2821,2822,2826,2830],{},[42,2823,1214,2824],{},[143,2825,326],{"href":328},[42,2827,2828],{},[143,2829,1140],{"href":225},[42,2831,1223,2832],{},[143,2833,162],{"href":161},{"title":303,"searchDepth":304,"depth":304,"links":2835},[2836,2837,2838,2839,2840,2841,2842,2843],{"id":2714,"depth":304,"text":2715},{"id":2757,"depth":304,"text":2758},{"id":2766,"depth":304,"text":2767},{"id":2778,"depth":304,"text":2779},{"id":2787,"depth":304,"text":2788},{"id":2796,"depth":304,"text":2797},{"id":2805,"depth":304,"text":2806},{"id":1208,"depth":304,"text":1209},"Version history of the Image Per Instance Blender add-on, newest first: what changed in 0.2.0, 0.1.7 and the earlier builds, with release dates where known.",{},9,"---\ntitle: \"Image Per Instance changelog\"\ndescription: \"Version history of the Image Per Instance Blender add-on, newest first: what changed in 0.2.0, 0.1.7 and the earlier builds, with release dates where known.\"\naddon: image-per-instance\norder: 9\nupdated: 2026-11-16\n---\n\n## 0.2.0 (2026-11-10)\n\n- Tile shape and fit modes: Stretch, Fit with bars (Bar Colour) and Fill (crop).\n- Assign Image To Selected, Match By Object Name and an image picker with a search field.\n- Material options: Use Image Alpha, Emissive (screen) with Strength, and Roughness, applied at once.\n- Mapping without UVs: Front, Top and Side.\n- Animate with Frames Per Image.\n- Random Variation: Hue, Saturation, Brightness, Flip X and Flip Y.\n- Natural file order, so `img2` comes before `img10`.\n- Build Atlas again keeps each object's picture, matched by file name.\n- Fixed brightness of 16-bit and EXR source images.\n- The 3D view now redraws right after a button press.\n- With Order set to Shuffle, the atlas stays in file-name order.\n\n## 0.1.7 (2026-10-03)\n\n- The image goes only on material slot 1. Other slots on your source object stay untouched.\n\n## 0.1.6\n\n- An empty or wrong folder gives a clear error message.\n- The version is shown in the panel.\n\n## 0.1.5\n\n- Shuffle never reverses the order.\n\n## 0.1.4\n\n- Version number added to the panel.\n\n## 0.1.3\n\n- Shuffle spreads images instead of shifting them.\n\n## 0.1.2 and earlier\n\n- First working builds, Geometry Nodes instances and fixes from testing in the Blender interface.\n\nThe free Lite version has its own history: Lite 0.2.0 added natural file order, the brightness fix for 16-bit and EXR images, the redraw fix and a rebuild that keeps pictures, and Lite 0.1.7 put the image on slot 1 only. See the [install page](\u002Fdocs\u002Fimage-per-instance\u002Finstall) for what Lite includes.\n\n## Related\n\n- Product page: [Image Per Instance](\u002Faddons\u002Fimage-per-instance)\n- [Troubleshooting](\u002Fdocs\u002Fimage-per-instance\u002Ftroubleshooting)\n- Guide: [different image per instance in Blender](\u002Fguides\u002Fdifferent-image-per-instance)\n",{"title":2709,"description":2844},"docs\u002Fimage-per-instance\u002Fchangelog","GwUn4ednbvLPBscpfzb5yrxirLsRPy2DWwRogjh9_P0",1794858941685]