Choose a map style (predefined vs custom style JSON)

What this article helps you do

Choose how your store locator map looks by using one of Mapstore’s predefined styles or by pasting a custom MapLibre style URL into the map block settings.

Before you start

• Mapstore is installed and the map block is on a page
• You have access to the Shopify theme editor

Step-by-step instructions

1. Open map style settings

• In the Shopify theme editor, select the page with the Mapstore map block.
• Click the Mapstore Map block.
• In the block settings, find the predefined style selector and the Custom style URL field.

2. Pick a predefined style

• Mapstore offers built-in map styles such as Default, Toner, Versatiles, AWS Standard, Positron, Bright, and Liberty.
• Choose one from the dropdown or list.
• Save the theme - the map updates on the storefront.

3. Use a custom style JSON (optional)

• Build or edit your style JSON in a tool such as Maputnik.
• Export the finished style JSON file.
• Upload that file to Shopify so it has a public file URL.
• Paste that URL into the Custom style URL field in the Mapstore map block.
• Save the theme. When this field is filled, it overrides the predefined style selection.

4. Adjust other visual options

• You can combine map style with colors, marker settings, and other style options in the same settings panel.

How to verify it worked

1. Save the theme and open your store locator on the storefront.
2. Confirm the map uses the style you selected (e.g. light or dark background).
3. If using custom JSON, confirm the map reflects your style (colors, roads, labels, etc.).

Common issues and fixes

Related articles

• Changing map styling and storefront text
• Customize style settings (colors, typography, spacing, button states)
• Configure Google API key and required APIs
• Add Mapstore blocks to your theme