Creating a custom map style for Mapbox

If your Stockist account is using Mapbox as your map provider and you’d like to customize the styling of your map beyond the built-in options, it’s possible to create a completely custom style in your Mapbox account.

Custom map styles are currently supported on the Plus plan and above.

Templates

You can base your custom style off of any of the templates below:

Monochrome

Choose a single theme color to control the overall look of the map. This is the quickest starting point to create a map that uses your brand color.

Start from this style


Streets

Mapbox's basic streetmap style.

Start from this style

If you don't need to customize this style, you can select it directly in Stockist.


Outdoors

An outdoors-focused style with more prominent topography and hiking trails.

Start from this style

If you don't need to customize this style, you can select it directly in Stockist.


Light

A light basemap theme that helps store pins stand out.

Start from this style

If you don't need to customize this style, you can select it directly in Stockist.


Dark

A dark basemap theme that helps store pins stand out.

Start from this style

If you don't need to customize this style, you can select it directly in Stockist.

Creating a custom style

To create custom style in your Mapbox account, follow the steps below:

  1. Choose one of the templates above as a starting point
  2. Click Start from this style under your chosen template

  3. Click Copy in the bottom-right corner to copy the style into your Mapbox account where it can be edited

  4. In the editor that opens, click on a layer in the Layers tab to change the individual components of the map. For example, to edit the primary map color in the Monochrome template, you can click on Land & water, click on the Base color, and then edit the color in the selector there:

    You can customize the colors, text, and language for each individual component.

  5. Once your map looks how you’d like, click the Publish button in the top right corner:

  6. Confirm that you want to publish your changes:

  7. You should see a confirmation popup, which you can dismiss:

  8. Click the Share button in the top right corner:

  9. Copy the Style URL using the clipboard icon:

  10. In the Stockist dashboard, open Settings > Appearance. Under Map theme, choose Custom, then paste the complete Style URL into the Custom Mapbox style field:

  11. Save the page to update your map

Once the custom style has been linked to your Stockist account, you can make further changes directly in Mapbox studio and your store locator map will update with the new style automatically.


To edit your style in the future:

  1. Open your Mapbox account and sign in if prompted

  2. Click Style editor or open https://console.mapbox.com/studio/

  3. Click on the style to open the style editor
  4. Future edits appear on your Stockist map automatically one you click Publish — the Style URL doesn't change and you don't need to paste it in Stockist again.