Skip to Content

Mapbox Integration

Connect Mapbox to your Ycode project to use the Mapbox provider in Map elements. Mapbox offers more map styles and controls compared to Google Maps, including custom marker colors and navigation overlays.

Setup

  1. Go to the Mapbox dashboard  and create or copy an access token
  2. In Ycode, go to Integrations > Apps
  3. Find Mapbox and enter your access token
  4. Save the configuration

Environment Variable

You can also provide the access token via the MAPBOX_ACCESS_TOKEN environment variable. When set, the integration shows a “Connected” status on the Apps page and the token cannot be changed through the UI.

MAPBOX_ACCESS_TOKEN=pk.eyJ1Ijo...

This is useful for self-hosted deployments where you manage secrets through environment configuration.

Usage

Once connected, select Mapbox as the provider in any Map element’s settings. Mapbox supports five map styles:

StyleDescription
StreetsDetailed street map (default)
SatelliteAerial satellite imagery with street labels
LightMinimal light-themed map
DarkMinimal dark-themed map
OutdoorsTerrain and trail-focused map

Mapbox also supports configurable marker colors and additional map controls (navigation, scale bar). See the Map element documentation for all available settings.

Mapbox offers a generous free tier. Check the Mapbox pricing page  for current limits.

Last updated on