HELP

What are the attribution requirements for my map?

According to our Terms of Service, you are required to attribute your maps, exposing the following links on all maps:

  • © Mapbox © OpenStreetMap linking to https://www.mapbox.com/about/maps/
  • Improve this map linking to https://www.mapbox.com/map-feedback/

You have three options to display attribution on your Mapbox maps:

  • Automatic attribution (preferred)
  • Attribution from TileJSON
  • Roll your own

Automatic attribution (preferred)

If you use Mapbox.js or the Mapbox iOS SDK, content and display of attribution is handled for you automatically.

Mapbox.js

Mapbox.js

If you use Mapbox.js and use L.map.mapbox(), attribution is automatically added.

Mapbox iOS SDK

iOS

Attribution is displayed automatically as an info button in the lower right of the map view which can be tapped to bring up an attribution view controller.

See the -[RMMapView hideAttribution:] API for more information.

Manual attribution

Mapbox Android SDK

You are responsible for displaying attribution in your app such as in a credits panel. Mapbox tile layers have a getAttribution() method which can provide the attribution string to display.

MBXMapKit

You are responsible for displaying attribution in your app such as in a credits view.

Attribution from TileJSON

If for some reason you cannot use the automatic attribution provided through Mapbox.js or the Mapbox iOS SDK, use the attribution string exposed through the TileJSON document that describes your map. The attribution field in the TileJSON document contains an HTML string with appropriate attribution content based on the sources used in your Mapbox map.

{"attribution": "<a href='https://www.mapbox.com/about/maps/' target='_blank'>&copy; Mapbox &copy; OpenStreetMap</a> <a class='mapbox-improve-map' href='https://www.mapbox.com/map-feedback/' target='_blank'>Improve this map</a>"}

Roll your own attribution

If you cannot use automatic attribution or attribution provided through TileJSON, you are responsible for ensuring the appropriate content and display of the map attribution.

For displaying your attribution you could use Leaflet attribution control for a web app or for a native mobile app, this might be a mention and link in your app’s credits or about panel.

var credits = L.control.attribution().addTo(map);
credits.addAttribution('Credits: Penny Dog Mapping Co.');

You can override the attribution control but when using Mapbox Streets, attribution will be added in addition to your own custom attribution.

var map = L.mapbox.map('map', 'examples.map-8ced9urs', {
        // remove the 'i'
        infoControl: false,
        // create a new attribution control
        attributionControl: true
    })
    .setView([45, -122], 14);

// Credit Foursquare for their wonderful data
map.attributionControl
    .addAttribution('<a href="https://foursquare.com/">Places data from Foursquare</a>');

Custom Attribution

Note that if you use one or more of the Streets, Buildings, Areas, Water, and Land layers available through Mapbox.com you are required to attribute OpenStreetMap and its contributors.

If you are using Mapbox Satellite or Terrain layers without Streets, you are still required to link to the Mapbox About pages as described in our Terms of Service.

Attributing your contributions to OpenStreetMap from Mapbox imagery

If you’re a contributor to OpenStreetMap using our imagery for tracing, and you want to annotate your edits with a source tag, you can add the tag source=mapbox to your edit.

OSM Mapbox Source