Transfer styles between accounts

There are two approaches to transferring styles between accounts. The first approach is a true transfer of a Mapbox style from one account to another. The second approach involves referencing a public style from another Mapbox account within your own application.

Approach 1: Download and re-upload a style

Transferring styles between accounts allows you to own a style and make changes to it from a single Mapbox account.

You can transfer Mapbox assets between accounts if you have access to the account you’re transferring from or if you’re given the necessary files. How you transfer styles from one account to another depends on whether you are using Mapbox Studio or Mapbox Studio Classic, as well as the data that’s included with your style.

Styles made with Mapbox Studio

Styles made with Mapbox Studio may be downloaded in JSON format and re-uploaded as a new style. You can find the download option in the menu next to each style within the Styles page.

animated gif of how to download a style

You can then upload the JSON file to another Mapbox account.

animated gif of how to upload a style

If you added any custom icons or fonts to your style, you’ll need to add them back to your sprite sheet manually.

Projects made with Mapbox Studio Classic

Note that Mapbox Studio Classic has been deprecated. When possible, consider moving your styles to Mapbox Studio instead.

Mapbox Studio Classic styles (CartoCSS in .tm2 files) are converted to code on Mapbox servers, so it’s assumed you already have the styles on your local machine. You can re-upload these to your new account if they reference sources available as a tileset in your account. GeoJSON or KMLs can be downloaded and re-uploaded to your new account as a tileset and imported to a new Mapbox Studio or Mapbox Studio Classic project.

Approach 2: Reference a public style

By referencing public styles, you can use Mapbox styles created on other Mapbox accounts in your own application. This approach can be particularly useful if your organization has multiple Mapbox accounts each with their own custom styles, fonts, and sprites.

In this scenario, you have a style from Account A and you’d like Account B to use that style in an application.

Mapbox styles are set to Private by default. Navigate to your styles page and open the style you want to share. Select Make public.

animated gif of how to set a style to public

Once the style is set to Public, you can reference the style within any application by copying the Style URL within the Styles page.

animated gif of how to set a style to public

Special note: A Public URL can be referenced by any application using any access token.

Here’s a quick example of how this might look using our GL JS library:

mapboxgl.accessToken = '<ACCESS TOKEN FROM ACCOUNT B>';
var map = new mapboxgl.Map({
  container: 'map', // container id
  style: '<PUBLIC STYLE URL FROM ACCOUNT A>', // stylesheet location
  center: [-74.50, 40], // starting position [lng, lat]
  zoom: 9 // starting zoom
});