📍 Addressly Documentation
🌍 Addressly — Smarter Addresses. Faster Checkouts. Fewer Delivery Issues
Addressly transforms your Shopify checkout with:
- Google-powered address autocomplete
- Interactive, live map previews
- Precise location detection
Shoppers can automatically see address suggestions as they type and click to fill their Shopify checkout address instantly.
With auto-detection of their location, Addressly ensures accurate addresses for faster, mistake-free deliveries, giving your customers a smooth and reliable checkout experience.
👋 Welcome
Welcome to Addressly, the smart address autocomplete solution designed for Shopify stores.
With Addressly, your checkout becomes faster and more reliable:
- Customers type less and select more
- Interactive maps help confirm the exact location
- Delivery errors are minimized
📋 Installation & Setup
Step 1: Enable Addressly & Add API Key
1. Open the Addressly app in your Shopify admin.
2. Navigate to Settings.
3. Toggle Addressly Status → ON.
4. Choose your Map Provider:
- OpenStreetMap (free, no API key)
- Google Maps (recommended for accuracy and autocomplete)
5. If using Google Maps, paste your API Key in the settings.
6. Click Save.
💡 Tip: For security, restrict the API key to your store domain.
Step 2: Enable App Embed for Store Map Display
1. Click Enable App Embed in Addressly.
2. The Shopify Theme Editor will open automatically.
3. Click Save in the top-right corner.
> Your store map will now appear on the storefront and in checkout (if using Shopify Plus).
Step 3: Shopify Plus — Direct Checkout Integration
For Pro Plan users on Shopify Plus, Addressly can be added directly in the checkout page:
1. Open your Shopify Checkout Editor.
2. Go to the Main Section.
3. Click Add Block → Addressly.
4. Click Save.
> Now customers can autocomplete addresses directly in checkout with Google-powered suggestions and interactive maps.
⚙️ Configuration Settings
📍 Addressly Status
Toggle the address autocomplete feature:
- ✅ Enabled → Autocomplete and map selection available
- ❌ Disabled → Feature temporarily turned off
- Autofill Without Popup → Enable this to skip the modal and auto-fill the Shopify checkout address directly.
🗺️ Map Provider Selection
| Provider | Description |
|---|---|
| 🌍 OpenStreetMap (Free) | Free address suggestions, no API key required |
| 🗺️ Google Maps (Recommended) | High-accuracy autocomplete, geocoding, and Places API support |
🔑 Google Maps & Places API Key Setup
1. Go to Google Cloud Console.
2. Create or select a project.
3. Enable the following APIs:
- Maps JavaScript API
- Geocoding API
- Places API
4. Create Credentials → API Key.
5. Paste the key in Addressly Settings → Google Maps & Places API Key.
6. Click Save.
💡 Pro Tip: Always restrict the API key to your domain for security.
🎨 Modal Customization
Make the address modal match your store branding:
| Setting | Description |
|---|---|
| Modal Title | Text displayed at the top (e.g., "Select Your Delivery Location") |
| Custom Map Marker | Upload a custom icon for the location pin |
✨ Key Features
| Feature | Description |
|---|---|
| 🔍 Smart Address Autocomplete | Real-time suggestions as customers type |
| 🗺️ Interactive Map Selection | Pinpoint exact location with a draggable map marker |
| 📍 Auto Location Detection | Detects visitor’s location automatically |
| ⚡ Seamless Checkout Integration | Works directly within Shopify checkout and cart pages |
| 📝 Autofill Without Popup | Automatically fills address fields on checkout without showing a modal |
💸 Pricing Plans
🆓 Free Plan
- OpenStreetMap autocomplete only
- Address modal customization
- App Embed integration
- Basic map display
🚀 Pro Plan _(Recommended)_
Unlock Shopify Plus checkout integration and advanced features:
- Google Maps & Places autocomplete
- Interactive map picker with custom markers
- Auto location detection
- Autofill Without Popup
- Checkout integration with Shopify Plus:
1. Open Checkout Editor
2. Add Addressly block in the Main Section
3. Click Save
- Priority support via email & WhatsApp
> Upgrade anytime from the Pricing tab inside Addressly.
🆘 Support & Help
Contact Options:
- 📧 Email: support@winsomies.com
- 💬 WhatsApp: +971 55 209 4305
- 🧾 Jira Support: Submit a ticket
Response time: within 24 hours (Mon–Fri)
🔧 Quick Troubleshooting
Address autocomplete not showing?
- ✅ Check API key is correct and unrestricted
- ✅ Ensure Addressly is enabled
- ✅ Verify Google Maps APIs are active
Map not loading?
- ✅ Confirm provider selection
- ✅ Check browser console for errors
- ✅ Ensure API key permissions
Wrong pin location?
- ✅ Verify Geocoding API is enabled
- ✅ Ensure Places API is configured
- ✅ Match regional address formats
🧩 Summary
Addressly simplifies checkout, reduces address errors, and increases delivery success.
✅ Faster Checkout
✅ Fewer Address Errors
✅ Happier Customers
✅ Multiple Map Provider Options
🌟 Ready to enhance your checkout experience?
Activate Addressly today and make address entry effortless! 🚀