##  background  â

The ` background ` style layer covers the entire map. Use a background style
layer to configure a color or pattern to show below all other map content. If
the background layer is transparent or omitted from the style, any part of the
map view that does not show another style layer is transparent.

The [ Vintage map style ](https://blog.mapbox.com/designing-the-vintage-style-
in-mapbox-studio-9da4aa2a627f) uses a custom SVG [ ` background-pattern `
](/style-spec/reference/layers/#paint-background-background-pattern) to
achieve a textured vintage look.

###  background-color  â

[ Paint ](/style-spec/reference/layers/#paint-property) property.  Optional  [
color ](/style-spec/reference/types/#color) .  Defaults to ` "#000000" ` .
_Disabled by_ background-pattern  .  Supports  [ smooth-ramp  ` interpolate `
](/style-spec/reference/expressions/#interpolate) expressions.  opacity
Transitionable.

The color with which the background will be drawn.

SDK Support  |  Mapbox GL JS  |  Android SDK  |  iOS SDK   
---|---|---|---  
basic functionality  |  >= 0.10.0  |  >= 2.0.1  |  >= 2.0.0   
  
###  background-emissive-strength  â

[ Paint ](/style-spec/reference/layers/#paint-property) property.  Optional  [
number ](/style-spec/reference/types/#number) greater than or equal to ` 0 ` .
Units in  intensity  .  Defaults to ` 0 ` .  _Requires_ lights  .  Supports  [
smooth-ramp  ` interpolate ` ](/style-spec/reference/expressions/#interpolate)
expressions.  opacity  Transitionable.

Controls the intensity of light emitted on the source features.

SDK Support  |  Mapbox GL JS  |  Android SDK  |  iOS SDK   
---|---|---|---  
basic functionality  |  >= 3.0.0  |  >= 11.0.0  |  >= 11.0.0   
  
###  background-opacity  â

[ Paint ](/style-spec/reference/layers/#paint-property) property.  Optional  [
number ](/style-spec/reference/types/#number) between ` 0 ` and ` 1 `
inclusive  .  Defaults to ` 1 ` .  Supports  [ smooth-ramp  ` interpolate `
](/style-spec/reference/expressions/#interpolate) expressions.  opacity
Transitionable.

The opacity at which the background will be drawn.

SDK Support  |  Mapbox GL JS  |  Android SDK  |  iOS SDK   
---|---|---|---  
basic functionality  |  >= 0.10.0  |  >= 2.0.1  |  >= 2.0.0   
  
###  background-pattern  â

[ Paint ](/style-spec/reference/layers/#paint-property) property.  Optional  [
resolvedImage ](/style-spec/reference/types/#resolvedImage) .

Name of image in sprite to use for drawing an image background. For seamless
patterns, image width and height must be a factor of two (2, 4, 8, ..., 512).
Note that zoom-dependent expressions will be evaluated only at integer zoom
levels.

SDK Support  |  Mapbox GL JS  |  Android SDK  |  iOS SDK   
---|---|---|---  
basic functionality  |  >= 0.10.0  |  >= 2.0.1  |  >= 2.0.0   
  
###  visibility  â

[ Layout ](/style-spec/reference/layers/#layout-property) property.  Optional
[ enum ](/style-spec/reference/types/#enum) .  One of  ` "visible" ` , `
"none" ` .  Defaults to ` "visible" ` .

Whether this layer is displayed.

` "visible" ` :

    

The layer is shown.

` "none" ` :

    

The layer is not shown.

SDK Support  |  Mapbox GL JS  |  Android SDK  |  iOS SDK   
---|---|---|---  
basic functionality  |  >= 0.10.0  |  >= 2.0.1  |  >= 2.0.0   
expressions support  |  >= 3.0.0  |  >= 11.0.0  |  >= 11.0.0