[{"data":1,"prerenderedAt":2245},["ShallowReactive",2],{"\u002Fdocs\u002Fimage-per-instance\u002Fchangelog":3,"\u002Fdocs\u002Fimage-per-instance\u002Fchangelog-siblings":177,"\u002Fdocs\u002Fimage-per-instance\u002Fchangelog-addon":1957},{"id":4,"title":5,"addon":6,"body":7,"description":166,"extension":167,"meta":168,"navigation":169,"order":170,"path":171,"rawbody":172,"seo":173,"stem":174,"updated":175,"__hash__":176},"docs\u002Fdocs\u002Fimage-per-instance\u002Fchangelog.md","Image Per Instance changelog","image-per-instance",{"type":8,"value":9,"toc":154},"minimark",[10,15,61,65,70,74,82,86,91,95,100,104,109,113,118,128,132],[11,12,14],"h2",{"id":13},"_020-2026-11-10","0.2.0 (2026-11-10)",[16,17,18,22,25,28,31,34,37,49,52,55,58],"ul",{},[19,20,21],"li",{},"Tile shape and fit modes: Stretch, Fit with bars (Bar Colour) and Fill (crop).",[19,23,24],{},"Assign Image To Selected, Match By Object Name and an image picker with a search field.",[19,26,27],{},"Material options: Use Image Alpha, Emissive (screen) with Strength, and Roughness, applied at once.",[19,29,30],{},"Mapping without UVs: Front, Top and Side.",[19,32,33],{},"Animate with Frames Per Image.",[19,35,36],{},"Random Variation: Hue, Saturation, Brightness, Flip X and Flip Y.",[19,38,39,40,44,45,48],{},"Natural file order, so ",[41,42,43],"code",{},"img2"," comes before ",[41,46,47],{},"img10",".",[19,50,51],{},"Build Atlas again keeps each object's picture, matched by file name.",[19,53,54],{},"Fixed brightness of 16-bit and EXR source images.",[19,56,57],{},"The 3D view now redraws right after a button press.",[19,59,60],{},"With Order set to Shuffle, the atlas stays in file-name order.",[11,62,64],{"id":63},"_017-2026-10-03","0.1.7 (2026-10-03)",[16,66,67],{},[19,68,69],{},"The image goes only on material slot 1. Other slots on your source object stay untouched.",[11,71,73],{"id":72},"_016","0.1.6",[16,75,76,79],{},[19,77,78],{},"An empty or wrong folder gives a clear error message.",[19,80,81],{},"The version is shown in the panel.",[11,83,85],{"id":84},"_015","0.1.5",[16,87,88],{},[19,89,90],{},"Shuffle never reverses the order.",[11,92,94],{"id":93},"_014","0.1.4",[16,96,97],{},[19,98,99],{},"Version number added to the panel.",[11,101,103],{"id":102},"_013","0.1.3",[16,105,106],{},[19,107,108],{},"Shuffle spreads images instead of shifting them.",[11,110,112],{"id":111},"_012-and-earlier","0.1.2 and earlier",[16,114,115],{},[19,116,117],{},"First working builds, Geometry Nodes instances and fixes from testing in the Blender interface.",[119,120,121,122,127],"p",{},"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 ",[123,124,126],"a",{"href":125},"\u002Fdocs\u002Fimage-per-instance\u002Finstall","install page"," for what Lite includes.",[11,129,131],{"id":130},"related","Related",[16,133,134,141,147],{},[19,135,136,137],{},"Product page: ",[123,138,140],{"href":139},"\u002Faddons\u002Fimage-per-instance","Image Per Instance",[19,142,143],{},[123,144,146],{"href":145},"\u002Fdocs\u002Fimage-per-instance\u002Ftroubleshooting","Troubleshooting",[19,148,149,150],{},"Guide: ",[123,151,153],{"href":152},"\u002Fguides\u002Fdifferent-image-per-instance","different image per instance in Blender",{"title":155,"searchDepth":156,"depth":156,"links":157},"",2,[158,159,160,161,162,163,164,165],{"id":13,"depth":156,"text":14},{"id":63,"depth":156,"text":64},{"id":72,"depth":156,"text":73},{"id":84,"depth":156,"text":85},{"id":93,"depth":156,"text":94},{"id":102,"depth":156,"text":103},{"id":111,"depth":156,"text":112},{"id":130,"depth":156,"text":131},"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.","md",{},true,9,"\u002Fdocs\u002Fimage-per-instance\u002Fchangelog","---\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":5,"description":166},"docs\u002Fimage-per-instance\u002Fchangelog","2026-11-16","GwUn4ednbvLPBscpfzb5yrxirLsRPy2DWwRogjh9_P0",[178,359,663,1258,1610,1854],{"id":179,"title":180,"addon":6,"body":181,"description":351,"extension":167,"meta":352,"navigation":169,"order":353,"path":354,"rawbody":355,"seo":356,"stem":357,"updated":175,"__hash__":358},"docs\u002Fdocs\u002Fimage-per-instance\u002Findex.md","Image Per Instance documentation",{"type":8,"value":182,"toc":344},[183,187,192,195,199,270,274,310,316,320,328,330],[11,184,186],{"id":185},"what-this-add-on-does","What this add-on does",[119,188,189,191],{},[123,190,140],{"href":139}," 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.",[119,193,194],{},"This documentation covers version 0.2.0 for Blender 4.2 and newer.",[11,196,198],{"id":197},"pages","Pages",[200,201,202,215],"table",{},[203,204,205],"thead",{},[206,207,208,212],"tr",{},[209,210,211],"th",{},"Page",[209,213,214],{},"What is in it",[216,217,218,229,240,251,260],"tbody",{},[206,219,220,226],{},[221,222,223],"td",{},[123,224,225],{"href":125},"Install",[221,227,228],{},"Installing the zip, where the panel is, updating, removing, Lite versus full",[206,230,231,237],{},[221,232,233],{},[123,234,236],{"href":235},"\u002Fdocs\u002Fimage-per-instance\u002Fpanel","Panel reference",[221,238,239],{},"Every field, button and option with defaults and ranges",[206,241,242,248],{},[221,243,244],{},[123,245,247],{"href":246},"\u002Fdocs\u002Fimage-per-instance\u002Fworkflows","Workflows",[221,249,250],{},"Step-by-step recipes for objects, Geometry Nodes instances, arrays, photo walls and later changes",[206,252,253,257],{},[221,254,255],{},[123,256,146],{"href":145},[221,258,259],{},"Error messages and limits, and what to do about each",[206,261,262,267],{},[221,263,264],{},[123,265,266],{"href":171},"Changelog",[221,268,269],{},"What changed in each version",[11,271,273],{"id":272},"the-idea-in-one-minute","The idea in one minute",[275,276,277,292,299],"ol",{},[19,278,279,280,284,285,288,289,48],{},"Choose an ",[281,282,283],"strong",{},"Image Folder"," and a ",[281,286,287],{},"Tile Size",", then press ",[281,290,291],{},"Build Atlas",[19,293,294,295,298],{},"If the pictures go on separate meshes, select those meshes and press ",[281,296,297],{},"Apply To Selected Objects",". Each one gets its own tile.",[19,300,301,302,305,306,309],{},"If you use an Array modifier or Instance on Points, click the host object so it is active and press ",[281,303,304],{},"Add To Instances (Geometry Nodes)",". The add-on finds the objects being instanced, gives them the shared material and adds an ",[281,307,308],{},"IPI Assign Index"," modifier to the host.",[119,311,312,313,315],{},"If you are new to the problem, read the guide ",[123,314,153],{"href":152}," first. It explains the manual method and why an atlas helps.",[11,317,319],{"id":318},"support","Support",[119,321,322,323,327],{},"Write to ",[123,324,326],{"href":325},"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,329,131],{"id":130},[16,331,332,336,340],{},[19,333,136,334],{},[123,335,140],{"href":139},[19,337,338],{},[123,339,146],{"href":145},[19,341,149,342],{},[123,343,153],{"href":152},{"title":155,"searchDepth":156,"depth":156,"links":345},[346,347,348,349,350],{"id":185,"depth":156,"text":186},{"id":197,"depth":156,"text":198},{"id":272,"depth":156,"text":273},{"id":318,"depth":156,"text":319},{"id":130,"depth":156,"text":131},"Docs for Image Per Instance, the Blender add-on that gives every object or instance its own image: install, panel reference, workflows and troubleshooting.",{},1,"\u002Fdocs\u002Fimage-per-instance","---\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":180,"description":351},"docs\u002Fimage-per-instance\u002Findex","nvPcxYtdq4OoSWwvD1tI5AeAY9jaK-lqeCAIxutySt0",{"id":360,"title":361,"addon":6,"body":362,"description":657,"extension":167,"meta":658,"navigation":169,"order":156,"path":125,"rawbody":659,"seo":660,"stem":661,"updated":175,"__hash__":662},"docs\u002Fdocs\u002Fimage-per-instance\u002Finstall.md","Install Image Per Instance in Blender",{"type":8,"value":363,"toc":648},[364,368,371,375,395,399,415,437,441,450,454,475,479,491,620,623,632,634],[11,365,367],{"id":366},"requirements","Requirements",[119,369,370],{},"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,372,374],{"id":373},"install-from-disk","Install from disk",[275,376,377,380,386,392],{},[19,378,379],{},"Download the zip from Gumroad or Superhive. Do not unzip it.",[19,381,382,383,48],{},"In Blender open ",[281,384,385],{},"Edit > Preferences > Get Extensions",[19,387,388,389,48],{},"Open the arrow menu at the top right and choose ",[281,390,391],{},"Install from Disk",[19,393,394],{},"Pick the zip file.",[11,396,398],{"id":397},"where-the-panel-is","Where the panel is",[119,400,401,402,405,406,408,409,411,412,48],{},"Hover over the 3D viewport and press ",[281,403,404],{},"N"," to open the sidebar. The add-on has its own tab named ",[281,407,140],{},". The panel inside it is called ",[281,410,140],{},", and the version number is shown at the bottom, for example ",[41,413,414],{},"Image Per Instance v0.2.0",[119,416,417,418,421,422,421,425,428,429,432,433,436],{},"Four sub-panels sit below the main buttons and start collapsed: ",[281,419,420],{},"Choose Images Yourself",", ",[281,423,424],{},"Material",[281,426,427],{},"Animate"," and ",[281,430,431],{},"Random Variation",". The ",[123,434,435],{"href":235},"panel reference"," describes all of them.",[11,438,440],{"id":439},"update","Update",[119,442,443,444,446,447,449],{},"Install the newer zip with ",[281,445,391],{}," in the same way. Check the version at the bottom of the panel afterwards. Pressing ",[281,448,291],{}," again keeps each object's picture when the file names are the same.",[11,451,453],{"id":452},"uninstall","Uninstall",[119,455,456,457,459,460,463,464,467,468,471,472,474],{},"Open ",[281,458,385],{},", find the add-on in the list and remove it. What the add-on created in your file is ordinary Blender data: the material ",[41,461,462],{},"IPI_Material",", the atlas image ",[41,465,466],{},"IPI_Atlas",", a custom property ",[41,469,470],{},"img_index"," on separate objects, and a modifier named ",[41,473,308],{}," on instance hosts. You can delete these by hand if you no longer need them.",[11,476,478],{"id":477},"lite-versus-full","Lite versus full",[119,480,481,482,488,489,48],{},"The free ",[123,483,487],{"href":484,"rel":485},"https:\u002F\u002Fgithub.com\u002Fmendbox\u002Fimage-per-instance-lite",[486],"nofollow","Image Per Instance Lite"," is a separate download. Its tab is named ",[281,490,487],{},[200,492,493,506],{},[203,494,495],{},[206,496,497,500,503],{},[209,498,499],{},"Feature",[209,501,502],{},"Lite",[209,504,505],{},"Full",[216,507,508,518,527,538,547,557,566,575,584,593,602,611],{},[206,509,510,513,516],{},[221,511,512],{},"Build Atlas from a folder, Apply To Selected Objects",[221,514,515],{},"yes",[221,517,515],{},[206,519,520,523,525],{},[221,521,522],{},"One shared material",[221,524,515],{},[221,526,515],{},[206,528,529,532,535],{},[221,530,531],{},"Images per atlas",[221,533,534],{},"up to 20",[221,536,537],{},"no limit in the add-on",[206,539,540,543,545],{},[221,541,542],{},"Natural file order",[221,544,515],{},[221,546,515],{},[206,548,549,552,555],{},[221,550,551],{},"Geometry Nodes instances, Array modifier",[221,553,554],{},"no",[221,556,515],{},[206,558,559,562,564],{},[221,560,561],{},"Shuffle",[221,563,554],{},[221,565,515],{},[206,567,568,571,573],{},[221,569,570],{},"Tile shape and fit modes",[221,572,554],{},[221,574,515],{},[206,576,577,580,582],{},[221,578,579],{},"Assign by number, name or picker",[221,581,554],{},[221,583,515],{},[206,585,586,589,591],{},[221,587,588],{},"Alpha and emission",[221,590,554],{},[221,592,515],{},[206,594,595,598,600],{},[221,596,597],{},"Mapping without UVs",[221,599,554],{},[221,601,515],{},[206,603,604,607,609],{},[221,605,606],{},"Animation",[221,608,554],{},[221,610,515],{},[206,612,613,616,618],{},[221,614,615],{},"Random variation",[221,617,554],{},[221,619,515],{},[119,621,622],{},"When Lite finds more than 20 images, it stops with the message \"This free version supports up to 20 images\".",[119,624,625,626,628,629,48],{},"Next: the ",[123,627,435],{"href":235}," or the ",[123,630,631],{"href":246},"workflows",[11,633,131],{"id":130},[16,635,636,640,644],{},[19,637,136,638],{},[123,639,140],{"href":139},[19,641,642],{},[123,643,146],{"href":145},[19,645,149,646],{},[123,647,153],{"href":152},{"title":155,"searchDepth":156,"depth":156,"links":649},[650,651,652,653,654,655,656],{"id":366,"depth":156,"text":367},{"id":373,"depth":156,"text":374},{"id":397,"depth":156,"text":398},{"id":439,"depth":156,"text":440},{"id":452,"depth":156,"text":453},{"id":477,"depth":156,"text":478},{"id":130,"depth":156,"text":131},"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":361,"description":657},"docs\u002Fimage-per-instance\u002Finstall","XImq1D0SPLXcR1dDWHpVYP8bVTntBVzsgcH9KLvsNlA",{"id":664,"title":665,"addon":6,"body":666,"description":1251,"extension":167,"meta":1252,"navigation":169,"order":1253,"path":235,"rawbody":1254,"seo":1255,"stem":1256,"updated":175,"__hash__":1257},"docs\u002Fdocs\u002Fimage-per-instance\u002Fpanel.md","Image Per Instance panel reference",{"type":8,"value":667,"toc":1241},[668,677,681,804,808,871,880,883,886,956,959,962,1043,1046,1049,1084,1087,1090,1155,1159,1216,1225,1227],[119,669,670,671,673,674,676],{},"All controls live in the 3D viewport sidebar (",[281,672,404],{},"), in the ",[281,675,140],{}," tab. This page follows the panel from top to bottom. Version 0.2.0.",[11,678,680],{"id":679},"main-panel-atlas-settings","Main panel: atlas settings",[200,682,683,696],{},[203,684,685],{},[206,686,687,690,693],{},[209,688,689],{},"Control",[209,691,692],{},"What it does",[209,694,695],{},"Default \u002F range",[216,697,698,708,718,729,751,764,775,791],{},[206,699,700,702,705],{},[221,701,283],{},[221,703,704],{},"Folder with your images. Only files directly inside it are read, not subfolders. Supported types: png, jpg, jpeg, tif, tiff, bmp, webp, exr, tga.",[221,706,707],{},"empty",[206,709,710,712,715],{},[221,711,287],{},[221,713,714],{},"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.",[221,716,717],{},"512 px",[206,719,720,723,726],{},[221,721,722],{},"Tile Shape",[221,724,725],{},"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.",[221,727,728],{},"1 : 1",[206,730,731,734,749],{},[221,732,733],{},"Fit",[221,735,736,737,740,741,744,745,748],{},"What happens when an image has a different shape than the tile. ",[281,738,739],{},"Stretch"," fills the tile and distorts the image. ",[281,742,743],{},"Fit (bars)"," shows the whole image with bars around it. ",[281,746,747],{},"Fill (crop)"," covers the whole tile and crops the edges.",[221,750,739],{},[206,752,753,756,761],{},[221,754,755],{},"Bar Colour",[221,757,758,759,48],{},"Colour of the bars. Only shown when Fit is ",[281,760,743],{},[221,762,763],{},"black, 0 to 1 per channel",[206,765,766,769,772],{},[221,767,768],{},"Padding",[221,770,771],{},"Edge padding in pixels that hides bleeding between neighbouring tiles.",[221,773,774],{},"4, range 0 to 32",[206,776,777,780,789],{},[221,778,779],{},"Order",[221,781,782,785,786,788],{},[281,783,784],{},"By file name"," or ",[281,787,561],{},". Shuffle uses every image once before any repeats. It changes which image an object or instance gets, not the order inside the atlas.",[221,790,784],{},[206,792,793,796,801],{},[221,794,795],{},"Seed",[221,797,798,799,48],{},"Picks the shuffled arrangement. Only shown when Order is ",[281,800,561],{},[221,802,803],{},"1",[11,805,807],{"id":806},"main-panel-buttons-and-labels","Main panel: buttons and labels",[200,809,810,818],{},[203,811,812],{},[206,813,814,816],{},[209,815,689],{},[209,817,692],{},[216,819,820,827,835,848,855,863],{},[206,821,822,824],{},[221,823,291],{},[221,825,826],{},"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.",[206,828,829,832],{},[221,830,831],{},"Atlas label",[221,833,834],{},"Shows \"Atlas: N images\", or \"Atlas: not built\" before the first build.",[206,836,837,839],{},[221,838,297],{},[221,840,841,842,844,845,847],{},"Gives each selected mesh object its own image and puts the shared material on it. With Order ",[281,843,784],{},", 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 ",[281,846,561],{},", the objects are shuffled using the Seed.",[206,849,850,852],{},[221,851,304],{},[221,853,854],{},"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.",[206,856,857,860],{},[221,858,859],{},"\"Press again after changing Seed to re-shuffle\"",[221,861,862],{},"A hint. Change Seed, then press Apply To Selected Objects or Add To Instances again.",[206,864,865,868],{},[221,866,867],{},"Version label",[221,869,870],{},"\"Image Per Instance v\" followed by the version number.",[119,872,873,874,876,877,879],{},"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 ",[41,875,466],{},", the material ",[41,878,462],{},". The atlas can be at most 16384 px on each side.",[11,881,420],{"id":882},"choose-images-yourself",[119,884,885],{},"Collapsed by default. Applies to separate objects only, as the panel says.",[200,887,888,898],{},[203,889,890],{},[206,891,892,894,896],{},[209,893,689],{},[209,895,692],{},[209,897,695],{},[216,899,900,911,921,931],{},[206,901,902,905,908],{},[221,903,904],{},"Image Number",[221,906,907],{},"Number of the image in the atlas. 1 is the first file. Changing it updates the Image field.",[221,909,910],{},"1, minimum 1",[206,912,913,916,919],{},[221,914,915],{},"Image (search field)",[221,917,918],{},"Pick the image by file name, you can type to search. Choosing a name sets Image Number.",[221,920,707],{},[206,922,923,926,929],{},[221,924,925],{},"Assign Image To Selected",[221,927,928],{},"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.",[221,930],{},[206,932,933,936,954],{},[221,934,935],{},"Match By Object Name",[221,937,938,939,942,943,946,947,949,950,953],{},"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 (",[41,940,941],{},"card_10"," gets ",[41,944,945],{},"10",", not ",[41,948,803],{},"), then the longest file name contained in the name. A Blender duplicate suffix such as ",[41,951,952],{},".001"," is ignored, and case does not matter. Objects without a match are listed in the message.",[221,955],{},[11,957,424],{"id":958},"material",[119,960,961],{},"Collapsed by default. These options update the material at once, without pressing a button again, as long as the atlas is built.",[200,963,964,974],{},[203,965,966],{},[206,967,968,970,972],{},[209,969,689],{},[209,971,692],{},[209,973,695],{},[216,975,976,1000,1011,1021,1032],{},[206,977,978,981,998],{},[221,979,980],{},"Mapping",[221,982,983,984,987,988,421,991,428,994,997],{},"Where the image sits on the object. ",[281,985,986],{},"UV Map"," uses the object's UV map, which must fill the 0 to 1 square. ",[281,989,990],{},"Front (no UVs)",[281,992,993],{},"Top (no UVs)",[281,995,996],{},"Side (no UVs)"," project the image across the whole object from the front, top or right side.",[221,999,986],{},[206,1001,1002,1005,1008],{},[221,1003,1004],{},"Use Image Alpha",[221,1006,1007],{},"PNG transparency cuts the shape out (stickers, round cards, the bars of Fit mode). Sets the material render method to Dithered.",[221,1009,1010],{},"off",[206,1012,1013,1016,1019],{},[221,1014,1015],{},"Emissive (screen)",[221,1017,1018],{},"The image glows by itself, for video walls, billboards and screens.",[221,1020,1010],{},[206,1022,1023,1026,1029],{},[221,1024,1025],{},"Strength",[221,1027,1028],{},"Emission strength. Only shown when Emissive is on.",[221,1030,1031],{},"1.0, minimum 0, soft maximum 10",[206,1033,1034,1037,1040],{},[221,1035,1036],{},"Roughness",[221,1038,1039],{},"Roughness of the material.",[221,1041,1042],{},"0.5, range 0 to 1",[11,1044,427],{"id":1045},"animate",[119,1047,1048],{},"Collapsed by default. The checkbox in the sub-panel header switches animation on.",[200,1050,1051,1061],{},[203,1052,1053],{},[206,1054,1055,1057,1059],{},[209,1056,689],{},[209,1058,692],{},[209,1060,695],{},[216,1062,1063,1073],{},[206,1064,1065,1068,1071],{},[221,1066,1067],{},"Animate (checkbox)",[221,1069,1070],{},"Every object steps through the images over time, each starting at its own image.",[221,1072,1010],{},[206,1074,1075,1078,1081],{},[221,1076,1077],{},"Frames Per Image",[221,1079,1080],{},"How many frames each image stays before the next one.",[221,1082,1083],{},"24, minimum 1, soft maximum 240",[11,1085,431],{"id":1086},"random-variation",[119,1088,1089],{},"Collapsed by default. All values start at zero, which adds no nodes to the material.",[200,1091,1092,1102],{},[203,1093,1094],{},[206,1095,1096,1098,1100],{},[209,1097,689],{},[209,1099,692],{},[209,1101,695],{},[216,1103,1104,1115,1125,1135,1145],{},[206,1105,1106,1109,1112],{},[221,1107,1108],{},"Hue",[221,1110,1111],{},"Random hue shift per object.",[221,1113,1114],{},"0, range 0 to 1",[206,1116,1117,1120,1123],{},[221,1118,1119],{},"Saturation",[221,1121,1122],{},"Random saturation change per object.",[221,1124,1114],{},[206,1126,1127,1130,1133],{},[221,1128,1129],{},"Brightness",[221,1131,1132],{},"Random brightness change per object.",[221,1134,1114],{},[206,1136,1137,1140,1143],{},[221,1138,1139],{},"Flip X",[221,1141,1142],{},"Mirrors a random half of the objects left to right.",[221,1144,1010],{},[206,1146,1147,1150,1153],{},[221,1148,1149],{},"Flip Y",[221,1151,1152],{},"Mirrors a random half of the objects top to bottom.",[221,1154,1010],{},[11,1156,1158],{"id":1157},"what-the-add-on-creates-in-your-file","What the add-on creates in your file",[200,1160,1161,1171],{},[203,1162,1163],{},[206,1164,1165,1168],{},[209,1166,1167],{},"Name",[209,1169,1170],{},"What it is",[216,1172,1173,1182,1191,1200],{},[206,1174,1175,1179],{},[221,1176,1177],{},[41,1178,466],{},[221,1180,1181],{},"The packed atlas image",[206,1183,1184,1188],{},[221,1185,1186],{},[41,1187,462],{},[221,1189,1190],{},"The shared material, used in slot 1 of each affected object",[206,1192,1193,1197],{},[221,1194,1195],{},[41,1196,470],{},[221,1198,1199],{},"Custom property on separate objects holding the image index (the first image is 0)",[206,1201,1202,1206],{},[221,1203,1204],{},[41,1205,308],{},[221,1207,1208,1209,1212,1213,1215],{},"Geometry Nodes modifier on the host, using the node group ",[41,1210,1211],{},"IPI_Assign_Index"," with inputs Image Count, Shuffle, Seed and Shuffle Step. It stores ",[41,1214,470],{}," on every instance.",[119,1217,1218,1219,1221,1222,48],{},"For recipes, see the ",[123,1220,631],{"href":246},". For problems, see ",[123,1223,1224],{"href":145},"troubleshooting",[11,1226,131],{"id":130},[16,1228,1229,1233,1237],{},[19,1230,136,1231],{},[123,1232,140],{"href":139},[19,1234,1235],{},[123,1236,146],{"href":145},[19,1238,149,1239],{},[123,1240,153],{"href":152},{"title":155,"searchDepth":156,"depth":156,"links":1242},[1243,1244,1245,1246,1247,1248,1249,1250],{"id":679,"depth":156,"text":680},{"id":806,"depth":156,"text":807},{"id":882,"depth":156,"text":420},{"id":958,"depth":156,"text":424},{"id":1045,"depth":156,"text":427},{"id":1086,"depth":156,"text":431},{"id":1157,"depth":156,"text":1158},{"id":130,"depth":156,"text":131},"Every field, button and option of the Image Per Instance panel in Blender: atlas settings, material, animation and random variation, with defaults and ranges.",{},3,"---\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":665,"description":1251},"docs\u002Fimage-per-instance\u002Fpanel","N-1LWe8YGeCnfGgAY49syq9q-tLfOayf5wOWzx0sG1k",{"id":1259,"title":1260,"addon":6,"body":1261,"description":1603,"extension":167,"meta":1604,"navigation":169,"order":1605,"path":246,"rawbody":1606,"seo":1607,"stem":1608,"updated":175,"__hash__":1609},"docs\u002Fdocs\u002Fimage-per-instance\u002Fworkflows.md","Image Per Instance workflows",{"type":8,"value":1262,"toc":1593},[1263,1274,1278,1281,1325,1334,1338,1341,1363,1369,1373,1400,1403,1410,1414,1472,1476,1494,1508,1512,1558,1562,1577,1579],[119,1264,1265,1266,1268,1269,1271,1272,48],{},"Every recipe starts the same way: open the sidebar with ",[281,1267,404],{}," and go to the ",[281,1270,140],{}," tab. Names of controls are explained in the ",[123,1273,435],{"href":235},[11,1275,1277],{"id":1276},"different-images-on-separate-objects","Different images on separate objects",[119,1279,1280],{},"Use this for frames on a wall, book covers or cards that are individual objects.",[275,1282,1283,1297,1305,1313,1319],{},[19,1284,1285,1286,421,1289,1292,1293,44,1295,48],{},"Put your images in one folder, named so they sort the way you want (",[41,1287,1288],{},"01.jpg",[41,1290,1291],{},"02.jpg"," and so on). Sorting is natural, so ",[41,1294,43],{},[41,1296,47],{},[19,1298,1299,1300,1302,1303,48],{},"Set ",[281,1301,283],{}," to that folder and pick a ",[281,1304,287],{},[19,1306,1299,1307,1309,1310,1312],{},[281,1308,722],{}," to the shape of your objects, for example 2 : 3 for book covers, and ",[281,1311,733],{}," to Fill (crop) if you do not want distortion.",[19,1314,1315,1316,1318],{},"Press ",[281,1317,291],{},". The label shows \"Atlas: N images\".",[19,1320,1321,1322,1324],{},"Select the mesh objects and press ",[281,1323,297],{},". Objects are taken in name order and get image 1, 2, 3 and so on.",[119,1326,1327,1328,1330,1331,1333],{},"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 ",[281,1329,424],{}," and set ",[281,1332,980],{}," to Front, Top or Side first.",[11,1335,1337],{"id":1336},"different-images-on-geometry-nodes-instances","Different images on Geometry Nodes instances",[119,1339,1340],{},"Use this for Instance on Points scatters and collection instances.",[275,1342,1343,1346,1353,1357,1360],{},[19,1344,1345],{},"Build the atlas as above.",[19,1347,1348,1349,1352],{},"Make the object that carries your Geometry Nodes modifier the ",[281,1350,1351],{},"active"," object. It must be a mesh.",[19,1354,1315,1355,48],{},[281,1356,304],{},[19,1358,1359],{},"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.",[19,1361,1362],{},"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.",[119,1364,1365,1366,1368],{},"The add-on puts the ",[281,1367,308],{}," modifier last in the host's modifier stack. It stores an image index on every instance, and the material reads it.",[11,1370,1372],{"id":1371},"arrays-and-the-array-modifier","Arrays and the Array modifier",[275,1374,1375,1378,1381,1385,1388],{},[19,1376,1377],{},"Build the atlas.",[19,1379,1380],{},"Make the object with the Array modifier active.",[19,1382,1315,1383,48],{},[281,1384,304],{},[19,1386,1387],{},"If the array source is an object, it is found automatically. If not, select the source and press the button again.",[19,1389,1390,1391,1393,1394,1396,1397,1399],{},"To spread images differently, set ",[281,1392,779],{}," to ",[281,1395,561],{},", change ",[281,1398,795],{},", and press the button again.",[119,1401,1402],{},"The modifier cycles through the images: with 12 images and 40 instances, the pattern repeats after 12.",[119,1404,1405],{},[1406,1407],"img",{"alt":1408,"src":1409},"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,1411,1413],{"id":1412},"a-photo-wall-or-a-card-deck","A photo wall or a card deck",[275,1415,1416,1419,1427,1438,1442,1448,1458],{},[19,1417,1418],{},"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.",[19,1420,1299,1421,1423,1424,1426],{},[281,1422,722],{}," to the card shape (for example 2 : 3) and ",[281,1425,733],{}," to Fill (crop) or Fit (bars).",[19,1428,1429,1430,1432,1433,1435,1436,48],{},"If you use Fit (bars), set ",[281,1431,755],{},". To make the bars transparent, switch on ",[281,1434,1004],{}," under ",[281,1437,424],{},[19,1439,1315,1440,48],{},[281,1441,291],{},[19,1443,1444,1445,1447],{},"Scatter or array the card, then press ",[281,1446,304],{}," on the host.",[19,1449,1450,1451,1435,1453,1455,1456,48],{},"For a screen wall, switch on ",[281,1452,1015],{},[281,1454,424],{}," and raise ",[281,1457,1025],{},[19,1459,1460,1461,1393,1463,1465,1466,1468,1469,1471],{},"For a card deck where you want the images to look random, set ",[281,1462,779],{},[281,1464,561],{},". Under ",[281,1467,431],{},", add a little Hue or Brightness, and tick ",[281,1470,1139],{}," if mirrored images suit the look.",[11,1473,1475],{"id":1474},"putting-a-specific-image-on-a-specific-object","Putting a specific image on a specific object",[275,1477,1478,1480,1485,1490],{},[19,1479,1377],{},[19,1481,1482,1483,48],{},"Select one or more objects. Open ",[281,1484,420],{},[19,1486,1487,1488,48],{},"Type a file name in the search field, or set ",[281,1489,904],{},[19,1491,1315,1492,48],{},[281,1493,925],{},[119,1495,1496,1497,1500,1501,1504,1505,1507],{},"For many objects, name them after the files (an object ",[41,1498,1499],{},"poster_cat"," for ",[41,1502,1503],{},"cat.png","), select them all and press ",[281,1506,935],{},". The message tells you how many matched and lists the first few without a match.",[11,1509,1511],{"id":1510},"changing-the-images-later","Changing the images later",[275,1513,1514,1517,1522,1532,1543],{},[19,1515,1516],{},"Add, remove or rename images in the folder. Replace images by dropping new files in.",[19,1518,1315,1519,1521],{},[281,1520,291],{}," 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.",[19,1523,1524,1525,421,1527,428,1529,1531],{},"Changes to ",[281,1526,424],{},[281,1528,427],{},[281,1530,431],{}," apply immediately, with no second button.",[19,1533,1524,1534,785,1536,1538,1539,785,1541,48],{},[281,1535,795],{},[281,1537,779],{}," need another press of ",[281,1540,297],{},[281,1542,304],{},[19,1544,1545,1546,421,1548,421,1550,785,1552,1554,1555,1557],{},"To change ",[281,1547,287],{},[281,1549,722],{},[281,1551,733],{},[281,1553,768],{},", press ",[281,1556,291],{}," again.",[11,1559,1561],{"id":1560},"animating-through-the-images","Animating through the images",[275,1563,1564,1567,1574],{},[19,1565,1566],{},"Build the atlas and apply the images as usual.",[19,1568,456,1569,1571,1572,48],{},[281,1570,427],{},", tick the box in its header, and set ",[281,1573,1077],{},[19,1575,1576],{},"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,1578,131],{"id":130},[16,1580,1581,1585,1589],{},[19,1582,136,1583],{},[123,1584,140],{"href":139},[19,1586,1587],{},[123,1588,146],{"href":145},[19,1590,149,1591],{},[123,1592,153],{"href":152},{"title":155,"searchDepth":156,"depth":156,"links":1594},[1595,1596,1597,1598,1599,1600,1601,1602],{"id":1276,"depth":156,"text":1277},{"id":1336,"depth":156,"text":1337},{"id":1371,"depth":156,"text":1372},{"id":1412,"depth":156,"text":1413},{"id":1474,"depth":156,"text":1475},{"id":1510,"depth":156,"text":1511},{"id":1560,"depth":156,"text":1561},{"id":130,"depth":156,"text":131},"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":1260,"description":1603},"docs\u002Fimage-per-instance\u002Fworkflows","WuHQgMIbTwtxhYNSMzs4I0ljgQEoZvBeUboCTFs0Kn0",{"id":1611,"title":1612,"addon":6,"body":1613,"description":1847,"extension":167,"meta":1848,"navigation":169,"order":1849,"path":145,"rawbody":1850,"seo":1851,"stem":1852,"updated":175,"__hash__":1853},"docs\u002Fdocs\u002Fimage-per-instance\u002Ftroubleshooting.md","Image Per Instance troubleshooting",{"type":8,"value":1614,"toc":1825},[1615,1621,1625,1633,1637,1640,1644,1653,1657,1660,1664,1670,1674,1688,1692,1695,1699,1707,1711,1714,1718,1723,1727,1730,1734,1740,1744,1747,1751,1757,1761,1769,1773,1776,1780,1790,1794,1802,1806,1809,1811],[119,1616,1617,1618,1620],{},"Each answer below uses the message text the add-on shows at the bottom of Blender. If your problem is not here, write to ",[123,1619,326],{"href":325}," with your Blender version and the add-on version shown at the bottom of the panel.",[11,1622,1624],{"id":1623},"what-does-choose-an-image-folder-first-mean","What does \"Choose an image folder first\" mean?",[119,1626,1627,1629,1630,1632],{},[281,1628,291],{}," was pressed while ",[281,1631,283],{}," is empty. Click the folder icon next to Image Folder and choose a folder.",[11,1634,1636],{"id":1635},"why-does-blender-say-no-images-found-in-my-folder","Why does Blender say \"No images found\" in my folder?",[119,1638,1639],{},"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,1641,1643],{"id":1642},"what-if-the-atlas-is-too-big-limit-16384","What if the atlas is too big (limit 16384)?",[119,1645,1646,1647,1649,1650,1652],{},"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 ",[281,1648,287],{},", or use fewer images. A non-square ",[281,1651,722],{}," changes the sizes too.",[11,1654,1656],{"id":1655},"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\"?",[119,1658,1659],{},"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,1661,1663],{"id":1662},"why-are-some-images-black-or-missing-in-the-atlas","Why are some images black or missing in the atlas?",[119,1665,1666,1667,1669],{},"If a file cannot be read, ",[281,1668,291],{}," 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,1671,1673],{"id":1672},"why-does-blender-say-build-the-atlas-first","Why does Blender say \"Build the atlas first\"?",[119,1675,1676,421,1678,421,1680,428,1682,1684,1685,1687],{},[281,1677,297],{},[281,1679,304],{},[281,1681,925],{},[281,1683,935],{}," need an atlas in the current file. Press ",[281,1686,291],{}," first. The atlas is stored in the .blend, so this also appears in a file where it was never built.",[11,1689,1691],{"id":1690},"why-does-blender-say-select-mesh-objects","Why does Blender say \"Select mesh objects\"?",[119,1693,1694],{},"The buttons act only on selected objects of type mesh. Curves, empties, lights and cameras are ignored.",[11,1696,1698],{"id":1697},"why-does-my-object-show-one-stretched-colour-instead-of-an-image","Why does my object show one stretched colour instead of an image?",[119,1700,1701,1702,1435,1704,1706],{},"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 ",[281,1703,980],{},[281,1705,424],{}," to Front, Top or Side (no UVs).",[11,1708,1710],{"id":1709},"why-do-some-faces-look-streaked-with-front-top-or-side-mapping","Why do some faces look streaked with Front, Top or Side mapping?",[119,1712,1713],{},"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,1715,1717],{"id":1716},"why-does-the-instances-button-say-no-instanced-source-found","Why does the instances button say \"No instanced source found\"?",[119,1719,1720,1721,1557],{},"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 ",[281,1722,304],{},[11,1724,1726],{"id":1725},"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\"?",[119,1728,1729],{},"The active object must be a mesh. Click the host in the outliner so it is the active one, then press the button.",[11,1731,1733],{"id":1732},"why-do-my-instances-all-show-the-same-image","Why do my instances all show the same image?",[119,1735,1736,1737,1739],{},"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 ",[281,1738,308],{}," modifier runs, there is nothing to store the index on. Keep the instances unrealized up to the end of the stack.",[11,1741,1743],{"id":1742},"why-did-my-images-change-after-pressing-build-atlas-again","Why did my images change after pressing Build Atlas again?",[119,1745,1746],{},"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,1748,1750],{"id":1749},"why-does-match-by-object-name-say-press-build-atlas-again","Why does Match By Object Name say \"Press Build Atlas again\"?",[119,1752,1753,1754,1756],{},"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 ",[281,1755,291],{}," and try again.",[11,1758,1760],{"id":1759},"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\"?",[119,1762,1763,1764,1766,1767,48],{},"None of the selected objects have a name equal to, or containing, a file name. The match ignores case and a trailing ",[41,1765,952],{},". Rename the objects, or use ",[281,1768,925],{},[11,1770,1772],{"id":1771},"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?",[119,1774,1775],{},"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,1777,1779],{"id":1778},"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?",[119,1781,1782,1783,1786,1787,1789],{},"The picker uses file names without the extension, so both show as ",[41,1784,1785],{},"cat",". Choose them by ",[281,1788,904],{}," instead.",[11,1791,1793],{"id":1792},"why-does-shuffle-look-repetitive","Why does Shuffle look repetitive?",[119,1795,1796,1797,1799,1800,48],{},"Shuffle spreads images evenly, but with few images the pattern can show a rhythm. Change ",[281,1798,795],{}," and press the button again, or add ",[281,1801,431],{},[11,1803,1805],{"id":1804},"do-the-instances-and-the-separate-objects-shuffle-the-same-way","Do the instances and the separate objects shuffle the same way?",[119,1807,1808],{},"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,1810,131],{"id":130},[16,1812,1813,1817,1821],{},[19,1814,136,1815],{},[123,1816,140],{"href":139},[19,1818,1819],{},[123,1820,247],{"href":246},[19,1822,149,1823],{},[123,1824,153],{"href":152},{"title":155,"searchDepth":156,"depth":156,"links":1826},[1827,1828,1829,1830,1831,1832,1833,1834,1835,1836,1837,1838,1839,1840,1841,1842,1843,1844,1845,1846],{"id":1623,"depth":156,"text":1624},{"id":1635,"depth":156,"text":1636},{"id":1642,"depth":156,"text":1643},{"id":1655,"depth":156,"text":1656},{"id":1662,"depth":156,"text":1663},{"id":1672,"depth":156,"text":1673},{"id":1690,"depth":156,"text":1691},{"id":1697,"depth":156,"text":1698},{"id":1709,"depth":156,"text":1710},{"id":1716,"depth":156,"text":1717},{"id":1725,"depth":156,"text":1726},{"id":1732,"depth":156,"text":1733},{"id":1742,"depth":156,"text":1743},{"id":1749,"depth":156,"text":1750},{"id":1759,"depth":156,"text":1760},{"id":1771,"depth":156,"text":1772},{"id":1778,"depth":156,"text":1779},{"id":1792,"depth":156,"text":1793},{"id":1804,"depth":156,"text":1805},{"id":130,"depth":156,"text":131},"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":1612,"description":1847},"docs\u002Fimage-per-instance\u002Ftroubleshooting","EVdj8OznOTzKrt69rJ8yq1Jb9Lob1CqXBu4VHVfIaVs",{"id":4,"title":5,"addon":6,"body":1855,"description":166,"extension":167,"meta":1955,"navigation":169,"order":170,"path":171,"rawbody":172,"seo":1956,"stem":174,"updated":175,"__hash__":176},{"type":8,"value":1856,"toc":1945},[1857,1859,1887,1889,1893,1895,1901,1903,1907,1909,1913,1915,1919,1921,1925,1929,1931],[11,1858,14],{"id":13},[16,1860,1861,1863,1865,1867,1869,1871,1873,1879,1881,1883,1885],{},[19,1862,21],{},[19,1864,24],{},[19,1866,27],{},[19,1868,30],{},[19,1870,33],{},[19,1872,36],{},[19,1874,39,1875,44,1877,48],{},[41,1876,43],{},[41,1878,47],{},[19,1880,51],{},[19,1882,54],{},[19,1884,57],{},[19,1886,60],{},[11,1888,64],{"id":63},[16,1890,1891],{},[19,1892,69],{},[11,1894,73],{"id":72},[16,1896,1897,1899],{},[19,1898,78],{},[19,1900,81],{},[11,1902,85],{"id":84},[16,1904,1905],{},[19,1906,90],{},[11,1908,94],{"id":93},[16,1910,1911],{},[19,1912,99],{},[11,1914,103],{"id":102},[16,1916,1917],{},[19,1918,108],{},[11,1920,112],{"id":111},[16,1922,1923],{},[19,1924,117],{},[119,1926,121,1927,127],{},[123,1928,126],{"href":125},[11,1930,131],{"id":130},[16,1932,1933,1937,1941],{},[19,1934,136,1935],{},[123,1936,140],{"href":139},[19,1938,1939],{},[123,1940,146],{"href":145},[19,1942,149,1943],{},[123,1944,153],{"href":152},{"title":155,"searchDepth":156,"depth":156,"links":1946},[1947,1948,1949,1950,1951,1952,1953,1954],{"id":13,"depth":156,"text":14},{"id":63,"depth":156,"text":64},{"id":72,"depth":156,"text":73},{"id":84,"depth":156,"text":85},{"id":93,"depth":156,"text":94},{"id":102,"depth":156,"text":103},{"id":111,"depth":156,"text":112},{"id":130,"depth":156,"text":131},{},{"title":5,"description":166},{"id":1958,"title":1959,"blender":1960,"body":1961,"buy":2225,"description":2232,"extension":167,"lite":2233,"meta":2235,"name":140,"navigation":169,"path":139,"poster":2236,"price":2192,"problem":2237,"rawbody":2238,"seo":2239,"status":2240,"stem":2241,"updated":175,"version":2242,"video":2243,"__hash__":2244},"addons\u002Faddons\u002Fimage-per-instance.md","Image Per Instance add-on for Blender","4.2 and newer",{"type":8,"value":1962,"toc":2215},[1963,1967,1970,1976,1982,1985,2019,2022,2026,2072,2077,2081,2091,2095,2145,2150,2158,2160,2163,2167,2183,2187],[11,1964,1966],{"id":1965},"the-problem","The problem",[119,1968,1969],{},"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.",[119,1971,1972,1973,1975],{},"Image Per Instance builds that setup for you. You point it at a folder, press ",[281,1974,291],{},", and every object, array element or Geometry Nodes instance can show a different image while sharing one material.",[119,1977,1978],{},[1406,1979],{"alt":1980,"src":1981},"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,1983,692],{"id":1984},"what-it-does",[16,1986,1987,1998,2003,2011],{},[19,1988,1989,1991,1992,1994,1995,1997],{},[281,1990,291],{}," 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 (",[41,1993,43],{}," before ",[41,1996,47],{},"), so Image Number 3 is always the third file.",[19,1999,2000,2002],{},[281,2001,297],{}," gives each selected mesh its own tile. The image index is stored as a custom property on the object.",[19,2004,2005,2007,2008,2010],{},[281,2006,304],{}," 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 ",[281,2009,308],{}," to the host. That modifier writes an image number onto every instance, and the material reads it.",[19,2012,2013,2015,2016,2018],{},[281,2014,779],{}," can be \"By file name\" or \"Shuffle\". Shuffle uses every image once before any repeats, and a ",[281,2017,795],{}," field gives you other arrangements.",[119,2020,2021],{},"One material, one atlas, and the material is made of ordinary Blender nodes.",[11,2023,2025],{"id":2024},"beyond-the-basics-full-version","Beyond the basics (full version)",[16,2027,2028,2034,2048,2054,2060,2066],{},[19,2029,2030,2033],{},[281,2031,2032],{},"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.",[19,2035,2036,2039,2040,2042,2043,2045,2046,48],{},[281,2037,2038],{},"Choose images yourself:"," pick an image by number or by name, or use ",[281,2041,935],{}," so an object called ",[41,2044,1499],{}," shows ",[41,2047,1503],{},[19,2049,2050,2053],{},[281,2051,2052],{},"Material options:"," use image alpha, make the image glow like a screen, set roughness.",[19,2055,2056,2059],{},[281,2057,2058],{},"Mapping without UVs:"," project from the front, top or side across the whole object.",[19,2061,2062,2065],{},[281,2063,2064],{},"Animate:"," every object steps through the images every N frames, each starting at its own image.",[19,2067,2068,2071],{},[281,2069,2070],{},"Random variation:"," shift hue, saturation and brightness per object, and mirror a random half of the objects.",[119,2073,2074,2075,48],{},"Every control is listed in the ",[123,2076,435],{"href":235},[11,2078,2080],{"id":2079},"what-you-can-use-it-for","What you can use it for",[119,2082,2083,2084,2087,2088,2090],{},"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 ",[123,2085,2086],{"href":246},"workflows page",", and the guide ",[123,2089,153],{"href":152}," shows the manual method first.",[11,2092,2094],{"id":2093},"honest-limits","Honest limits",[16,2096,2097,2107,2114,2121,2128,2131,2142],{},[19,2098,2099,2100,2102,2103,48],{},"One atlas per .blend file. Pressing ",[281,2101,291],{}," again replaces it, and objects keep their pictures by file name. See ",[123,2104,2106],{"href":2105},"\u002Fdocs\u002Fimage-per-instance\u002Ftroubleshooting#why-did-my-images-change-after-pressing-build-atlas-again","rebuilding the atlas",[19,2108,2109,2110,48],{},"The atlas can be at most 16384 px on each side. For example 256 images at 1024 px fit exactly, 257 do not. See ",[123,2111,2113],{"href":2112},"\u002Fdocs\u002Fimage-per-instance\u002Ftroubleshooting#what-if-the-atlas-is-too-big-limit-16384","the atlas size limit",[19,2115,2116,2117,48],{},"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 ",[123,2118,2120],{"href":2119},"\u002Fdocs\u002Fimage-per-instance\u002Ftroubleshooting#why-do-some-faces-look-streaked-with-front-top-or-side-mapping","streaked faces",[19,2122,2123,2124,48],{},"With few images the Shuffle order can show a visible rhythm. See ",[123,2125,2127],{"href":2126},"\u002Fdocs\u002Fimage-per-instance\u002Ftroubleshooting#why-does-shuffle-look-repetitive","repetitive shuffle",[19,2129,2130],{},"The image goes on material slot 1 of each object. Other slots stay untouched.",[19,2132,2133,428,2135,2137,2138,48],{},[281,2134,925],{},[281,2136,935],{}," work on separate objects, not on Geometry Nodes instances. See ",[123,2139,2141],{"href":2140},"\u002Fdocs\u002Fimage-per-instance\u002Ftroubleshooting#why-does-the-instances-button-say-no-instanced-source-found","no instanced source found",[19,2143,2144],{},"It is not a replacement for UDIM or texture painting.",[119,2146,2147,2148,48],{},"More cases are covered in ",[123,2149,1224],{"href":145},[119,2151,2152,2153,2157],{},"Built and tested by Pavel at Mendbox Studio (",[123,2154,2156],{"href":2155},"\u002Fabout","about",").",[11,2159,367],{"id":366},[119,2161,2162],{},"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,2164,2166],{"id":2165},"free-lite-version","Free Lite version",[119,2168,2169,2170,428,2172,2174,2175,2179,2180,2182],{},"Image Per Instance Lite is a separate free download. It has ",[281,2171,291],{},[281,2173,297],{}," 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. ",[123,2176,2178],{"href":484,"rel":2177},[486],"Get Lite on GitHub",", and see the ",[123,2181,126],{"href":125}," for the differences.",[11,2184,2186],{"id":2185},"how-to-buy","How to buy",[119,2188,2189,2190,2193,2194,785,2199,2204,2205,432,2208,2211,2212,48],{},"The full version is ",[281,2191,2192],{},"$12",". Buy it on ",[123,2195,2198],{"href":2196,"rel":2197},"https:\u002F\u002Fquadfix.gumroad.com\u002Fl\u002Fimage-per-instance?utm_source=mendboxstudio&utm_medium=addon-page&utm_campaign=image-per-instance",[486],"Gumroad",[123,2200,2203],{"href":2201,"rel":2202},"https:\u002F\u002Fsuperhivemarket.com\u002Fproducts\u002Fimage-per-instance?utm_source=mendboxstudio&utm_medium=addon-page&utm_campaign=image-per-instance",[486],"Superhive",", then install the zip in Blender as described in the ",[123,2206,2207],{"href":125},"install guide",[123,2209,2210],{"href":354},"full documentation"," lists every page, including the ",[123,2213,2214],{"href":171},"changelog",{"title":155,"searchDepth":156,"depth":156,"links":2216},[2217,2218,2219,2220,2221,2222,2223,2224],{"id":1965,"depth":156,"text":1966},{"id":1984,"depth":156,"text":692},{"id":2024,"depth":156,"text":2025},{"id":2079,"depth":156,"text":2080},{"id":2093,"depth":156,"text":2094},{"id":366,"depth":156,"text":367},{"id":2165,"depth":156,"text":2166},{"id":2185,"depth":156,"text":2186},[2226,2229],{"label":2227,"to":2228},"Buy on Gumroad","https:\u002F\u002Fquadfix.gumroad.com\u002Fl\u002Fimage-per-instance",{"label":2230,"to":2231},"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.",{"summary":2234,"to":484},"Free and open source (GPL). Builds the atlas and puts a different image on separate objects, up to 20 images. No Geometry Nodes instances.",{},"\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":1959,"description":2232},"released","addons\u002Fimage-per-instance","0.2.0","\u002Fmedia\u002Fipi.mp4","54Wmn5jGdlRjQ-6eDveUyo_uk8jHjm5YvLuKUbAr1rk",1794858942649]