##  circle  â

A ` circle ` style layer renders one or more filled circles on a map. You can
use a circle layer to configure the visual appearance of point or point
collection features in vector tiles. A circle layer renders circles whose
radii are measured in screen units.

This [ cluster map ](https://docs.mapbox.com/mapbox-gl-js/example/cluster/)
uses a circle layer with a GeoJSON data source and sets the source's [ `
cluster ` ](/style-spec/reference/sources/#geojson-cluster) property to ` true
` to visualize points as clusters.

###  circle-blur  â

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

Amount to blur the circle. 1 blurs the circle such that only the centerpoint
is full opacity.

SDK Support  |  Mapbox GL JS  |  Android SDK  |  iOS SDK   
---|---|---|---  
basic functionality  |  >= 0.10.0  |  >= 2.0.1  |  >= 2.0.0   
data-driven styling  |  >= 0.20.0  |  >= 5.0.0  |  >= 3.5.0   
  
###  circle-color  â

[ Paint ](/style-spec/reference/layers/#paint-property) property.  Optional  [
color ](/style-spec/reference/types/#color) .  Defaults to ` "#000000" ` .
Supports  _[ combine  ` feature-state ` ](/style-
spec/reference/expressions/#feature-state) _ and [ smooth-ramp  ` interpolate
` ](/style-spec/reference/expressions/#interpolate) expressions.  opacity
Transitionable.

The fill color of the circle.

SDK Support  |  Mapbox GL JS  |  Android SDK  |  iOS SDK   
---|---|---|---  
basic functionality  |  >= 0.10.0  |  >= 2.0.1  |  >= 2.0.0   
data-driven styling  |  >= 0.18.0  |  >= 5.0.0  |  >= 3.5.0   
  
###  circle-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   
  
###  circle-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  _[ combine  ` feature-state `
](/style-spec/reference/expressions/#feature-state) _ and [ smooth-ramp  `
interpolate ` ](/style-spec/reference/expressions/#interpolate) expressions.
opacity  Transitionable.

The opacity at which the circle will be drawn.

SDK Support  |  Mapbox GL JS  |  Android SDK  |  iOS SDK   
---|---|---|---  
basic functionality  |  >= 0.10.0  |  >= 2.0.1  |  >= 2.0.0   
data-driven styling  |  >= 0.20.0  |  >= 5.0.0  |  >= 3.5.0   
  
###  circle-pitch-alignment  â

[ Paint ](/style-spec/reference/layers/#paint-property) property.  Optional  [
enum ](/style-spec/reference/types/#enum) .  One of  ` "map" ` , ` "viewport"
` .  Defaults to ` "viewport" ` .

Orientation of circle when map is pitched.

` "map" ` :

    

The circle is aligned to the plane of the map.

` "viewport" ` :

    

The circle is aligned to the plane of the viewport.

SDK Support  |  Mapbox GL JS  |  Android SDK  |  iOS SDK   
---|---|---|---  
basic functionality  |  >= 0.39.0  |  >= 5.2.0  |  >= 3.7.0   
  
###  circle-pitch-scale  â

[ Paint ](/style-spec/reference/layers/#paint-property) property.  Optional  [
enum ](/style-spec/reference/types/#enum) .  One of  ` "map" ` , ` "viewport"
` .  Defaults to ` "map" ` .

Controls the scaling behavior of the circle when the map is pitched.