Gaffer - Light & Hdri Manager

by Greg Zaal in Addons

Gaffer is a Blender add-on that helps you light your scenes by presenting all the right settings in convenient panels for quick access and experimentation.

As a lighting artist, I created this add-on to help me with my everyday work. Not only did it speed up my lighting workflow, but it meant I could focus on creating better lighting without getting distracted searching for buttons.

"Lighting in Blender has never been this intuitive. Gaffer is your digital assistant when it comes to giving life to your scenes. A hassle-free tool and a must-have!" -  Reynante Martinez

Simple, Fast Interface

Character by Rico Cilliers

The UI has been meticulously designed to provide you with all the settings you need, as you need them, for all the lamps in your scene at once.

You can choose to view only the basic controls like strength and color, or expand each lamp to show more advanced options like shadow size, sample count, diffuse/specular toggles, falloff type and much more.

But Gaffer isn't just a little collection of things you can already do, it includes tools that will speed up your workflow and help you focus on the task at hand. The Solo button next to each light will temporarily hide all other lights except the one you clicked on, so you can see exactly what it's doing without being distracted or misguided by other lights. When you're done, Gaffer remembers your previous arrangement of light visibility and restores it.

A Better HDRI Handler

New in Gaffer v3 is a robust HDRI manager, with the ability to quickly switch between your HDR environment maps and adjust brightness, rotation, warmth, etc. all with a simple and intuitive interface. No need to fiddle with any nodes or wait for thumbnails of giant files to load.

It's built to handle whatever HDRIs you have on your hard drive, but if you don't have that many, there's a button to download free HDRIs from Poly Haven in a single click.

One click away is an automatically generated JPG background for up to 4x memory savings, with an optional darkened JPG version to retain specular highlights in reflections.

An advanced search and tagging system can be used to organize your library and make it easier to find the perfect HDRI in your future projects.

"It's not often I invest in add-ons, and even more rare that I endorse them, but I fully stand behind Gaffer, and the work Greg has put into it. Worth every penny, this lightweight addition to my workflow has sped up the process of lighting my scenes, giving me immediate, unfettered access to all of my HDR environments whilst simultaneously taking the guesswork out of choosing the right setup. Take the plunge - you won't regret it!" - Jackdarton

Useful Visualizations

Scene by Glenn Melenhorst

The size of a lamp controls how soft its shadow is - this is key to creating good lighting, but it's hard to imagine what it'll look like when you're just typing in numbers. Gaffer lets you display the lamp size directly in the 3D view as colorful outlines around each lamp so that you can visually understand how the light will behave.

You can also display the name of each light in the 3D view for quick identification. As a bonus, this promotes good naming standards for better organization :)

Free Updates, Forever

I'm a lighting artist myself, which means that I'm constantly adding new features and improving this add-on for myself as well as for you. So once you purchase Gaffer, you'll also be able to get all future updates without ever having to take your wallet out again.

Just take a look at the change-log below to see how this add-on has evolved over the years and how it will continue to grow in future.

Unlimited Free Trial

Before you buy Gaffer, you're welcome to try it out for yourself with a completely free trial:

Download the trial version of Gaffer

There is no time limit to the trial, nor are there any feature limitations or constraints. The only difference between the trial version and a purchased copy of Gaffer is a small "Trial version" text in some parts of Gaffer's interface.

Since Gaffer is open source, you're free to remove this text if you wish, though I hope you will find Gaffer useful enough to come back and purchase it here to support future development :)

The trial version will only work in the latest version of Blender.

Render Engines

In Blender 2.9 & 3.0+:

All major features work in both Cycles and Eevee.

For other render engines, only basic support such as the Solo button, hiding, selecting and renaming lights currently work.

In Blender 2.7:

The lighting panel works for both Cycles and Blender Render (aka Blender Internal).

