📍 Addressly Documentation
Addressly simplifies your checkout experience by adding Google-powered address autocomplete, interactive maps, and precise location detection.
Reduce failed deliveries and checkout friction by helping customers quickly find and confirm their delivery location. Addressly integrates seamlessly with both Shopify and WordPress/WooCommerce platforms.
🚀 Quick Start
Choose your platform to jump to the relevant setup guide:
- 🛍️ Shopify Setup Guide
- 🌐 WordPress/WooCommerce Setup Guide
🛍️ Shopify Setup
👋 Welcome
Hello and welcome to Addressly — the easiest way to add smart address autocomplete to your Shopify checkout!
Simplify checkout with smart address autocomplete powered by Google Maps and OpenStreetMap.
📋 Installation Steps
Step 1: Enable Addressly & Add API Key
Enable Addressly and configure your map provider to unlock address autocomplete functionality.
To enable:
1. Open the Addressly app in your Shopify admin
2. Go to the Settings page
3. Turn Addressly Status → ON
4. Select your Map Provider (OpenStreetMap or Google Maps)
5. If using Google Maps, enter your Google Maps & Places API Key
6. Click Save
Step 2: Enable App Embed for Store Map Display
To show the map on your storefront:
1. Click the "Enable App Embed" button in the Addressly app
2. This will automatically activate the Addressly App Embed and open your Shopify Theme Editor
3. Click "Save" in the top right corner to apply the changes
⚙️ Configuration Settings
📍 Addressly Status
Enable or disable the address autocomplete feature on your checkout page.
Option:
- ✅ Enabled → Customers can search for addresses via autocomplete and view their location on a map
- ❌ Disabled → Feature is turned off (useful for testing or maintenance)
🗺️ Map Provider Selection
Choose your preferred map service:
| Provider | Description |
|---|---|
| 🌍 OpenStreetMap (Free) | Great for stores that want free, API-key-free address suggestions |
| 🗺️ Google Maps (Recommended) | Offers high-accuracy autocomplete and geocoding features |
- Select your map provider in the Map Provider dropdown
- If using Google Maps, you'll need to provide an API key (see below)
🔑 Google Maps & Places API Key Setup
Configure your API key for Google Maps integration:
1. Go to Google Cloud Console
2. Create or select a project
3. Enable these APIs:
- Maps JavaScript API
- Places API
4. Create Credentials → API Key
5. Copy your API key and paste it in Addressly settings under Google Maps & Places API Key
6. Click Save
💡 Security Tip: Restrict your API key to your domain for better security.
🎨 Modal Customization
Make the address selection modal match your store branding.
| Setting | Description |
|---|---|
| Modal Title | The title displayed at the top of the modal (e.g., "Select Your Delivery Location") |
| Custom Map Marker | Upload a custom icon for your store's location pin |
✨ Key Features
| Feature | Description |
|---|---|
| 🔍 Smart Address Autocomplete | Get real-time Google-powered address suggestions as customers type |
| 🗺️ Interactive Map Selection | Let users pinpoint their exact location with a draggable map marker |
| 📍 Auto Location Detection | Automatically detect a visitor's location for quick address entry |
| ⚡ Seamless Checkout Integration | Works directly within Shopify Checkout and cart pages |
💸 Pricing Plans
🆓 Free Plan
Ideal for small stores or testing Addressly.
- Smart Address Autocomplete (OpenStreetMap only)
- Address modal customization
- App Embed integration
- Basic map display
🚀 Pro Plan (Recommended)
Unlock the full power of Addressly.
- Google Maps & Places Autocomplete
- Interactive map picker with custom markers
- Auto location detection
- Checkout integration with precise address fields
- Priority support via email & WhatsApp
💳 Upgrade anytime from the Pricing tab inside your Addressly app.
🌐 WordPress/WooCommerce Setup
📦 Installation Guide
Follow these steps to install and activate the Addressly: Advance Address Autocomplete plugin.
Step 1: Download the Plugin
1. Download the plugin `.zip` file from your Addressly account
Step 2: Log in to WordPress Admin
1. Go to your dashboard → `yourdomain.com/wp-admin`
Step 3: Install the Plugin
1. Navigate to Plugins → Add New
2. Click Upload Plugin at the top
3. Choose your downloaded `.zip` file and click Install Now
Step 4: Activate the Plugin
Once installed, click Activate Plugin to enable it on your WordPress site.
⚙️ Plugin Configuration
Step 1: Access Settings
Go to → WooCommerce → Settings → Advance Address Autocomplete
Step 2: Add Google API Key
1. Enter your Google Maps / Places API Key in the API key field
2. Click Save Changes
Step 3: Enable Features
- ✅ Enable Address Autocomplete
- ✅ Enable Map Display (to show an interactive map in checkout)
💡 Tip: If you only want autocomplete without the map, you can disable the map checkbox.
🌍 Map Provider Options
Choose between two map providers depending on your preference and cost requirements:
| Provider | Type | Description |
|---|---|---|
| 🗺️ Leaflet (Default) | Open-source | Free, lightweight, and customizable. Ideal for budget-friendly setup |
| 🌐 Google Maps | Premium | Offers detailed maps, satellite view, and advanced features. May incur usage charges |
🧭 Core Features
🔍 Address Autocomplete
Powered by Google Places API (and optional Google Maps JavaScript API), Addressly provides live suggestions as users type their address.
📍 Autofill & Browser Geolocation
- Automatically fills address fields with the user's current location
- Centers the map view based on browser-based GPS data
🗺️ Map Zoom & Control
Easily adjust zoom levels for precise address pinpointing.
🎨 Custom Map Marker
Personalize map markers to match your store branding or delivery icon.
🔑 Getting Started with Google API Key
Step-by-Step Guide
1. Go to Google Cloud Console
2. In the Projects dropdown, create or select a project
3. Enter your project name and click Create
4. Open the newly created project
5. Navigate to API & Services → Credentials
6. Click Create Credentials → API Key
7. Copy your API key
8. In API & Services → Library, search and enable the following APIs:
- ✅ Places API
- ✅ Maps JavaScript API (optional)
9. Paste the API key into Addressly's settings in WordPress and Save Changes
💡 Security Tip: Restrict your API key to your domain for better protection.
💸 Cost Overview
| Type | Description |
|---|---|
| 🆓 Leaflet Map | 100% free and open-source |
| 💲 Google Places API | May incur minimal charges depending on API usage |
🆘 Support & Help
💬 Contact Options
Need help with Addressly? Our team is here to assist! 🤝
- 📧 Email: support@winsomies.com
- 💬 WhatsApp: +92 339 0083674
- 🧾 Jira Support: Submit a support ticket
Typical response time: within 24 hours, Monday–Friday
🔧 Quick Troubleshooting
Address autocomplete not showing?
- ✅ Check that your API key is correctly entered
- ✅ Verify API key restrictions allow your domain
- ✅ Ensure the plugin/app is enabled
- ✅ Confirm required APIs are enabled in Google Cloud Console
Map not loading?
- ✅ Verify your provider selection (Google vs OpenStreetMap/Leaflet)
- ✅ Check browser console for JavaScript errors
- ✅ Ensure API key has necessary permissions
Wrong pin location?
- ✅ Ensure geocoding is enabled in your Google project
- ✅ Check that Places API is properly configured
- ✅ Verify address format matches expected regional format
🧩 Summary
Addressly is your all-in-one checkout enhancement that reduces address entry errors, boosts delivery success rates, and improves customer satisfaction — all with a few clicks.
✅ Faster Checkout
✅ Fewer Address Errors
✅ Happier Customers
✅ Flexible Integration (Shopify & WordPress)
✅ Multiple Map Provider Options
Whether you're just starting or scaling globally, Addressly adapts to your store's needs with flexible map options, seamless integration, and smart automation.
🌟 Ready to enhance your checkout experience?
Activate Addressly today and make address entry effortless for your customers! 🚀