Understanding Map Layers in Builder

Intro Guides

Understanding Map Layers in Builder

Once datasets are connected to your CARTO account, use Builder to add map layers and discover key insights about your location data. This guide describes how to view and work with map layers in CARTO Builder.

If you are unsure how to connect data to your CARTO account, view the Getting Started with CARTO Builder Guide.

Viewing Map Layers in Builder

When opening a map in Builder for the first time, LAYERS and WIDGETS for the selected map appear. The LAYERS pane appears by default, displaying the basemap and map data layer(s) that are the backbone for rendering your visualization. The WIDGETS pane enables you to add interactive widgets for visualizing and filtering your data.

The following map displays a single layer in the LAYERS pane, which contains point geometries.

Basic map with one data layer

The default basemap, that is used to render the background image of your map, also appears in the LAYERS pane, Positron and Positron Labels. You can edit the basemap source and style, or keep the default basemap.

As another example, the following image displays a map with multiple layers, A and B. Note that layer A has an analysis A1 applied as part of the workflow for rendering the data, and the basemap was changed to Positron (labels below).

Multiple layers in Builder

Working with Map Layers

When working with layers in the LAYERS pane of Builder, the following features are available:

  • Click ADD to add a new layer to your map. The number of layers allowed is based on your account plan.

    Add layer

  • Layers are created alphabetically (A, B, C, D) and each layer displays a unique color. Each layer icon displays the geometry type behind the data as either point, line, polygon, or empty.

    Layers show geometry

    If your layer does not contain any geometries, you can create and manage data by drawing geometries. For datasets without geometries, apply the Georeference analysis option to your layer.
  • Layers are rendered from bottom to top, with basemaps being the bottom layer.

  • Click and drag a layer to rearrange the hierarchal order of how layers are rendered on your map.

    Why rearrange the hierarchal order of layers? When styling a map with multiple layers, the order of the layers reflects the order in which they are visualized. You may need to adjust the styling for each layer to accommodate conflicting features.

    Reorder layers from LAYERS pane

    You cannot reorder where the basemap (and the corresponding basemap label, if applicable) appears in the LAYER pane of Builder. This is intentional by design, so that your visualization appears correctly.
  • When you click on a layer, the DATA, ANALYSIS, STYLE, POP-UP, and LEGEND options are available for the selected layer.

    When a map layer is selected, you can access the CartoCSS view (from the STYLE tab of a selected layer), the HTML view (from the POP-UP tab and LEGEND tab of a selected layer), and the SQL view (from the DATA tab of a selected map layer).

    Selected layer and code views

  • The Data View and Map View appear as icons on your map visualization when a map layer is selected. Click to switch between viewing your connected dataset as a table, or show the map view of your data. Additionally, you can access the connected dataset directly from the selected layer.

    Data View and Map View icons

    The Map View also displays icons to edit the geometries in your connected map layer. These icons vary, depending on your data. For details, see the Create and Manage Data by Drawing Geometries Guide and the Editing Geometries with Analysis Guide.

    Edit geometry icons from Map View

  • If your connected dataset was modified, the map layer indicates that a SQL query was applied.

    SQL query applied

  • Show or Hide a layer from your visualization by clicking the eyeball icon. All layers are displayed by default. This is helpful when you are styling multiple layers, or if you want to show or hide selected layers for your published map.

    Show hide layers

  • Manage the details of the layer by clicking the three vertical dots, located next to the layer name. These options enable you to manage the details of your layer in Builder. For example, you can rename or delete a selected layer.

    Layer context menu

  • Center map on layer refreshes your Map View by centering the map on the selected layer. You can access this option from the map layer context menu, or from the icon when the map is selected.

    Center map on layer

  • If an analysis workflow is applied to your data, the layer displays the analyses nodes (A1, A2, B1, B2) that are applied to your layer.

    Analysis workflow applied to layer

  • Analysis nodes act like sublayers in association with each map layer that they are applied to. You can automatically create a new layer from analysis results by clicking the analysis node (A1, B2) from the LAYERS pane, and dragging it above or below the selected layer to create a new layer.

    Create layer from analysis result

    Similarly, you can click and drag the original source of data from a map layer to create a new layer.

    Create layer from original source of data

  • Analysis nodes (A1, B2) can be selected as the source for creating widgets, initiating dynamic filtering.

    Select analysis nodes for widgets

Now that you understand how to work with layers, explore your data by selecting each layer and apply custom styling, analysis, and widgets.