All docschevron-rightarrow-leftMaps SDK for iOSchevron-rightGuides

Maps SDK for iOS

Current version: v10.16.0View changelog

  • check
    Custom map styling
  • check
    Runtime styling
  • check
    Camera manipulation
  • check
    Querying the map
  • check
    User interaction
New version of Maps SDK for iOS now available in public beta

Maps SDK v11 for iOS enhances the quality, convenience and developer experience of our mobile SDK and sets the foundation for the future of Mapbox maps. Upgrading allows access to the latest features, including our new Mapbox Standard 3D style. Follow our migration guide.

The Mapbox Maps SDK for iOS is a library for embedding highly customized maps within iOS applications.

Use custom map styles. Start with one of our Mapbox-designed styles that are optimized for various use cases or design your own custom style in Mapbox Studio. Enhance the experience with 3D terrain. You can even alter your map's style at runtime.

Add your own custom data to the map. Whether you're adding markers to a map to include a store locator right in your app or creating compelling data visualizations, the Maps SDK gives you control over how you display data on your map. You can style map features at runtime based on data properties, user interaction, or device settings.


The Mapbox Maps SDK for iOS is compatible with applications that are:

  • Built in Xcode 13 or higher
  • Written in Swift version 5.3 or higher
  • Deployed on iOS 11 or higher

Use with other Mapbox tools

Use the Mapbox Maps SDK for iOS with other Mapbox products. Mix and match other tools and plugins to create a location-savvy application to your exact specifications.

Static maps

The Mapbox Maps SDK for iOS includes methods to generate a static snapshot of an existing map within your application. Use the Snapshotter class to create a static raster image of a map, without having to make a request to another API.

Deliver a consistent experience across your companion tvOS and watchOS applications with static map snapshots using MapboxStatic.swift, powered by the Mapbox Static API.

Mapbox Studio

The Mapbox Maps SDK is compatible with Mapbox Studio. Design a map that seamlessly matches your brand and application design, then infuse it with your own custom data all within the Mapbox Studio web interface.



You must include the Mapbox wordmark on any map that uses the Mapbox Maps SDK for iOS. You must display attribution on maps unless the map's data comes entirely from non-Mapbox sources.

You may adjust the position of the Mapbox wordmark and attribution notice, but they must stay visible on the map. You may also change the background and text color of the attribution notice to match your design aesthetics, but all information must be legible.

You may not otherwise alter the Mapbox wordmark or text attribution notice.

Attribution guidelines

Learn more about what kinds of attribution Mapbox requires and why.


Telemetry opt out

Mapbox Telemetry is a powerful location analytics platform included in this SDK. By default, the SDK sends de-identified location and usage data to Mapbox whenever the host app causes it to be gathered. The Mapbox Terms of Service require your app to provide users with a way to individually opt out of Mapbox Telemetry, which is provided automatically as part of the attribution control. If you hide the attribution control, you must provide an alternative opt out for your users to use.

Older versions of the SDK

Looking for an older version of the Maps SDK? See the Maps SDK v6 documentation.