Click the New map button on your account page to create a new map. You can customize this map, add layers and markers, and embed it into your website or application.
MapBox allows you to customize the colors of your map to fit the look and feel of your app or brand.
Click the edit button to expand the map’s edit drawer and select the Layers tab. To change the map colors you can select from the list of availabile presets or use the sun button to reveal color sliders for each layer. Each layer has three sliders:
Click Save to make your changes permanent.
By default your map will use labels in the native language of each area. Click the en button next to the Streets layer to use English-language labels where available.
Click the 2x button next to the Streets layer to increase text and feature size by two times, which will make the map suitable for Retina displays.
This change will apply to the entire map. If you need a retina version and a non-retina version create another map and switch between them based on device resolution. Learn more about using the Retina option on iOS in the MapBox iOS SDK Guide.
Enable the Satellite layer to add aerial imagery to your map. Read the announcement blog post for information about coverage.
Click the mountain button next to the Areas layer to enable a terrain visualization featuring hillshading and elevation contour lines.
Map privacy allows you to show/hide a map from your public account page and API listing requests. Private maps are still accesible if you know the URL.
Click the Settings icon in the left panel and Authorize TileMill to upload directly to your MapBox account. You may be asked to login to MapBox.
Click the Upload option in the TileMill exports panel. You will see a popup with a preview of your layer so you can check it one last time. Once you’re ready click the Upload button.
Once your layer is uploaded click View to preview the map on MapBox.
After your layer is validated it will ready for use as a layer in other maps.
If your MBTiles does not pass validation contact support with the complete error message.
Click the Add layer button under the Layers tab of your map.
Choose the custom layer to add from the thumbnails displayed. If you have not designed and uploaded any custom layers yet, see the Designing section above to upload your first custom layer.
You can remove any custom layers by clicking the X and reorder custom layers by dragging them in the layers list. Click Save when you’re done to make any changes permanent.
MapBox embeds are the easiest way to share maps on any website - you can copy & paste code that adds a full, dynamic map to any page. From your map’s page click the edit button, then click Embed. Click the text box labeled HTML embed code and copy the text, then paste the code into your website.
You are required to provide attribution to OpenStreetMap and its contributors when using one or more of the Streets, Buildings, Areas, Water, and Land layers on a map.
There are a few different ways to display attribution based on publishing method:
mapbox.auto(), attribution is displayed automatically. Otherwise, you must manually add the attribution control.
To embed your map in WordPress you may want to install the MapBox WordPress plugin. The plugin converts MapBox embed codes into a WordPress shortcode, making it easy to edit embeds once they’ve been added to your site.
Drupal sites usually implement content filters that restrict the HTML tags that are allowed on pages. When embedding a MapBox map on a Drupal site look for an input format called Full HTML or Extended HTML that allows
iframe tags to be used. If you have trouble pasting your embed into a Drupal site, ask a site administrator to set up an input format that allows
|Poisoned Places: Air Pollution In Your Town NPR News||Opportunity Index Opportunity Nation|
|Connect America Fund: Putting Consumers on the Map The FCC||PRCC Disaster Data Pacific Rim Coordination Center|
|Durban: World Bank Publishes High Resolution Climate Predictions Development Seed||U.S. Census Map NPR News|
|A New Running Map Tom MacWright||Where people get towed in Boston The Boston Globe|
|Rooftop Solar Challenge to Cut Solar’s Red Tape Department of Energy||Horn of Africa Crisis Interactive Map ONE|
Here’s a rough breakdown between the capabilities of embeds and APIs:
|Interaction||Yes||Yes + custom CSS|
|Legends||Yes||Yes + custom CSS|
|Animation with Easey||No||Yes|
|Dynamic layer switcher||No||Yes|
|Integration with external APIs||No||Yes|
Embeds work well for
The API can generate static images of maps for use on the web and mobile devices. Each static map image counts as 1 map view. For more information, see the developer documentation.
Click the Stats link on your account page to see account level statistics or click the statistics button on a map page to see map level statistics.
MapBox Streets is re-rendered with up to date OpenStreetMap data roughly once per month.
Use the map feedback form to let us know.
The stylesheets for MapBox Streets are not available. You may be interested in taking a look at OSM Bright, an open-source streetmap template from MapBox.
You can permanently delete a map from your account page. Find the map you want to delete and click the delete button.
If you have a paid account, additional map views are automatically served at $0.50 per 1,000 map views making it easy and affordable to handle temporary spikes in traffic. And we’ll notify you so you can switch plans if necessary.
If you have a free account, you can upgrade your plan to keep your maps online.
Web maps consist of many individual image tiles and as users interact with maps by panning or zooming more tiles are loaded. We measure a single map view as 15 map tiles which is typical for a single page view on most websites. Multiple map views can be generated during a single session as your users explore and interact with the map.
MapBox can help you with custom mapping work and help implement bleeding edge mapping technologies. Contact us and we’ll be happy to discuss your situation and what we can offer.
You can pay for your MapBox account using a Visa, Mastercard, American Express or Discover card. If you do not have access to one of these cards consider using a prepaid card instead. Prepaid cards are available from several vendors, including:
On a case-by-case basis, we offer invoicing for annual Plus and Premium subscriptions. Contact support for details.
Are you sure you want to completely delete your account? If you’re not using your plan you may just want to cancel your subscription and keep your account for free with 3,000 map views per month and 50 MB of storage.
If you really want to delete your account, follow these steps.
It is not possible to change your username as doing so would break API URLs, which could cause unanticipated problems. Instead you may signup for a new account, copy over your maps, and update your web and mobile applications to reference the new account and maps. Once this transition is complete, you can optionally cancel the old account.
We send you a receipt via email each time we charge you and you can access complete statements for your account.
You can provide optional contact information to display on your statements.
If you’re having trouble logging in try resetting your password by providing the email address that’s associated with your MapBox account. We’ll send you an email with further instructions.
If you don’t remember your email address or you’re having other access problems contact support and we’ll look into it.
There are some quick and easy ways to make sure you are getting the most storage and transfer possible out of your MapBox account.
By default TileMill uses the png (24-bit) as its image format when uploading or exporting a map. While this format provides very high image quality many maps can make use of the more efficient png (8-bit) or jpeg formats with little noticeable effect. Changing your map to use one of these formats can greatly reduce your storage and transfer usage.
To adjust the format of a map, open its project in TileMill and click the Project settings icon on the top right.
Then choose from the Format dropdown your desired format and Save. Upload or export your map again to make use of your changes in your MapBox account.