Documentation

Shelf Filler 4.0 Pro is a Blender add-on for generating realistic retail shelf layouts using your own product objects and shelf geometry.

Installation

1. Download the product ZIP file.
2. Open Blender.
3. Go to Edit → Preferences → Add-ons.
4. Click Install.
5. Select the file shelf_filler_4_0_pro.py.
6. Enable the add-on.
7. Open the 3D Viewport and press N to open the side panel.
8. Go to the Shelf tab.

Basic Workflow

1. Prepare a collection with your product objects.
2. Select the product collection in the add-on panel.
3. Select your shelf object.
4. Adjust shelf fill, spacing, facing mode and alignment settings.
5. Click Generate.
6. Use locking, regeneration and replacement tools to fine-tune the result.

Main Features

One-Click Shelf Generation

Automatically populate shelf geometry with product objects.

Adjustable Shelf Fill

Control how much of each shelf should be filled with products.

Advanced Facing Modes

Create single-product facings or grouped product blocks for more realistic retail layouts.

Perfect Shelf Alignment

Align products to the left, center, right or distribute them using justify alignment.

Non-Destructive Locking

Lock selected products so they stay in place during regeneration.

Smart Shelf Regeneration

Regenerate shelf layouts while preserving locked products and manual adjustments.

Instant Product Replacement

Replace selected generated products with another product from your source collection.

Important Notes

• For best results, use clean product objects with applied scale and consistent origins.
• The add-on works with mesh objects. Non-mesh objects may be ignored.
• Shelf objects should have clean horizontal shelf surfaces.
• If you lock products, avoid changing facing mode drastically before regenerating, because locked products will keep their current positions.
• The included documentation files inside the ZIP contain more detailed notes, best practices and FAQ.