The HDRI Handler only works for Cycles, as Blender Render doesn't fully support HDRI lighting anyway.




  • Update some shadow properties with changes in Blender 4.2



  • Add compatibility with Blender 4.2 (EEVEE Next replaced the old EEVEE engine)



  • Fix error when enabling HDRI Handler if Label/Radius is being drawn.
  • Fix offline mode not working consistently.



  • Fix an error when adding a new HDRI folder.




  • Improved compatibility with Poly Haven add-on: You can now select your Poly Haven asset library as a source folder for Gaffer, and only the HDRIs will be detected.
  • New "Favorites" feature - mark your favorite HDRIs, and easily filter to them later.
  • New Folder filtering - show only HDRIs in specific folders/subfolders to make it easier to find what you're looking for.
  • Added Color tinting option, allowing for the environment to be tinted any color, with any blending mode, and also for the background to be controlled separately (e.g. to make the background a solid color while still using an HDRI for lighting).
  • You can now adjust the rotation of the background separately without affecting lighting (and optionally reflections).
  • HDRI settings are now stored per-world, allowing you to use multiple World settings as a kind of HDRI template/snapshot system.
  • Support for HDRI libraries that may not always be available (e.g. on external/network drives).
  • The current HDRI is no longer changed automatically every time you search for something, it stays the same as long as the current HDRI is in the search results.
  • Added offline mode to disable fetching Poly Haven HDRI tags.
  • Advanced settings are now in a standard sub-panel instead of a box layout, for better consistency with the rest of Blender 4.1's UI.


  • The light list now auto-refreshes whenever lights are added, removed, or renamed, so you won't need to manually refresh it as often. This may affect performance in scenes with many thousands of objects, so it can be disabled in the preferences.
  • New -/+ buttons next to light strength sliders - to conveniently half/double the light power. Hold Shift for smaller increments, and Ctrl for larger increments.
  • For multi-user lights, the number of users is now indicated in a little button next to the name. Clicking the button copies the common object name to the data name (i.e. light data or material name) to the object names to help you keep track of which objects are using the same light data. Shift-clicking it does the opposite, renaming objects to match the data name.
  • Renaming of lights from the light list is now streamlined (no popup required), as long as auto-refreshing is enabled.
  • Add settings for Fast GI in Cycles since Ambient Occlusion was removed.
  • Show light shape selector for Area lights.
  • Remember state of world ray visibility (Camera/Diffuse/Etc.) when toggling world visibility or Solo-ing any light.
  • Catch some JSON decode errors in case of corrupt data files.
  • Many functions are now undo-able
  • General compatibility fixes for Blender 4.1



  • Compatibility with Blender 4.0



  • Additions to the light list:
    Area light spread
    Light group (when there are existing light groups in the scene)



  • Fix sun lamps showing "Size" instead of "Angle" since API change.
  • Fix broken auto-updater since API changes.



  • Fix cycles_visibility error since API change.



  • Show "Get Free HDRIs" operator in search so it can be re-run in case of failure
  • Increase thread pool size to download HDRIs faster
  • Replace "HDRI Haven" in UI strings with "Poly Haven"



Compatibility with Blender 3.3



Compatibility with Blender 3.1



