You are using an outdated browser and will encounter some problems with our website. Please consider upgrading.
Upgrade Now
Docs
Maps
Navigation
Search
Data
Help
Docs
Maps
Navigation
Search
Data
Help
All docs
Help
Search
Getting Started
chevron-down
Tutorials
How-to Videos
Troubleshooting
Glossary
All docs
chevron-right
arrow-left
Help
chevron-right
Troubleshooting
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.
Choose between Markers and Layers for point data in Mapbox GL JS
Learn the differences between two methods of rendering point data, markers and layers.
Collaboration best practices
Learn best practices for setting up an account and collaborating on projects.
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.
Multilayer tilesets
Learn when to create a multilayer tileset.
Offline maps
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.
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.
arrow-up