Translating your Mapbox map

When you set up your Stockist account with a Mapbox key, Stockist uses imagery from Mapbox to show the map on your store locator.

Mapbox’s standard imagery will show the place labels for countries, cities, neighborhoods, and points of interest in English. If you would prefer to show the labels in a different language, this can be set up by creating a custom “style” in your Mapbox account.
Normally you’d create a custom style if you wanted to customize the colors of the map, but custom styles also allow you to change other aspects of your map like the language of the labels.

Creating a translated map

To create a translated style, you can follow the steps in our article here for creating a custom Mapbox style:

In step #4 of the linked article, you can adjust the language by changing specific layers in the map style. The exact steps vary based on how the style has been set up.

Click on a layer (e.g. Place labels or country-label) in the Layers tab to see what options appear:

Language option

If you see a Language option, you can change this to your desired language:

Repeat this process for all the following layers:

  • Place labels
  • Transit
  • Point of interest labels
  • Natural features
  • Walking, cycling, etc.
  • Road network

No "language" option

If you don't see a Language option, you can instead change the language for each layer directly. Click on a label layer, then click Text field. Click on name_en and choose your desired language from the list that appeares (e.g. name_fr for French or name_es for Spanish):

Note that some layers may have an additional step to click on before you see name_en, for example:

Next steps

Once you've adjusted the language for each layer, continue with the rest of the steps in the linked article. After publishing your style, you can follow the steps add it to Stockist.

If your Stockist plan doesn't normally support custom map styles and you just need to change the language, feel free to reach out to our support team with your style URL (from step 10 in the linked article) and we're happy to help set up your Stockist account to use your translated map style.