Addressly — Merchant Documentation

> Smarter addresses. Faster checkouts. Fewer delivery mistakes.

Welcome to Addressly for Shopify. This guide walks you through setup, settings, and everyday use—step by step—so you can get value quickly and support your customers with confidence.

📑 Table of contents

👋 Welcome

Addressly helps customers enter correct shipping addresses with less typing and fewer errors. They get live suggestions, an optional map to confirm the drop-off point, and—if you turn it on—delivery rules so only the countries you serve can complete an address.

You manage everything from Shopify Admin → Apps → Addressly. No coding required.

✅ Is Addressly right for you?

Addressly is a strong fit if you:

- Ship physical products and care about delivery accuracy
- 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 experience inside checkout

🎯 What you gain with Addressly

🚀 Get started: three simple steps

Follow these in order. You can pause between steps—Addressly will remember your settings when you return.

Step 1️⃣ — Turn Addressly on & pick your map

1. In Shopify admin, go to Apps and open Addressly.
2. Open Settings (or the main setup area shown in the app).
3. Set Addressly to Enabled / ON.
4. Choose your map provider:
- 🗺️ OpenStreetMap — No API key; good for testing and simple use.
- 📌 Google Maps — Best suggestions and accuracy; requires a Google API key (detailed steps below).
5. If you use Google, paste your API key in the field provided.
6. Click Save.

💡 Security tip: In Google Cloud, restrict your key to your store’s domain so it cannot be reused elsewhere.

Step 2️⃣ — Show Addressly on your storefront (app embed)

The storefront is where most customers first see Addressly (cart, address forms, or theme areas that use the embed—exact placement depends on your theme).

1. In Addressly, use Enable App Embed (or the button/link that opens your theme).
2. Shopify’s theme editor opens.
3. Find the Addressly app embed and turn it ON.
4. Click Save in the theme editor.

✅ Done? Visit your live store (or preview) and try typing an address where Addressly appears. You should see suggestions and/or the map flow after theme changes propagate.

Step 3️⃣ — Shopify Plus: add Addressly to checkout (optional)

This step is only for Shopify Plus stores that customize checkout.

1. In admin, open Checkout customization (often Settings → Checkout → Customize).
2. In the checkout editor, open the section where the shipping / delivery address appears.
3. Click Add block (or equivalent) and choose Addressly.
4. Position the block where it makes sense next to address fields.
5. Save the checkout.

📝 Note: If you are not on Plus, Step 2 is enough—Addressly still improves addresses on your theme.

⚙️ Settings in depth

Use this table as a reference whenever you change options in Addressly → Settings.

When limit delivery to selected countries is enabled:

- Customers can still search, use map / GPS-style help (where your plan allows), and explore the map.
- If the chosen country is not in your list, Addressly blocks that address and shows messaging such as delivery not being available in that country—so you set expectations early.

🔑 Google Maps: detailed setup

Use this section when you select Google Maps as your provider.

1. Google Cloud project

1. Go to Google Cloud Console.
2. Create a new project or select an existing one.
3. Make sure billing is enabled on the project (Google’s requirement for Maps).

2. Enable the APIs

Search for and enable these (names may match closely in the console):

- Maps JavaScript API
- Places API
- Geocoding API

3. Create an API key

1. Open APIs & Services → Credentials.
2. Create credentials → API key.
3. Copy the key and paste it into Addressly → Settings.
4. Click Save in Addressly.

4. Restrict the key (recommended)

1. Edit the key in Google Cloud.
2. Under Application restrictions, choose HTTP referrers (websites).
3. Add your store domains, for example:
- `https://your-store.com/*`
- `https://www.your-store.com/*`
- Your myshopify.com preview URLs if you test there

This helps prevent abuse if the key is ever exposed.

🛍️ What your customers experience

💎 Plans: Free vs Pro

Features can differ by plan (Google-powered features, checkout on Plus, country rules, autofill options, priority support, etc.).

📌 Source of truth: Always check the Shopify App Store listing for Addressly and the Plans / billing area inside the Addressly app. Those screens show current limits and prices.

✨ Best practices

- Start with OpenStreetMap if you want zero Google setup; switch to Google when you are ready for production-grade suggestions.
- After enabling the app embed, preview your theme on mobile and desktop—most address mistakes are caught on phones.
- When using country limits, list every country you actually ship to; double-check spellings and ISO-style codes (e.g. US, GB, AE) as shown in Addressly.
- Restrict your Google API key before heavy traffic—unexpected usage can affect billing.
- For Plus checkout, place the Addressly block next to address fields so shoppers naturally connect map + fields.

❓ Frequently asked questions

Do I need Google Maps?
No. OpenStreetMap works without a key. Google is optional when you want maximum accuracy and familiar suggestions.

Does Addressly work without Shopify Plus?
Yes. The theme app embed (Step 2) works on standard Shopify plans. The checkout block is the Plus-specific part.

Will Addressly change my theme code?
You enable an app embed through the theme editor—no manual code editing is described in this guide.

Can I turn Addressly off quickly?
Yes. Set Addressly to off in Settings; you can re-enable anytime.

Where do I see what my plan includes?
In the App Store listing and inside Addressly under billing or plan details.

🔧 Troubleshooting

📧 Contact support

We are here to help you succeed with Addressly.

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