Quick Guide

Use this guide to get your app up and running.

Step 1: Enable R+ Store Locator Helper

The app is working in themes where the R+ Store Locator Helper App Embed Extension has been activated.

Note: The extension must be activated separately for each theme you want to use it in. If you switch themes, remember to re-enable the embed.


To activate the extension:

  1. In your Shopify admin, go to Online Store → Themes.
  2. Find the theme you want to edit and click Customize.
  3. In the sidebar, click the App embeds icon.

  4. Find R+ Store Locator Helper in the list and toggle it on.

  5. Click Save.

Step 2: Set up the Google API key (optional)

To display a Google map in your Store Locator page, you’ll need to create a Google Maps API key and add it to your app settings. This guide walks you through the process step by step.

Once created, you’ll connect it to the Store Locator App so Google map will be displayed on your website.


You can check the full Google Maps API Key Setup Guide in this article.


  • Go to your Store Locator app, Map Provider tab

  • Paste the key into the Google Maps API Key field
  • Click Save map API Key

The app will attempt to automatically verify your key.

Step 3: Add your first location

Go to Locations page

Click Add Location to open a modal where you can enter details about your location.

Fields

Field Required Description
Name ✅ Required Enter the name of your location.
Address line 1 ✅ Required Enter the street address and building number.
Address line 2 ⬜ Optional Apartment, suite, unit, etc.
City ✅ Required Enter the city.
Country ✅ Required Select the country from the dropdown.
Latitude & Longitude ✅ Required Auto-detected when the address is entered correctly — click the Detect button. If detection fails, enter coordinates manually using the manual guide.

Shop Location

Connect Shopify native locations with your app's custom locations to display them in the Store Availability block.

How it works: By default, the Store Availability block shows only Shopify native locations, since they are directly connected to product inventory. After connecting locations, the block will display your custom location information while using stock data from the linked Shopify location. This allows customers to see accurate availability along with your custom location details.

Custom Pin

Change the appearance of location pins on the map by adding a custom pin. Enter the full image URL starting with https://    .

By default, the app uses its own map pins.

Custom Favorite Pin

Set a custom pin that will be displayed when customers add a location to their favorites, making it easier to spot on the map.

Open Hours

Display business hours for your location.


When you're done, click Save.

Step 4 : Add Store Locator block (Optional)


Before using the Store Locator functionality, you need to add the block to a page template and optionally configure its appearance.

You can read more about setting up your Store Locator in this article.


Add the Store Locator Block to a Page Template

  1. Go to Online Store → Themes, and click Customize on your active theme.

  2. Open the page selector at the top, then go to Pages and press Create template.


  3. Enter the template name (for example, Store Locator) and click Create template.

Next, create a page using this template:

  1. Go to Online Store → Pages and click Add page in the top-right corner.
  2. Enter the page name (for example, Store Locator).
  3. Set the page visibility to Visible.
  4. Choose the store-locator template you created earlier.

  5. Click Save.

Now add the Store Locator block:

  1. Go back to Online Store → Themes, and click Customize.
  2. Open the page selector and choose your Store Locator page.
  3. Click Add section and select R+ Store Locator.

  4. Click Save.

Step 5 : Add Store Availability block (Optional)

Before using the Store Availability functionality, you need to add the block to your product page and optionally configure its appearance.

You can read more about setting up your Store Locator in this article.


Add the Store Availability block to your PDP

  1. Go to Online Store → Themes, and click Customize on your active theme.
  2. Open the page selector at the top, then go to Products and choose your Product template.

  1. On the Product page, open the Main product section (for example, Product Information).
  2. Click Add block.
  3. In the modal window, open the Apps section and select R+ Store Availability.

  1. Choose the desired position of the block (above or below other blocks).
  2. Click Save to apply your changes.

Do you need help?

If you have any questions or run into issues, please contact us — we’re happy to help.

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.

Still need help? Contact Us Contact Us