Smarter addresses. Faster checkouts. Fewer delivery mistakes.
Welcome to Addressly for Shopify. This guide walks you through every step of setup, configuration, and troubleshooting β clearly and quickly, with video walkthroughs where it matters most.
| Section | What you'll find |
|---|---|
| Welcome | How Addressly fits your store |
| Benefits | Why merchants use Addressly |
| Get started β 3 steps | Full setup walkthrough with video |
| Google Maps setup | API key walkthrough with video |
| Settings reference | Every option explained |
| What shoppers see | Storefront & checkout behavior |
| Plans | Standard vs Pro at a glance |
| Best practices | Tips for a smooth rollout |
| FAQ | Common questions answered |
| Troubleshooting | When something goes wrong |
| Contact support | How to reach us |
Addressly helps your customers enter correct shipping addresses with less typing and fewer errors. As they type, they see live suggestions, an optional map to confirm the exact drop-off point, and β if you turn it on β country delivery rules so only the regions you ship to can complete checkout.
You control everything from Shopify Admin β Apps β Addressly. No coding required.
Addressly is a great fit if you:
- Ship physical products and want fewer failed deliveries
- Want faster checkout and fewer "wrong address" support tickets
- Sell in specific countries only and need clear messaging when a region isn't served
- Use Shopify Plus and want the same address experience inside checkout
| Benefit | What it means for you |
|---|---|
| β‘ Faster checkout | Customers pick from suggestions instead of typing every field. |
| π Fewer bad addresses | Map confirmation catches "close but wrong" pins and typos. |
| π Delivery control | Allow only the countries you actually ship to. |
| π Plus-ready | Optional checkout block for Shopify Plus merchants. |
| π§© Flexible maps | Start free with OpenStreetMap or upgrade accuracy with Google Maps. |
π¬ Prefer watching over reading? βΆ Watch the full setup walkthrough on YouTube β it takes under 5 minutes.
Follow these steps in order. You can pause between them β Addressly saves your progress.
- In Shopify Admin, go to Apps and open Addressly.
- Go to Settings.
- Set Addressly to Enabled / ON.
- Choose your map provider:
| Provider | Best for | API key needed? |
|---|---|---|
| πΊοΈ OpenStreetMap | Getting started, zero cost | β No |
| π Google Maps | Production accuracy, familiar suggestions | β Yes |
- If you choose Google Maps, paste your API key in the field provided. (Full instructions in the Google Maps setup section below.)
- Click Save.
π‘ Security tip: Restrict your Google API key to your store's domain so it can't be misused elsewhere. See Step 4 of the Google Maps setup for how.
The storefront embed is how most customers first see Addressly β on cart pages, address forms, and anywhere your theme shows address fields.
- Inside Addressly, click Enable App Embed β this opens your Shopify theme editor automatically.
- In the theme editor, find the Addressly toggle and turn it ON.
- Click Save in the theme editor.
β Test it: Visit your live store (or use the preview), type an address, and confirm you see suggestions and the map appear.
π± Tip: Always check on mobile too β most address mistakes happen on phones.
This step is only for Shopify Plus stores. If you're not on Plus, Step 2 is everything you need.
- In Shopify Admin, go to Settings β Checkout β Customize.
- In the checkout editor, navigate to the shipping / delivery address section.
- Click Add block and select Addressly.
- Place the block next to address fields so shoppers naturally connect the map with the form.
- Click Save.
π¬ Prefer watching? βΆ Watch the Google Maps API setup on YouTube
You'll need a Google Cloud account with billing enabled. Follow the four steps below.
- Go to Google Cloud Console.
- Click Select a project β New Project, give it a name (e.g. "Addressly Maps"), and click Create.
- Make sure billing is enabled on the project β Google requires this to use Maps APIs.
In the search bar, search for and Enable each of these three:
- β Maps JavaScript API
- β Places API
- β Geocoding API
All three are required. Missing even one will cause suggestions or the map to stop working.
- Go to APIs & Services β Credentials.
- Click Create credentials β API key.
- Copy the key that appears.
- Back in Addressly β Settings, paste the key into the Google API Key field and click Save.
This prevents unexpected billing if your key is ever exposed.
- In Google Cloud Console, click Edit on your API key.
- Under Application restrictions, choose HTTP referrers (websites).
- Add your store's domains:
https://your-store.com/*https://www.your-store.com/*- Your
*.myshopify.compreview URL (if you test there)
- Click Save.
β οΈ If address suggestions stop working after adding restrictions, double-check that your store URL is entered exactly β includinghttps://and the/*wildcard.
All settings live in Shopify Admin β Apps β Addressly β Settings.
| Setting | What it does | When to use it |
|---|---|---|
| π Addressly status | Master on/off switch for all customer-facing features. | Turn off during theme maintenance; turn on for live selling. |
| πͺ Autofill without popup (Pro) | Fills address data with less or no map popup. | Great for customers who want a faster, minimal flow. |
| π Country delivery limit (Pro) | Restricts checkout to your allowed countries only. | Use when you ship to specific regions and want clear early messaging for everyone else. |
| πΊοΈ Map provider | OpenStreetMap (free) or Google Maps (API key required). | Google for production accuracy; OpenStreetMap to get started at no cost. |
| βοΈ Modal title | Text shown at the top of the location picker. Max 60 characters. | Personalise it β e.g. "Choose your delivery point". |
| π Custom marker | Upload a branded map pin image. | Match your store's look and feel on the map. |
When you enable limit delivery to selected countries:
- Customers can still search addresses and explore the map freely.
- If they pick a country not on your list, Addressly blocks the address and shows a clear "delivery not available in your country" message β before they reach payment, not after.
This sets expectations early and reduces support tickets from customers in unsupported regions.
| Experience | Detail |
|---|---|
| π Autocomplete | Suggestions appear as they type a street, city, or area name. |
| πΊοΈ Interactive map | Customers can move or tap the map to fine-tune their exact pin. |
| π± Location help | Where supported, a general area starting point speeds up the process. |
| π« Country rules | Customers in unsupported regions see a friendly, clear message instead of a confusing error at payment. |
The result: less friction, clearer addresses, and fewer failed deliveries for your store.
| Feature | Standard (Free) | Pro |
|---|---|---|
| OpenStreetMap autocomplete | β | β |
| Storefront app embed | β | β |
| Shopify Plus checkout block | β | β |
| Google Maps integration | β | β |
| Autofill without popup | β | β |
| Country delivery limits | β | β |
| Priority support | β | β |
π For the latest pricing and full feature breakdown, check the Shopify App Store listing or open Plans / Billing inside the Addressly app β those are always up to date.
- Start with OpenStreetMap β zero setup, great for testing. Switch to Google Maps when you go live and want production-grade suggestions.
- Preview on both mobile and desktop after enabling the app embed. Most address problems happen on phones.
- List every country you ship to when using country restrictions, and double-check the ISO codes (e.g.
US,GB,AE) exactly as shown in Addressly. - Restrict your Google API key before you start receiving real traffic β unexpected usage can spike your billing.
- For Plus checkout, place the Addressly block directly next to address fields so shoppers naturally connect the map with what they're filling in.
- Keep your modal title under 60 characters β it's capped at that limit.
Do I need Google Maps to use Addressly? No. OpenStreetMap works out of the box with no API key or setup. Google Maps is optional β use it when you want maximum accuracy and more familiar-feeling suggestions.
Does Addressly work without Shopify Plus? Yes. The storefront app embed (Step 2) works on all Shopify plans. The checkout block is the only Plus-specific feature.
Will Addressly change my theme code? No. You enable it through the Shopify theme editor as an app embed β no manual code editing required.
Can I quickly turn Addressly off? Yes. Toggle Addressly status to OFF in Settings at any time. All your settings are saved and you can re-enable whenever you're ready.
Where do I see what my plan includes? Inside Addressly under Plans / Billing, or on the Shopify App Store listing.
What happens if a customer is in a country I don't ship to? They'll see a clear "delivery not available in this country" message when they try to use that address β before they ever reach payment.
| Symptom | What to try |
|---|---|
| π« No address suggestions showing | Check Addressly is ON in Settings. For Google Maps, confirm the API key is saved and all three APIs (Maps JavaScript, Places, Geocoding) are enabled in Google Cloud. |
| πΊοΈ Map is blank or loading forever | Check your map provider setting matches what you configured. For Google Maps, verify billing is enabled in Google Cloud and your referrer restriction includes your exact store URL with https:// and /*. |
| π Wrong country blocked or allowed | Open country restriction settings and confirm the toggle is on and the country list matches your actual shipping policy. |
| π§© Nothing appearing in checkout | Confirm you're on Shopify Plus and have added the Addressly block in the checkout editor and saved it. |
| π "Test API Key" shows failure | Check all three Google APIs are enabled and that referrer restrictions aren't too strict for your current test environment. |
If none of these solve your issue, reach out to support with your store URL, map provider, and a short screen recording if you can β it helps us diagnose and fix things much faster.
We aim to reply within 24 hours, MondayβFriday (excluding public holidays).
| Channel | Details |
|---|---|
| βοΈ Email | support@winsomies.com |
| π¬ WhatsApp | +971 55 209 4305 |
| π« Support portal | Winsomies Service Desk |
When you reach out, please share:
- Your store URL
- Your map provider (OpenStreetMap or Google Maps)
- Your current plan (Standard or Pro)
- A screen recording if possible β it saves a lot of back-and-forth
Thank you for choosing Addressly. Here's to cleaner addresses and happier customers.