The Custom Map Boundaries feature allows you to use custom Mapbox configurations for your choropleth maps, enabling support for specialized boundary types.

​
Prerequisites

Before using custom map configurations, you’ll need:

  • A Mapbox API key with access to your custom tilesets
  • Knowledge of your boundary configuration details:
    • Source layer name
    • Tileset ID
    • Boundary format (column name for matching)

​
Setting Up Your Mapbox API Key

  1. Navigate to your team settings
  2. Locate the “Custom Map Boundaries Configuration” section
  3. Enter your Mapbox API key
  4. Save the configuration

​
Configuring Custom Boundaries

When creating or editing a choropleth map:

  1. Select “Custom” as the boundary type
  2. Configure the following settings:
    • Custom Boundary Source Layer: The name of your source layer (e.g., “custom-regions”)
    • Custom Boundary Tileset: Your Mapbox tileset ID (e.g., “mapbox://your-tileset-id”)
    • Custom Boundary Format: The column name in your tileset that contains the matching values (e.g., “postcode”)

​
Default Behavior

If any custom settings are left unspecified:

  • Source Layer: Defaults to the standard states layer
  • Tileset: Uses the default Explo engineering tileset
  • Boundary Format: Uses standard state format (STUSPS)

​
Troubleshooting

If your custom map configuration isn’t working:

  • Verify your Mapbox API key has access to the specified tileset
  • Ensure the boundary format matches exactly with your data column names
  • Check that your source layer name matches the one in your Mapbox tileset
Duplicating DashboardsDatasets