RP Promap lets you pass a language and locale through the store locator page URL by adding the lang parameter. This is useful when you want the map interface and geographic labels to follow a particular country or language convention.

For example, the following URL requests Canadian English:

The first part of the value identifies the language, and the second part identifies the country or locale:

A map's labels can vary based on the selected language and country locale. Country-specific names, regional naming conventions, map controls, and certain geographic labels may therefore appear differently when the locale changes.

For example, a map opened with ?lang=en-CA can use Canadian English labeling around Lake Ontario, while a different locale can produce different country-specific labels or naming conventions, such as “Lake America,” when that label is available in Google's map data.

The following RP Promap examples show the same general Toronto and Lake Ontario area using different locale settings.

Example using Canadian English, such as ?lang=en-CA. The map displays the label “Lake Ontario.”

Example using a different locale. In this map presentation, Google displays the label “Lake America.”

Important: RP Promap passes the requested locale to Google Maps, but Google controls the final basemap content. The exact label shown can depend on Google's available map data, the map's zoom level, and the selected locale. A particular label is therefore not guaranteed to appear at every zoom level.

Add ?lang= followed by the desired language-locale code to the end of your store locator URL:

If the URL already contains another parameter, add the language using &lang= instead:

You can use different links for different markets or languages:

The simplest and most reliable option is to update every store navigation link, button, and promotional link so it points directly to the URL containing the locale:

This makes Canadian English the default whenever shoppers use those links, without changing the underlying page or creating a redirect.

Do not add ?lang=en-CA to the page's URL handle or use Shopify's native URL Redirect tool for this purpose. Shopify can normalize a URL containing a query string and turn:

into:

The normalized address no longer passes the lang parameter to RP Promap.

If clicking the menu immediately produces the hyphenated address, delete the existing menu item and recreate it using the complete pasted URL.

The screenshot below shows ?lang=en-CA entered in the page's URL handle with Create a URL redirect enabled. Do not use this configuration because Shopify may rewrite the query string as part of the page handle.

Incorrect example: adding ?lang=en-CA to the page URL handle and enabling Shopify's automatic redirect can produce a hyphenated URL instead of a working query string.

If visitors can reach the store locator from links you cannot update, add the following script to theme.liquid immediately before </body>:

Change locatorPath if your Store Locator page uses a different path. The script adds Canadian English only when the URL does not already contain a lang value, so links such as ?lang=fr-CA remain unchanged.

Shopify documents that redirects involving query strings might not work as expected. For that reason, use a direct menu link whenever possible and use the conditional theme script only when automatic forwarding is required. See Shopify's URL redirect documentation.

The locale requests the appropriate language and regional map presentation, but individual labels remain controlled by Google. Try changing the zoom level and confirm that the correct locale is present in the page URL.

If the map does not use the requested language or locale, send Rose Perl Technology Support the store locator URL, the locale code being tested, and a screenshot of the displayed map.