You are using an outdated browser and will encounter some problems with our website. Please consider upgrading.
Upgrade Now
Docs
Maps
Navigation
Search
Vision
Data
Help
Docs
Maps
Navigation
Search
Vision
Data
Help
All docs
Help
Getting started
Tutorials
Troubleshooting
Glossary
All docs
Help
Troubleshooting
Troubleshooting
Resolve common issues across Mapbox products.
Access elevation data
Learn how to access elevation data in Mapbox tilesets.
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.
CORS errors
Learn how to address CORS errors.
CSV file errors
Learn how to fix errors when uploading CSV files.
Get your PostGIS data ready for Mapbox Studio
Methods to re-format, query, and export PostGIS data into a Mapbox Studio ready format.
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.
Integrate the Mapbox Visual with Microsoft Power BI
General configuration guidance and tips for using the Mapbox Visual in Microsoft Power BI.
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 large data files for Mapbox Studio with Tippecanoe
Learn how to manage big data files and make a scale-independent view of your data.
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.
Migrate from Mapbox Streets v7 to v8
Tips for upgrading to the latest Mapbox base map tileset.
Migrating to the modern Static Images API
Tools and tips for updating to the modern Static Images API.
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.
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.
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.
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.