Troubleshooting

Resolve common issues across Mapbox products.

Address geocoding format guide

Follow these best practices when formatting addresses for geocoding.

Adjust the zoom extent of your tileset

Learn how to manually adjust the zoom extent of your tilesets.

Blank or missing map tiles

Learn why you may be seeing blank or missing tiles.

Browser support

Learn which browsers support each Mapbox product.

Change your map’s label language

Learn about available languages and how to change your map’s language.

Collaboration best practices

Learn best practices for setting up an account and collaborating on projects.

Learn how to address CORS errors.

CSV file errors

Learn how to fix errors when uploading CSV files.

How area is calculated for Mapbox Tiling Service and the Uploads API

Learn how area is calculated when you upload a tileset using Mapbox Tiling Service or the Uploads API.

How to get support while building with Mapbox

Learn about all the different options for support while you are building location applications with Mapbox.

How to regain access to your account

Learn to troubleshoot common account lockout scenarios.

How to use Mapbox securely

Learn how to use Mapbox securely.

Improve the performance of Mapbox GL JS maps

Learn how to improve the performance of your Mapbox GL JS maps.

Japan-specific considerations for the Search API

Learn how to tailor requests to the Search API for use in Japan. During public beta, the Search API is only available for Japanese-language queries for locations in Japan.

Keep access tokens private in open source iOS and Android apps

Learn how to protect your access tokens so that they aren't used by others.

Manage your fontstacks

Learn how to manage fontstacks for optimal rendering.

Manage your tileset processing and tileset hosting costs

Follow these practices to optimize your tileset processing and tileset hosting costs when you tile data using Mapbox Tiling Service (MTS) or the Mapbox Uploads API.

Manage your web map costs

Learn how to manage your costs for common web map implementations that use Mapbox products including Mapbox GL JS, the Static Images API, and the Static Tiles API.

Maps APIs Caching

Learn how to work with caching in Mapbox's Maps APIs.

Migrate from Mapbox Streets v7 to v8

Tips for upgrading to the latest Mapbox base map tileset.

Migrating to the modern Static Tiles API

Update your Leaflet.js or Mapbox.js implementation to use the modern Mapbox Static Tiles API.

Multilayer tilesets

Learn when to create a multilayer tileset.

Learn about how offline maps work.

Optimize map label placement

Optimize label placement on web and mobile maps.

Report a problem with the map

Learn how to report errors on Mapbox maps.

Source limits in Mapbox Studio styles

Read about strategies for reducing the number of tileset sources in Mapbox Studio styles.

Transfer styles between accounts

Learn how to transfer Mapbox styles between accounts.

Transition from Mapbox.js to Mapbox GL JS

Learn about transitioning from using Mapbox.js to using Mapbox GL JS in your apps.

Troubleshoot raster image with black background

Learn how to fix raster images that display black backgrounds.

Troubleshooting App Store submission with the Mapbox Maps SDK for iOS

Learn how to troubleshoot frequently seen issues when submitting applications built with the Mapbox Maps SDK for iOS to the App Store.

Troubleshooting Mapbox Maps and Navigation SDKs for iOS installation

Learn how to troubleshoot frequently seen issues when installing the Mapbox Maps or Navigation SDK for iOS.

Troubleshooting SVG image errors in Mapbox Studio

Learn how to fix SVG upload errors in Mapbox Studio.

Understand the Tilesets Processing and Hosting line items on your Mapbox invoice

This troubleshooting guide shows you how to determine which of your tilesets are contributing the most to your tilesets line items on your invoice.

Understanding Android APK size

Learn how to measure and optimize your Android app’s size.

Understanding iOS framework size

Learn how to measure and optimize your iOS app’s size.

Upload data to Mapbox

Learn how to prepare data for upload, interpret error messages, and troubleshoot failed uploads.

Upload large source files to Mapbox Tiling Service

Learn how to troubleshoot long Mapbox Tiling Service upload times.

Use custom Mapbox styles in Tableau

General configuration guidance and tips for using custom Mapbox maps in Tableau.

Using recolorable images in Mapbox maps

Learn how Mapbox uses recolorable images in maps including SDF-enabled images and iOS's template rendering mode.

Working with firewalls

General troubleshooting tips and some configuration guidance for working with Mapbox behind a firewall.

Working with large GeoJSON sources in Mapbox GL JS

Strategies for handling large GeoJSON sources with GL JS.