rnmapbox · mfazekas · Dec 21, 2025 · Dec 21, 2025
diff --git a/ios/install.md b/ios/install.md
@@ -25,9 +25,6 @@ Add the following to your `ios/Podfile`:
 
 <br>
 
-You will need to authorize your download of the Maps SDK with a secret access token with the `DOWNLOADS:READ` scope. This [guide](https://docs.mapbox.com/ios/maps/guides/install/#configure-credentials) explains how to configure the secret token under section `Configure your secret token`.
-
-
 Run `pod install` to download the proper mapbox dependency.
 
 ```sh

diff --git a/plugin/build/withMapbox.d.ts b/plugin/build/withMapbox.d.ts
@@ -6,6 +6,9 @@ export type MapboxPlugProps = {
      */
     RNMapboxMapsImpl?: 'mapbox';
     RNMapboxMapsVersion?: string;
+    /**
+     * @deprecated Download token is no longer required by Mapbox. Do not set this.
+     */
     RNMapboxMapsDownloadToken?: string;
     RNMapboxMapsUseV11?: boolean;
 };

diff --git a/plugin/install.md b/plugin/install.md
@@ -28,15 +28,6 @@ After installing this package, add the [config plugin](https://docs.expo.io/guid
 }
 ```
 
-You'll need to provide a download token. Set the `RNMAPBOX_MAPS_DOWNLOAD_TOKEN` environment variable to your download token (requires the `DOWNLOADS:READ` scope):
-
-```bash
-export RNMAPBOX_MAPS_DOWNLOAD_TOKEN="sk.ey...qg"
-npx expo prebuild
-```
-
-For more information about obtaining a download token, refer to the [iOS guide](https://docs.mapbox.com/ios/maps/guides/install/#configure-credentials), which explains how to configure this token under the section `Configure your secret token`.
-
 If you want to show the user's current location on the map with the [UserLocation](../docs/UserLocation.md) component, you can use the [expo-location](https://docs.expo.dev/versions/latest/sdk/location/) plugin to configure the required `NSLocationWhenInUseUsageDescription` property. Install the plugin with `npx expo install expo-location` and add its config plugin to the plugins array of your `app.{json,config.js,config.ts}`:
 
 ```json
@@ -92,16 +83,6 @@ To use V11 just set the version to a 11 version, see [the ios guide](/ios/instal
 }
 ```
 
-### Download Token Configuration
-
-For Expo projects, we recommend using the `RNMAPBOX_MAPS_DOWNLOAD_TOKEN` environment variable:
-
-```bash
-# Set the environment variable before building
-export RNMAPBOX_MAPS_DOWNLOAD_TOKEN="sk.ey...qg"
-npx expo prebuild
-```
-
 ## Manual Setup
 
 For bare workflow projects, you can follow the manual setup guides:

diff --git a/plugin/src/withMapbox.ts b/plugin/src/withMapbox.ts
@@ -37,6 +37,9 @@ export type MapboxPlugProps = {
 
   RNMapboxMapsVersion?: string;
 
+  /**
+   * @deprecated Download token is no longer required by Mapbox. Do not set this.
+   */
   RNMapboxMapsDownloadToken?: string;
 
   RNMapboxMapsUseV11?: boolean;

diff --git a/rnmapbox-maps.podspec b/rnmapbox-maps.podspec
@@ -12,7 +12,7 @@
 #           product_name: "Mapbox"
 #         }
 #         ```
-#  $RNMapboxMapsDownloadToken - *expo only* download token
+#  $RNMapboxMapsDownloadToken - *deprecated* download token is no longer required
 #  $RNMapboxMapsCustomPods - use a custom pod for mapbox libs
 
 require 'json'
-Original file line number
+Diff line change
@@ Expand Up / @@ -25,9 +25,6 @@ Add the following to your `ios/Podfile`: @@
     <br>
-    You will need to authorize your download of the Maps SDK with a secret access token with the `DOWNLOADS:READ` scope. This [guide](https://docs.mapbox.com/ios/maps/guides/install/#configure-credentials) explains how to configure the secret token under section `Configure your secret token`.
     Run `pod install` to download the proper mapbox dependency.
     ```sh
@@ Expand Down @@