Note: This documentation is for the old 0.2.0 version of A-Frame. Check out the documentation for the current 0.5.0 version

The sky primitive adds a background to a scene or display a 360-degree photo. It is an entity that prescribes a large sphere with the material mapped to the inside.


An equirectangular image as a background:

<a-sky src="sky.png"></a-sky>

A plain color as a background:

<a-sky color="#6EBAA7"></a-sky>


Note that the sky primitive inherits common mesh attributes.

Attribute Component Mapping Default Value
radius geometry.radius 5000
segments-height geometry.segmentsHeight 64
segments-width geometry.segmentsWidth 64

Equirectangular Image

In order to be seamless, images should be equirectangular. We can find some sample equirectangular images on Flickr. To take an equirectangular photo, check out this 360-degree photography guide.