> ## Documentation Index
> Fetch the complete documentation index at: https://docs.explo.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Custom Map Boundaries

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