Shapes Instances

Normally, every shape in a Boxshot scene is independent, with its own parameters and materials. You can copy and paste shapes, create multiple copies with Step and Repeat and other tools, but each copy is still a separate object. If you later tweak a shape’s materials, you’ll need to copy its materials to the other shapes to keep them in sync.

Boxshot also provides lightweight objects called instances. Instances don’t store their own properties or materials — they reference the original instead. This tutorial explains what instances are and how to manage them.

Creating Instances

Start with a new scene and a simple hard cover book shape:

A hard cover book shape in a new Boxshot scene

Right-click the shape and choose Create Instance from the context menu. Boxshot adds another book to the scene:

Hard cover book instance added to the scene

Notice the “chain” icon on the right side of the scene tree items –— this indicates the shapes are instances.

Important: All instances of a shape are equal, including the shape you started with. Boxshot doesn’t highlight an “original” in any special way, and changing any instance updates all instances the same way.

Now let’s test it by changing something on one of the books. Here the book preset was changed from “Closed” to “Open a bit”:

Changing one shape changes all its instances

The other book changes as well. Boxshot applies edits made to any instance across the entire set. This includes properties and materials, except for visibility, name, and transformations (translation, rotation, and scale). That’s what makes instances so useful: you can place the same object multiple times around the scene while keeping its look and settings consistent.

You can create as many instances as you need using the right-click menu. You can even create instances of instances —– it still results in another instance of the same shape.

Converting Instances Back

You can convert an instance back into a regular, independent shape. Right-click the instance and select Detach Instance. Boxshot will turn the selected item into a normal shape.

Here’s a scene with three book instances:

Three book instances in Boxshot scene

Select the left one and detach it using Detach Instance:

One book is not an instance anymore

Now change one of the remaining instances and see what happens:

Only instances are updated, but not the detached shape

When you edit an instance, the other instance updates too, but the detached book does not. Detaching is handy when you generate multiple copies using Step and Repeat (or similar tools) and then want to customize just one copy. Create everything as instances, detach the one you need, then adjust it independently.

Automatic Instances Lookup

Complex scenes —– especially those built by repeatedly copying and pasting objects —– can become heavy, slow to load, and sluggish to work with. Converting identical items into instances can help a lot, and Boxshot can automate the process.

Right-click the scene and choose Tools → Convert to Instances…. Boxshot scans the scene and shows a list of objects it can convert into instances.

From there, you can pick which groups to convert, or convert everything to simplify the scene.

Advanced Instances Options

Boxshot doesn’t support instances of groups as a single object. If you click Create Instance on a group, Boxshot creates a group of instances, not an instance of the group itself. All shapes inside that new group become instances linked to their originals, but the group hierarchy is independent and can be reorganized separately.

Several tools can generate multiple copies of objects, including Step and Repeat, Circular Step and Repeat, and Stack. By default, these tools create instances instead of full copies. Instances are much faster, especially for complex or heavy geometry, and using them can significantly improve scene loading, editing responsiveness, and rendering performance.

Copying instances via Edit → Cut/Copy/Paste turns them back into regular shapes. Use Create Instance to clone instances.

Finally, you can select all related instances by right-clicking an instance and choosing Select Other Instances.

More Tutorials

Rendering

Materials

Features

Shapes