Skip to main content

Style circles with a data-driven property

This example adds circles to a map to represent individual responses to the 2010 U.S. Census, and then sets the color of each circle according to the ethnicity property for each point.

The point features in the vector tileset source each have an ethnicity property, as shown in this sample feature:

"type": "Feature",
"properties": {
"ethnicity": "Asian"
"geometry": {
"type": "Point",
"coordinates": [-122.447303, 37.753574]

The example uses a match data expression to set the circle-color paint property for each point, using #fbb03b for White, #223b53 for Black, #e55e5e for Hispanic, #3bb2d0 for Asian, and #ccc for any other value.

Use a custom tileset

This example uses 2010 U.S. Census data uploaded to Mapbox as a vector tileset. This data is not updated or maintained and should not be used in production applications. If you're interested in creating an application that uses U.S. Census data, you can download a Shapefile from's data portal and upload it from your Mapbox Studio Tilesets page.

<!DOCTYPE html>
<meta charset="utf-8">
<title>Style circles with a data-driven property</title>
<meta name="viewport" content="initial-scale=1,maximum-scale=1,user-scalable=no">
<link href="" rel="stylesheet">
<script src=""></script>
body { margin: 0; padding: 0; }
#map { position: absolute; top: 0; bottom: 0; width: 100%; }
<div id="map"></div>
mapboxgl.accessToken = 'YOUR_MAPBOX_ACCESS_TOKEN';
const map = new mapboxgl.Map({
container: 'map',
// Choose from Mapbox's core styles, or make your own style with Mapbox Studio
style: 'mapbox://styles/mapbox/light-v11',
zoom: 12,
center: [-122.4473, 37.7535]

map.on('load', () => {
// Add the vector tileset as a source.
map.addSource('ethnicity', {
type: 'vector',
url: 'mapbox://examples.8fgz4egr'
'id': 'population',
'type': 'circle',
'source': 'ethnicity',
'source-layer': 'sf2010',
'paint': {
// Make circles larger as the user zooms from z12 to z22.
'circle-radius': {
'base': 1.75,
'stops': [
[12, 2],
[22, 180]
// Color circles by ethnicity, using a `match` expression.
'circle-color': [
['get', 'ethnicity'],
/* other */ '#ccc'
// Place polygons under labels, roads and buildings.

Was this example helpful?