Skip to main content

Installing StoreRocket on Shopify

How to add StoreRocket's store locator to your Shopify store, including setup, billing, and troubleshooting.

Updated yesterday

StoreRocket works great with Shopify. You can install it through the Shopify App Store or add the embed code manually. This guide covers both methods and the most common questions.

Method 1: Install via the Shopify App Store

  1. Click Add app and follow the prompts

  2. Once installed, you'll be redirected to StoreRocket to set up your store locator

The app automatically connects your Shopify store to StoreRocket. You can manage everything from the StoreRocket dashboard.

Method 2: Manual embed (for more control)

If you prefer to add the store locator to a specific page:

  1. Go to your Widget Install page in StoreRocket

  2. Copy the embed code

  3. In Shopify, go to Online Store > Pages

  4. Create a new page (or edit an existing one) for your store locator

  5. Click the <> (Show HTML) button in the page editor

  6. Paste the embed code

  7. Save

Your store locator will appear on that page.

Setting up the map

After installing, you'll need a map provider. You have two options:

  • Google Maps: Requires a Google Maps API key. More features, but requires a Google Cloud account.

  • Mapbox: Free up to 50,000 loads/month, no credit card needed. Great for getting started fast.

Set your map provider in your Map Provider settings.

Google Maps API key on Shopify

If you're using Google Maps, you need to add your Shopify domain to the API key's allowed referrers. In the Google Cloud Console, add these referrers to your API key:

  • *yourstore.myshopify.com/*

  • *yourcustomdomain.com/* (if you have a custom domain)

  • *storerocket.io/*

  • *.storerocket.io/*

  • *admin.shopify.com/* (for the Shopify admin preview)

Important: Billing on Shopify

Here's something that catches people off guard: uninstalling the StoreRocket app from Shopify does NOT cancel your subscription.

StoreRocket subscriptions are managed separately from Shopify app billing. If you want to cancel, you need to do ONE of these:

  1. Cancel through StoreRocket's Billing page > Manage Subscription

  2. Cancel through Shopify admin: go to Settings > Apps and sales channels > StoreRocket > Cancel subscription

Just removing the app from your Shopify store doesn't stop the billing. Please double check if you're uninstalling.

Adding the floating button on Shopify

The floating button is a small map pin icon that sits in the corner of your site. When visitors click it, the store locator pops up.

  1. Go to your Floating Button Install page in StoreRocket

  2. Copy the embed code

  3. In Shopify, go to Online Store > Themes

  4. Click Customize on your active theme

  5. Look for App embeds or use the theme editor to add a custom HTML section

  6. Paste the floating button code

  7. Save

The floating button requires a Pro or Business plan.

Troubleshooting

Widget not loading on my Shopify store

Check these in order:

  1. Is the embed code on the page? Go to the page in Shopify, click <> to view HTML, and confirm the StoreRocket script is there

  2. Is your map provider set up? Check your Map Provider settings

  3. Is your subscription active? Check your Billing page

  4. Using Google Maps? Make sure your API key referrers include your Shopify domain (see above)

Widget shows "Account inactive" or "Upgrade required"

Your subscription has expired or wasn't set up. Go to your Billing page to subscribe or reactivate.

Linked to the wrong StoreRocket account

If the Shopify app connected to an old or wrong StoreRocket project, contact us on live chat and we'll help you relink to the correct account.

Widget too narrow or not full width

The widget takes the width of its parent container. If your Shopify page layout is narrow, the widget will be narrow too. You can adjust this by:

  1. Using a full-width page template in your Shopify theme

  2. Adding custom CSS in your theme to make the container wider

Questions about Shopify? Hit us up on live chat.

Did this answer your question?