Getting Started

1. Install from the Shopify App Store

   Open Wayfinder on the Shopify App Store and click Install. You’ll land on the Wayfinder home page inside your Shopify admin.

2. Start your free trial

   Open Pricing Plans and start the 7-day free trial of the Basic plan. The storefront map only appears once a plan is active, so do this before testing on your store.

Inside the app you’ll find these pages in the sidebar:

Wayfinder shows customers a map through a theme app block. Put it on your cart page to get one location per order, or on your product page to get one location per product.

1. Open the theme editor

   In Shopify admin, go to Online Store → Themes and click Customize on your live theme.

2. Go to your cart (or product) template

   Use the page selector at the top of the editor to switch templates.

3. Add the block

   Click Add block, open the Apps tab and choose Wayfinder → Map. Drag it where you want it, usually just above the checkout button.

4. Save

   Click Save, then preview your store to see the map.

Back in the Wayfinder app, open Map Settings.

Choose a map provider

• Wayfinder Mapis free and needs no API key. It’s the easiest way to start.
• Google Maps needs your own Google Cloud API key with the Maps JavaScript, Places and Geocoding APIs enabled. See how to create one.

Choose how coordinates are attached

Pick one set of coordinates per order if the block is on your cart page, or per productif it’s on your product pages. This should match where you placed the block in step 2.

Optional settings

• Make location selection mandatory: customers must confirm a location before they can check out.
• Make requested delivery/pickup date mandatory: used together with the date picker block setting.
• Use customer browser location as default location: centers the map on the customer if they allow location access.
• Restrict address search to your store’s country: keeps search results local.
• Coordinate format: Decimal Degrees (e.g. 40.7128, -74.0060) or DMS.

You can also rewrite every customer-facing label, including the headline, instructions, button text, and the message shown when a location is outside your delivery area.

Skip this section if you’re using the free Wayfinder Map. To use Google Maps instead, create an API key in Google Cloud and paste it into Wayfinder. It takes about 10 minutes.

Create the key

1. Create a Google Cloud project

   Go to the Google Cloud Console and sign in. Click the project picker at the top, then New Project. Name it (e.g. “My Store Maps”) and click Create.

2. Turn on billing

   Open Billingfrom the menu and link a billing account to the project. Without it, the map shows a “For development purposes only” watermark and search won’t work.

3. Enable the three APIs

   Go to APIs & Services → Library. Search for each of these and click Enable:

   • Maps JavaScript API: draws the map.
   • Places API: powers the address search box.
   • Geocoding API: turns addresses into coordinates and back.

4. Create the API key

   Go to APIs & Services → Credentials, click Create credentials → API key, and copy the key it shows you. It starts with AIza.

Restrict the key

The key is visible in your storefront’s page source, as with every Google Maps site. Restrictions make sure only your store can use it, so nobody else can run up your bill.

1. Limit which APIs it can use

   On the Credentials page, click the key’s name. Under API restrictions, choose Restrict key and tick only Maps JavaScript API, Places API, and Geocoding API.

2. Limit which websites can use it

   Under Application restrictions, choose Websites and add each address your store uses:

   https://yourstore.com/*

   https://*.yourstore.com/*

   https://your-store.myshopify.com/*

   Replace these with your own domain and your .myshopify.com address, found under Settings → Domains. Click Save. Changes can take a few minutes to apply.

3. Set a budget alert

   In Billing → Budgets & alerts, create a small monthly budget (e.g. $10) so Google emails you if usage ever climbs.

Add the key to Wayfinder

1. Paste it into Map Settings

   In Wayfinder, open Map Settings, select Google Maps, paste the key into Insert your Google Cloud API Key here, and click Save.

2. Test it on your store

   Open your cart or product page. The Google map should load, and typing in the search box should suggest addresses.

Troubleshooting

Still stuck? Contact us and we’ll help you get it working.

When a customer confirms a location, Wayfinder saves it on the order. Open any order in Shopify admin and look under Additional details:

Drivers can tap Link to Map to navigate straight to the pin, even if the street address is vague or new.

On Shopify plans that support checkout extensions, you can also add the Checkout Location Picker block in the checkout editor (Settings → Checkout → Customize). Customers drop a pin during checkout, and their shipping address is filled in for them.