NOTE: This version of the documentation tracks unstable development happening on A-Frame’s master branch. If you wish to try it out, grab the unstable build. Otherwise, head to the documentation for the current 1.2.0 version

The background component sets a basic color background of a scene that is more performant than a-sky since geometry is not created. There are no undesired frustum culling issues when a-sky is further than the far plane of the camera. There are no unexpected occlusions either with far objects that might be behind of the sphere geometry of a-sky.

The background component can also generate a default environment cube map for all materials, if you find GLB models end up too dark or reflective materials don’t reflect the environment this will provide a default reflective environment.


The example below sets the background color to red.

<a-scene background="color: red"></a-scene>


Property Description Default Value
color Color of the scene background. black
transparent Background is transparent. The color property is ignored. false
generateEnvironment Whether to generate a default environment true