##  sky  â

Warning

As of [ v2.9.0 ](https://github.com/mapbox/mapbox-gl-js/releases/tag/v2.9.0) ,
[ fog ](/style-spec/reference/fog/) is the preferred method for atmospheric
styling. Sky layer is not supported by the [ globe
](https://docs.mapbox.com/mapbox-gl-js/guides/projections/#globe) projection,
and will be phased out in a future release.

A ` sky ` style layer renders a stylized spherical dome that encompasses the
entire map and is automatically rendered behind all layers. This can be used
to fill the area above the horizon with a simulated sky that represents a
particular time-of-day, or stylized custom gradients.

A simulated sunrise over the deserts of California using [ ` sky-type:
'atmosphere' ` ](/style-spec/reference/layers/#paint-sky-sky-type) paint
property.

###  sky-atmosphere-color  â

[ Paint ](/style-spec/reference/layers/#paint-property) property.  Optional  [
color ](/style-spec/reference/types/#color) .  Defaults to ` "white" ` .
_Requires_ sky-type  to be  ` "atmosphere" ` .

A color used to tweak the main atmospheric scattering coefficients. Using
white applies the default coefficients giving the natural blue color to the
atmosphere. This color affects how heavily the corresponding wavelength is
represented during scattering. The alpha channel describes the density of the
atmosphere, with 1 maximum density and 0 no density.

SDK Support  |  Mapbox GL JS  |  Android SDK  |  iOS SDK   
---|---|---|---  
basic functionality  |  >= 2.0.0  |  >= 10.0.0  |  >= 10.0.0   
  
###  sky-atmosphere-halo-color  â

[ Paint ](/style-spec/reference/layers/#paint-property) property.  Optional  [
color ](/style-spec/reference/types/#color) .  Defaults to ` "white" ` .
_Requires_ sky-type  to be  ` "atmosphere" ` .

A color applied to the atmosphere sun halo. The alpha channel describes how
strongly the sun halo is represented in an atmosphere sky layer.

SDK Support  |  Mapbox GL JS  |  Android SDK  |  iOS SDK   
---|---|---|---  
basic functionality  |  >= 2.0.0  |  >= 10.0.0  |  >= 10.0.0   
  
###  sky-atmosphere-sun  â

[ Paint ](/style-spec/reference/layers/#paint-property) property.  Optional  [
array ](/style-spec/reference/types/#array) of  [ number  s ](/style-
spec/reference/types/#number) [  between ` 0 ` and ` 360 ` inclusive  ,
between ` 0 ` and ` 180 ` inclusive  ]  .  Units in  degrees  .  _Requires_
sky-type  to be  ` "atmosphere" ` .

Position of the sun center [a azimuthal angle, p polar angle]. The azimuthal
angle indicates the position of the sun relative to 0Â° north, where degrees
proceed clockwise. The polar angle indicates the height of the sun, where 0Â°
is directly above, at zenith, and 90Â° at the horizon. When this property is
ommitted, the sun center is directly inherited from the light position.

SDK Support  |  Mapbox GL JS  |  Android SDK  |  iOS SDK   
---|---|---|---  
basic functionality  |  >= 2.0.0  |  >= 10.0.0  |  >= 10.0.0   
  
###  sky-atmosphere-sun-intensity  â

[ Paint ](/style-spec/reference/layers/#paint-property) property.  Optional  [
number ](/style-spec/reference/types/#number) between ` 0 ` and ` 100 `
inclusive  .  Defaults to ` 10 ` .  _Requires_ sky-type  to be  ` "atmosphere"
` .

Intensity of the sun as a light source in the atmosphere (on a scale from 0 to
a 100). Setting higher values will brighten up the sky.

SDK Support  |  Mapbox GL JS  |  Android SDK  |  iOS SDK   
---|---|---|---  
basic functionality  |  >= 2.0.0  |  >= 10.0.0  |  >= 10.0.0   
  
###  sky-gradient  â

[ Paint ](/style-spec/reference/layers/#paint-property) property.  Optional  [
color ](/style-spec/reference/types/#color) .  Defaults to `
["interpolate",["linear"],["sky-radial-progress"],0.8,"#87ceeb",1,"white"] ` .
_Requires_ sky-type  to be  ` "gradient" ` .  Supports  [ smooth-ramp  `
interpolate ` ](/style-spec/reference/expressions/#interpolate) expressions.

Defines a radial color gradient with which to color the sky. The color values
can be interpolated with an expre