Addressly Documentation

> 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.

📑 Table of Contents

👋 Welcome

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.

✅ Is Addressly right for you?

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

🎯 What you gain with Addressly

🚀 Get Started — Three Simple Steps

> 🎬 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.

Step 1 — Turn Addressly on & pick your map provider

1. In Shopify Admin, go to Apps and open Addressly.
2. Go to Settings.
3. Set Addressly to Enabled / ON.
4. Choose your map provider:

> 💡 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.

Step 2 — Enable Addressly on your storefront (App Embed)

The storefront embed is how most customers first see Addressly — on cart pages, address forms, and anywhere your theme shows address fields.

1. Inside Addressly, click Enable App Embed — this opens your Shopify theme editor automatically.
2. In the theme editor, find the Addressly toggle and turn it ON.
3. 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.

Step 3 — Add Addressly to checkout (Shopify Plus only)

> This step is only for Shopify Plus stores. If you're not on Plus, Step 2 is everything you need.

1. In Shopify Admin, go to Settings → Checkout → Customize.
2. In the checkout editor, navigate to the shipping / delivery address section.
3. Click Add block and select Addressly.
4. Place the block next to address fields so shoppers naturally connect the map with the form.
5. Click Save.

🔑 Google Maps Setup

> 🎬 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.

Step 1 — Create a Google Cloud project

1. Go to Google Cloud Console.
2. Click Select a project → New Project, give it a name (e.g. "Addressly Maps"), and click Create.
3. Make sure billing is enabled on the project — Google requires this to use Maps APIs.

Step 2 — Enable the required 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.

Step 3 — Create your API key

1. Go to APIs & Services → Credentials.
2. Click Create credentials → API key.
3. Copy the key that appears.
4. Back in Addressly → Settings, paste the key into the Google API Key field and click Save.

Step 4 — Restrict your API key (strongly recommended)

This prevents unexpected billing if your key is ever exposed.

1. In Google Cloud Console, click Edit on your API key.
2. Under Application restrictions, choose HTTP referrers (websites).
3. Add your store's domains:
- `https://your-store.com/*`
- `https://www.your-store.com/*`
- Your `*.myshopify.com` preview URL (if you test there)
4. Click Save.

> ⚠️ If address suggestions stop working after adding restrictions, double-check that your store URL is entered exactly — including `https://` and the `/*` wildcard.

⚙️ Settings Reference

All settings live in Shopify Admin → Apps → Addressly → Settings.

How country delivery limits work

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.

🛍️ What your customers experience

💎 Plans — Standard vs Pro

✨ Best Practices

- 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.

❓ Frequently Asked Questions

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.

🔧 Troubleshooting

📧 Contact Support

We aim to reply within 24 hours, Monday–Friday (excluding public holidays).

Thank you for choosing Addressly. Here's to cleaner addresses and happier customers.