Fixes width error popping up from multiple functions when using certain Blender versions.



  • Compatibility with Blender 3.0



  • Full support for Eevee.
  • Blender 2.90+ now required.
  • Refactored code for easier future improvements and render engine compatibility.



  • Fix error applying global exposure when using mesh lights.
  • Fix incorrectly applied global exposure with multi-user light data.
  • Customizable panel category/tab.
  • Ignore hidden HDRI files on linux/mac.



  • Fix for changes in the mapping node in Blender 2.81. Still works in 2.80 as well



  • Stable release for Blender 2.8 RC2



  • Fix UI disappearing when expanding area light
  • Show radius/labels in rendered shading mode and make them obey the viewport overlay toggle
  • Lights in nested collections were considered hidden



  • Show HDRI Handler for Eevee
  • Fix 'Selected Only' mode for radius display
  • Don't show 'Apply Exposure' button for unsupported engines
  • Use the same icon for Solo buttons everywhere



  • First release for Blender 2.8! This version will not work in 2.7x. If you still use Blender 2.7x, older versions are available for download.
  • Most features will still only work in Cycles, however some will also now work in unsupported engines (e.g. Eevee). Full support for Eevee will come in the next major release.
  • You can now add multiple HDRI folders instead of just one, useful if your HDRIs are stored on different hard drives, network storage or Google Drive folders.
  • Added horizon shifting tools to lower or raise the horizon while trying to keep it looking natural.
  • You can now save the current HDRI settings as the default for that particular HDRI and easily restore them later, or reset all the HDRI settings to factory defaults.
  • Added previous/next paddles to more quickly increase or decrease the HDRI resolution used.
  • Added an "Aim light using 3D view" function.
  • Added a global exposure control that lets you adjust the brightness of all lights at once.
  • Fix some harmless errors that pop up after enabling size/label visualization and then switching to another editor type.
  • Better detection of light strength value when using more complex node setups.
  • Light aiming tools now support both Quaternion and Euler rotation systems.



  • Last release for Blender 2.7x. No feature changes. Prevent the auto-updater from going past this version as the next version will be for Blender 2.8 and will not work in 2.7x.





  • Fix broken thumbnail gen when there's a space in the path to Blender.
  • Make HDRI selector smaller in toolbar.



  • Bug fixes relating to generating thumbnails..
  • Optionally ignore 8-bit images to avoid detecting example renders as HDRIs. Enable "Detect 8-bit images as HDRIs" in the User Preferences to keep the old behavior.
  • Optionally skip generating thumbnail if only a big HDRI is available to avoid long waits
    Use pre-existing thumbnail or preview files if there are any.
  • Don't include _thumb or _preview files in HDRI variation list.
  • Log some info to a text file to help with debugging if necessary. Log file only records last 7 days to avoid growing to a huge file over time.
  • Add some debugging tools.



Add a robust HDRI manager to allow you to quickly switch between your HDR environment maps, adjust brightness, rotation, warmth, etc. without having to use the node editor.

See all the new features explained here:



Note: To install this version you must first remove the old one.

Gaffer now notifies you when an update is available (can be turned off in user-prefs).

Minor improvements to the handling of lights with multi-user data:

  • When labels are shown, the name of the data is shown too so you can easily recognize which lights share the same data.
  • The name of the data (or material in the case of mesh lights) is shown in the light panel instead of just one of the object names. Clicking on the name will let you rename the data/material.

Lights with single-user data are not affected.

The add-on is also now split into multiple files instead of a single file. This is both for organizational purposes and to allow the auto-updating feature to work.



Support for Blender 2.77 (fix viewport update issues)



  • Renaming a light from the panel will no longer require a manual refresh.
  • Added support for portal lamps



Objects in the Blacklist are no longer affected by Soloing.



Fix a crash (or a bunch of errors) when deleting a lamp while showing the radius visualization.



Just a few minor improvements:

  • When selecting/hiding/showing/soloing a light with multi-user data, the other objects which share that data are selected/hidden/shown/solo'd as well.
  • Refreshing the light list will also refresh the 3D View visualizations.



This version adds several new tools to help you aim, visualize and manage your lights. Aiming:

  • Aim selected lights at 3D cursor
  • Aim selected lights at active object
  • Aim the active object at the average location of selected objects

View-port Visualization:

  • Display the radius of lights in the 3D View
  • Display a colored label in the 3D View with the light name

Add objects to a Blacklist to prevent them from showing up in the light list or 3D View visualizations. Link the vector of a sky texture to the rotation of a lamp - this can be used to make sure the appearance of the sky matches the direction of the sun correctly. Minor Improvements:

  • If multiple lights use the same lamp data (or material), only one of the lamps is shown in the list. A small label tells you how many users of that data there are.
  • Added a small gap between lights in the light list to help visual separation.
  • Added a button at the top to exit Solo Mode.
  • Hiding the world light (or enabling Reflection Only) now uses the new Volume Scatter ray visibility.
  • [Bug] Selecting a light from the Gaffer panel while in Edit Mode would force you to be stuck in some impossible limbo mode.
  • [Bug] Changing the render engine would sometimes show some errors.
Sales 3800+
Customer Ratings 35
Average Rating
Dev Fund Contributor
Published about 10 years ago
Blender Version 4.2, 4.1, 4.0, 3.6, 3.5, 3.4, 3.3, 3.2, 3.1, 3.0, 2.93, 2.92, 2.91, 2.9, 2.83, 2.82, 2.81, 2.8, 2.79, 2.78
License GPL
Have questions before purchasing?

Contact the Creator with your questions right now.

Login to Message