Customize

Settings → Customize.

Everything about how a locator looks and behaves is set here, in an editor built like Shopify's own: the settings on the left, grouped into categories that open one at a time, and a live preview of the real locator beside them.

Two kinds, and their profiles

Customize opens on a list of what you can put on your storefront:

Store locator — anywhere: search, filters and every location you have. Product finder — on a product page: the stores near a shopper that carry the product they are looking at.

Under each is its profiles. A profile is one locator's worth of settings under a name, and a theme block points at one, so a shop can run several that look and behave differently from the same list of locations — a full-width locator on its own page, a compact finder inside a product page.

Click a profile to edit it. Its name at the top of the editor is also how you move between profiles of that kind, and the buttons beside it duplicate, rename and delete the one you are on, or make it the default — the profile a block of that kind uses when it hasn't picked one. Each kind has its own default, so a product finder never falls back to a store locator's settings.

Duplicating opens the copy, since changing the copy is the only reason to make one.

The two offer the same settings, except that a product finder has no filters panel: the product is the filter. See Product finder.

The preview

The pane beside the settings is the real locator — the same code your shoppers run — with your own locations in it. Change a setting and it updates in place.

Every setting takes effect as you change it — including the map, which redraws when you resize the locator, and the colors, which update without the map reloading.

It draws with your own map provider and key, so the map here is the map your shoppers get. One caveat: if that key is restricted to your storefront's domains — which is how it should be — the map may be refused in the admin. Everything else in the preview still works; the map area is what goes blank.

The locator also sits on a plain background here rather than inside your theme's page.

Customize only appears once a map provider is connected, since there is no map to build against before that. See Map provider.

The Desktop and Mobile buttons show how it behaves at each width. On a narrow screen the search, map and list stack.

The settings

Every setting, by the category it sits in.

Layout

Map

The map opens framed on every location, so shoppers see your whole footprint before they search.

Leaving scroll zoom off is the right default for a locator inside a long page.

Search and filters

Covered in more depth in Search & radius.

Location details

What shoppers see in the list, and when they select a location.

Pinned directions are worth knowing about: the button stays in view at the bottom of the panel while the shopper scrolls the rest of the details, which matters for locations with hours, photos and a product list.

One setting here is about the page rather than the shop: On a product page, show only stores stocking it. Where a locator using this profile sits on a product page, it narrows itself to that product; everywhere else it shows every location.

Colors

A Palette dropdown at the top fills in every color below it — Light, Dark, Sand, Forest or Ink. Change a color afterwards and the palette reads as Custom.

The colors belong to the profile, which is the whole of it: there is no separate list of palettes to keep in step, and nothing can repaint a live locator later. A second look for a second locator is a second profile.

Every color is optional. Leave one blank and the locator works it out from the others, which is why a palette that sets only a background and an accent still produces a coherent locator.

Borders and corners

The outline around the whole locator is set separately from the borders and corners of the parts inside it, so you can round your cards without rounding the locator, or frame the locator without outlining anything in it.

In full screen the locator is the screen, so it drops its outer border and corners whatever these say. The product finder is a plain list with no frame around it, so only the two inside settings appear for it.

Things with no setting

Deliberately automatic, so there is one less thing to get wrong:

• The map frames every location when the locator loads, and reframes on the current results when a shopper clears their search or deselects a location.
• A filter no location uses is never shown.
• Empty fields are left out rather than shown blank — a location with no phone number simply has no phone line.
• Autoplay and animation respect a shopper's reduced-motion setting.