Legacy Documentation: Version 2018.1 (Go to current version)
HoloLens Spatial Mapping
The settings below are common to both __Spatial Mapping Renderer__ and __Spatial Mapping Collider__ components.
Other Versions

Spatial Mapping components

To facilitate Spatial Mapping in Unity and allow easy access to its features, Unity provides two Spatial Mapping XR components:

You can use these components together or independently. Each Spatial Mapping component uses its own SurfaceObserver to understand changes to the physical world. Each Spatial Mapping component periodically queries the Spatial Mapping system to understand what changes have occurred in the physical environment (how often they perform these queries depends on how you configure them). When the system notifies the component of relevant changes, the component prioritizes baking the various changed Surfaces.

The baking process involves generating a Mesh Filter with a Mesh that corresponds to the physical Surface. The components use this Mesh Filter in their own specific ways.

Each Spatial Mapping component is independent of other Spatial Mapping components. This means that each component maintains its own list of Surfaces, even if multiple components see the same Surface. We recommend that you limit the number of Spatial Mapping components you use, in order to optimize performance.


  • 2018–05–01 Page published with editorial review

  • Spatial Mapping for Hololens documentation updated in 2017.3

Did you find this page useful? Please give it a rating:

HoloLens Spatial Mapping
The settings below are common to both __Spatial Mapping Renderer__ and __Spatial Mapping Collider__ components.