Documentation

Unity Engine

User Manual

Script Reference

Unity Engine

Remove a baked occlusion culling setup

Remove baked occlusion culling data and settings from a scene that no longer needs them.
Read time 3 minutesLast updated 2 days ago
Remove the data, components, and properties that a scene uses for baked occlusion culling.
Baked occlusion culling is deprecated and will be removed in a future release. If a scene no longer needs baked occlusion culling, remove its setup to prevent Unity from generating and loading occlusion culling data for that scene and to reduce the size of your project.
Unity hides the Occlusion Culling window in projects you create in Unity 6.7 and later, so these steps apply to projects that you created in an earlier version and upgraded to a newer version.
Removing the setup doesn't change how Unity performs frustum culling, which excludes renderers that fall outside a camera's view frustum. If your project uses the Universal Render Pipeline (URP) or the High Definition Render Pipeline (HDRP), you can instead Enable GPU occlusion culling in URP or Enable GPU occlusion culling in HDRP.

Remove baked occlusion culling from a scene

Complete both of the following procedures. If you clear the baked data but leave the components and properties in place, Unity rebuilds the data the next time you bake the scene.

Clear the baked data

To clear the baked occlusion culling data:
  1. Open the scenes you want to change. If you baked several scenes together, open all of them, because they share a single 
    OcclusionCullingData.asset
    file.
  2. Close any other scenes. Unity clears the data from every scene that's open, not only the scenes you want to change.
  3. In the main menu, go to Window > Rendering >
    Occlusion Culling

    ?

    .
  4. Select the Bake tab.
  5. Select Clear. Unity clears the occlusion culling data from every open scene and deletes the 
    OcclusionCullingData.asset
    file that stores the data.
  6. Save each open scene to make the change persistent.

Remove the occlusion culling components and properties

To remove the occlusion culling components and properties from a scene:
  1. Select the GameObjects that you marked as Static Occluders or Static Occludees.
  2. In the
    Inspector

    ?

    window, open the Static Editor Flags dropdown, then disable Occluder Static and Occludee Static.
  3. Select each GameObject that has an Occlusion Area or Occlusion Portal component, then remove the component.
  4. Select each camera that has Occlusion Culling enabled, then disable the property.
  5. Select each Reflection Probe that has Use Occlusion Culling enabled, then disable the property.
  6. Select each renderer that has Dynamic Occlusion enabled, then disable the property.
  7. Save the scene.
The scene no longer uses baked occlusion culling, so Unity no longer excludes renderers that are hidden behind other GameObjects. This might increase the number of draw calls in scenes that previously relied on occlusion culling. If you use another form of occlusion culling, such as GPU occlusion culling, Unity continues to exclude occluded renderers. To check the effect on your project, refer to Graphics performance and profiling.

Additional resources