Lightmass Portals

Help increase the quality of baked interior lighting.

Choose your operating system:





When gathering lighting, Lightmass can backtrack to Point, Spot and Directional light sources using photons from the Photon Mapping technique. This means that it can find small windows where light is entering from these light types and resolve the incoming lighting with high-quality. However, SkyLights and Emissive meshes don't support photon emission efficiently, so Lightmass can only find the small important lighting features with brute force. This manifests as splotchy artifacts around indoor corners. To help Lightmass better understand where the light should be coming from, you can place Lightmass Portals Actors around the areas that are critical to lighting. In the following document, we will take a look at setting up and using Lightmass Portals in your Unreal Engine 4 (UE4) projects.

How It Works

From a high-level, Lightmass Portals work in the following manner:

  • Lightmass Portals are most useful when a scene is lit using a Skylight, HDR image or a Static Mesh that is set to Use Emissive for Static Lighting checked.

    Click for full image.

  • Lightmass Portals are placed and in the level and scaled to fit any open areas that are important to the final lighting.


  • When Lightmass is building the light, the Lightmass Portals tell Lightmass that more light rays should come from this area yielding higher quality light and shadows.

    Without Portals

    With Portals


To use Lightmass Portals in your UE4 projects, you will need to do the following.

  1. From the Place Actors panel, search for Lightmass Portal and then drag the Lightmass Portal Actor into your level to place it.

    Click for full image.

  2. Using the Move, Rotate and Scale tools, position and scale the Lightmass Portal to be about the same size or slightly smaller than the opening or area you want Lightmass to focus more rays towards.

    Click for full image.

  3. Over on the Main Toolbar, click on the small white triangle next to Build and from the menu, change the Lighting Quality to Production.


  4. When that has all been completed, press the Build button to start the Lightmass lighting build.


End Result

Once your Lightmass build has completed, you will have something similar to the following image.

Without Portals

With Portals

If you take a close look at the Without Portals image, you will notice that there is a lot of noise in the image, especially in the darker areas when compared to the With Portals image.

Known Issues and Limitations

  • Lightmass Portals work by forcing Lightmass to send rays toward the portal. Because of this, you should only use Lightmass Portals on small levels and only for lighting that is critical to the scene. Failing to do this (and adding too many Lightmass Portals) can drastically increase your Lightmass build times.

  • Only use Lightmass Portals on very small levels as Lightmass Portals are not occluded by anything. Using them in big open world-type levels will result in longer-than-needed light baking times.

  • If you are using Static Meshes for Emissive light casters and the results are noisy, place a Lightmass Portal around the area where the Static Meshes' light is supposed to be emitted from.

Help shape the future of Unreal Engine documentation! Tell us how we're doing so we can serve you better.
Take our survey