Icon layers are a type of point layer. They allow you to differentiate between points by assigning icons to points based on a field.

An example of the Icon Layer.

Using Icons

For example, you might use icons to differentiate between types of venues and points of interest.

To see the icon menu, create a new icon layer and click How to:

Settings

All settings for the Icon Layer are described below.

Core settings for the Icon Layer.

Setting	Description
Layer Type	Must be Icon to display the Icon layer.
Dataset	The dataset to use for the Icon Layer.
Columns	Specify a lat/lng pair, an icon field, and optionally an altitude field.

Color settings for the Icon Layer.

Setting	Description
Color Based On	The field to base the icons' color on.
Color Scale	The color scale and palette for the icon color.
Opacity	The opacity of the icons.

Radius settings for the Icon Layer.

Setting	Description
Radius Slider	Set a minimum and maximum radius for the icons.
Radius Based On	The field to base the radius size on.
Radius Scale	The scale to base radius on. Choose from linear, square root, and log.
Fixed Radius to Meter	Map radius to meter. E.g., 5 radius equals 5 meters.
Billboard	Orients points toward the camera.

Label settings for the Icon Layer. Labels are attached to icon locations.

Setting	Description
Label Field	Select a field to display on the label.
Font Size	The size of the font to use on the label.
Font Color	The color of the label font.
Outline Width	The width of the outline in pixels. Set to `0` to disable the outline.
Outline Color	The color for the outline label.
Background Color	Toggle to enable a background color for the label. Choose a color with the color selector.
Text Anchor	Where, relative to the icons, to anchor the text. Choose from start, middle, or end.
Alignment	How to align the text. Choose from top, middle, or bottom.
+ Add More Labels	Add another label to the icons.

For details on how to programmatically specify layer properties, refer to the Studio Layer Configuration specification.