Descripción
The #1 Google Address Autocomplete plugin for WordPress. Add real-time address suggestions to any form on your site — checkout, contact, registration, booking, or custom forms. No coding required.
Why Choose Autocomplete Google Address?
Most address plugins force you to use their own form builder. This plugin is different — it works with your existing forms. WooCommerce checkout, Contact Form 7, WPForms, Gravity Forms, Elementor Pro Forms, or any custom HTML form. Just point it at your fields and it works.
Set Up in 60 Seconds
- Enter your Google API key
- Pick your form plugin (WooCommerce, CF7, WPForms, etc.)
- Done. Your forms now have address autocomplete.
Our Setup Wizard guides you through the entire process. No documentation needed.
Free Features
- Works with Any Form — Add address autocomplete to checkout, contact, registration, or any form
- Single Line Mode — Full formatted address goes into one field
- Unlimited Configurations — Different setups for different forms on the same site
- Keyboard Navigation — Arrow keys, Enter to select, Escape to close
- Smart Dropdown — Loading indicator, “no results” message, auto-positioning
- Google Powered — Uses the latest Google Places API for accurate, worldwide results
- Lightweight — No bloat, no extra CSS frameworks, no jQuery UI dependencies
- Conflict Prevention — Option to skip Google Maps API loading if another plugin already loads it
- Global or Per-Page Activation — Control exactly where autocomplete appears
- Shortcode Support — Use
[aga_autocomplete]to add autocomplete anywhere - Config Duplicate — One-click duplicate existing form configurations
- Import/Export — Export all configs as JSON, import on another site
- Diagnostic Health Check — Auto-check API keys, enabled APIs, system info
- Conflict Detection — Warns when other plugins load Google Maps API
- Works in Every Country — International address support with smart country-aware mapping
Pro Features
- Map Picker (NEW) — Interactive Google Map appears below the address input. Users can click anywhere on the map or drag the pin to pick their exact address — no typing needed. The map auto-centers on the user’s real GPS location (zoom level 17 by default, configurable in Settings > Appearance). If GPS is unavailable, it falls back to IP-based geolocation, then to country center. After picking, all address fields (street, city, state, zip, country) fill automatically via reverse geocoding. Works with WooCommerce, Contact Form 7, WPForms, Gravity Forms, Elementor, Fluent Forms, Ninja Forms, and any custom form.
- Smart Mapping Mode — One field triggers autocomplete, then automatically fills Street, City, State/District, Zip, and Country into separate fields
- WooCommerce Auto-Integration — Zero configuration needed. Setup Wizard auto-detects WooCommerce, creates billing + shipping configs, detects Classic vs Block checkout. Configure Map Picker, Geolocation, Address Validation, and Saved Addresses right in the wizard.
- One-Click Form Presets — Pre-built selector templates for Contact Form 7, WPForms, Gravity Forms, Elementor Pro Forms, Fluent Forms, and Ninja Forms
- Multiple Country Restrictions — Limit autocomplete results to one or more countries. Map Picker auto-centers on the restricted country.
- Per-Form Language Override — Set different languages for different forms
- Per-Page Activation — Load autocomplete only on specific pages
- Smart Select Matching — Automatically matches state/district/province names to WooCommerce dropdown values for every country (US states, Bangladesh districts, Indian states, UK counties, etc.)
- React-Compatible — Works perfectly with WooCommerce Block Checkout and other React-based forms
- Address Validation — Verify addresses with green/yellow/red badges using Google Address Validation API
- Geolocation Auto-Detect — “Use My Location” GPS button on the address input
- Saved Addresses — Show recently used addresses for logged-in users (up to 5 per user)
- PO Box Detection — Automatic warning when PO Box, APO, FPO, or military addresses are entered
- Address Verification Webhook — Send real-time alerts to Slack, Zapier, or any URL when invalid addresses are submitted
- Checkout Abandonment Tracking — Track users who type an address but don’t complete checkout. Events appear in Analytics.
- White Label Mode — Custom admin menu name for agencies and developers
- REST API — /wp-json/aga/v1/config and /wp-json/aga/v1/validate endpoints for headless React/Next.js storefronts
- Usage Analytics Dashboard — Track searches, selections, abandonment rate, top countries/cities
- Place Type Filter — Restrict results to addresses, cities, businesses, or regions
- Custom Dropdown Styling — Customize dropdown colors, fonts, border radius, and map zoom level from admin
- Elementor Widget — Native drag-and-drop widget with Map Picker, Geolocation, Address Validation, and Saved Addresses
- Elementor Form Field — Address Autocomplete field type for Elementor Pro Forms with all Pro features
- Dark Mode — Autocomplete dropdown adapts to user’s dark mode preference
- RTL Support — Full right-to-left language support for Arabic, Hebrew, and more
- ARIA Accessibility — Screen reader support with proper listbox/combobox roles
- Country Restriction Dropdown — Select2 multi-select with all countries (max 5)
- Language Selector — Select2 dropdown with 80+ languages
- Smart Country-Aware Mapping — Automatically maps city/state correctly for 30+ countries
- Priority Support — Direct WhatsApp support from the developer
Works With
- WooCommerce (Classic & Block Checkout)
- Contact Form 7
- WPForms
- Gravity Forms
- Elementor Pro Forms
- Fluent Forms
- Ninja Forms
- Formidable Forms
- Any HTML form with standard inputs
How It Works
For WooCommerce users (Pro):
Activate the plugin, enter your API key in the Setup Wizard, select “WooCommerce” — done. The plugin automatically detects your checkout page and adds autocomplete to billing and shipping address fields. No form configuration needed.
For form plugin users (Pro):
Select your form plugin in the Setup Wizard. The plugin creates a configuration with pre-filled selectors matching your plugin’s field pattern. Just update the field IDs to match your specific form.
For any other form (Free & Pro):
Create a configuration, enter the CSS selector of your address field (right-click > Inspect to find it), choose Single Line or Smart Mapping mode, and activate globally or on specific pages.
Technical Details
- Uses the latest Google Places API (New) — future-proof and fully supported
- Programmatic API approach — your form inputs keep their original styling
- Session tokens for optimized Google API billing
- Debounced search (300ms) to minimize API calls
- Reverse geocoding for draggable map pin (requires Geocoding API)
Instalación
Automatic Installation (Recommended)
- Go to Plugins > Add New in your WordPress admin
- Search for “Autocomplete Google Address”
- Click Install Now, then Activate
- The Setup Wizard will launch automatically — follow the 3 steps:
- Step 1: Enter your Google Maps API key
- Step 2: Select your form plugin (WooCommerce, CF7, WPForms, Gravity Forms, Elementor, or Manual)
- Step 3: Done!
Manual Installation
- Download the plugin zip file
- Go to Plugins > Add New > Upload Plugin
- Upload the zip and click Install Now
- Activate the plugin
- Go to Google Address > Settings to enter your API key
Getting a Google Maps API Key
- Go to Google Cloud Console
- Create a new project (or select an existing one)
- Go to APIs & Services > Library
- Enable these APIs:
- Places API (New)
- Maps JavaScript API
- Geocoding API (optional — needed for draggable map pin)
- Go to APIs & Services > Credentials
- Click Create Credentials > API Key
- Copy the key and paste it in the plugin settings
WooCommerce Setup (Pro)
No manual configuration needed:
- Complete the Setup Wizard and select “WooCommerce”
- The plugin automatically creates billing and shipping configurations
- Go to your checkout page — address autocomplete is already working
- Works with both Classic Checkout and Block Checkout
Form Plugin Setup (Pro)
- Complete the Setup Wizard and select your form plugin
- The plugin creates a configuration with pre-filled selectors
- Click “Apply Preset” to fill all field selectors with the correct pattern
- Update the placeholder field IDs to match your actual form
- Save and test on your form page
Manual Setup
- Go to Google Address > Add New
- Enter the CSS selector of your address input field (e.g.,
#billing_address,.my-address-field,[name="address"])- To find the selector: right-click the field on your page > click “Inspect” > look for the
idorclassattribute
- To find the selector: right-click the field on your page > click “Inspect” > look for the
- Choose a mode:
- Single Line — Full address in one field, optionally capture lat/lng/place ID
- Smart Mapping (Pro) — Fill Street, City, State, Zip, Country into separate fields
- Set activation: Global (all pages) or specific pages
- Publish the configuration
- If not using Global Activation, add the shortcode
[aga_form id="123"]to your page
FAQ
-
Does this work with WooCommerce checkout?
-
Yes! With the Pro plan, WooCommerce integration is fully automatic — no configuration needed. It works with both the Classic Checkout and the new Block Checkout. The plugin detects your checkout page and adds autocomplete to billing and shipping address fields automatically.
-
Does it work in my country?
-
Yes. The plugin uses Google Places API which covers addresses worldwide. The smart select matching system automatically handles different address formats — US states, Bangladesh districts, Indian states, Canadian provinces, UK counties, Australian states, and more.
-
Do I need a Google Maps API Key?
-
Yes, a Google Maps API key is required. You can get one for free from the Google Cloud Console. Google offers $200/month in free API credits which covers most small-to-medium sites.
-
Which Google APIs do I need to enable?
-
Required: Places API (New) and Maps JavaScript API. Optional: Geocoding API (only needed if you want the draggable map pin to update address fields when moved).
-
Will this slow down my site?
-
No. The Google Maps script loads asynchronously and only on pages where autocomplete is active. The plugin itself is lightweight with no jQuery UI, no CSS frameworks, and no unnecessary dependencies.
-
Does it change my form’s styling?
-
No. Unlike other plugins that inject their own styled input, this plugin uses a programmatic API that keeps your existing form inputs completely untouched. The autocomplete dropdown uses minimal, clean CSS that adapts to any design.
-
Can I use it on multiple forms?
-
Yes. Create as many configurations as you need — different setups for different forms on the same site. Each configuration can have its own selectors, mode, country restrictions, and activation rules.
-
Does it work with page builders?
-
Yes. It works with Elementor, Beaver Builder, Divi, and any page builder. The plugin uses CSS selectors to find form fields, so it works regardless of how the form was built.
-
Can I restrict results to specific countries?
-
Yes (Pro). You can restrict autocomplete results to one or more countries using two-letter country codes. For example, enter “US, CA” to show only US and Canadian addresses.
-
What happens when I upgrade to Pro?
-
Pro features unlock instantly — no reinstall, no separate download. Just enter your license key in the plugin and all Pro features become available immediately.
-
Is there a free trial?
-
Yes, we offer a 3-day free trial of the Pro plan so you can test all features before purchasing.
Reseñas
Colaboradores & Desarrolladores
“Autocomplete Google Address” es software de código abierto. Las siguientes personas han contribuido a este plugin.
Colaboradores“Autocomplete Google Address” ha sido traducido en 2 idiomas. Gracias a los traductores por sus contribuciones.
Traduce “Autocomplete Google Address” a tu idioma.
¿Interesado en el desarrollo?
Revisa el código, echa un vistazo al repositorio SVN, o suscríbete al registro de desarrollo por RSS .
Historial de cambios
5.2.2
- FIX: Map Picker no longer shows a wrong pin in Mali/Africa on initial load. Marker is hidden until real location is found.
- FIX: Map Picker no longer appears on the admin form edit page — only shows on the frontend where customers interact.
- FIX: Disabled select/input fields (non-Pro) now display cleanly without broken checkmark pattern.
5.2.1
- IMPROVED: Map Picker now uses real GPS geolocation to center on user’s exact location (zoom 17) instead of country center.
- IMPROVED: If GPS is denied/unavailable, Map Picker falls back to IP-based geolocation (zoom 14) for approximate location.
- IMPROVED: If IP geolocation also fails, falls back to country restriction center as last resort.
- NEW: Configurable Map Zoom Level in Settings > Appearance (range 1-21, default 17).
- FIX: Disabled Select2/select fields now display cleanly for free users (removed broken checkmark pattern).
- FIX: Freemius is_premium flag corrected — Pro users no longer see “Download Pro Version” button.
5.2.0
- NEW: Map Picker — interactive map below address input. Users can click or drag the pin to pick an address. Replaces the old Map Preview with a unified, always-visible map experience (Pro).
- NEW: Map centers on restricted country automatically when country restriction is set.
- NEW: PO Box / APO / Military address detection with visual warning banner.
- NEW: Fluent Forms integration with preset selectors.
- NEW: Ninja Forms integration with preset selectors.
- NEW: Setup Wizard now shows WooCommerce feature configuration step — toggle Map Picker, Address Validation, Geolocation, Saved Addresses, plus set Country Restriction, Place Types, and Language with a live preview.
- NEW: WooCommerce auto-detect in Setup Wizard — detects block vs classic checkout and pre-selects WooCommerce.
- NEW: Setup Wizard creates visible form config posts for WooCommerce (billing + shipping) so users can see and edit their configs.
- NEW: Setup Wizard is now a visible menu item under the Autocomplete menu.
- NEW: Address Verification Webhook — send notifications to Slack, Zapier, or any URL when invalid/suspicious addresses are submitted (Pro).
- NEW: White Label Mode — hide plugin branding and set a custom admin menu name. Ideal for agencies (Pro).
- NEW: Checkout Abandonment Tracking — track when users type an address but leave without completing the form. Events appear in Analytics (Pro).
- NEW: REST API endpoints — /wp-json/aga/v1/config and /wp-json/aga/v1/validate for headless/React storefronts (Pro).
- NEW: Address Validation and Saved Addresses now available in Elementor Widget and Elementor Form Field.
- NEW: Geolocation now available in Elementor Form Field.
- NEW: Dark mode support — autocomplete dropdown, badges, and warnings adapt to prefers-color-scheme: dark.
- NEW: RTL language support for Arabic, Hebrew, and other right-to-left languages.
- NEW: Loading skeleton animation while fetching suggestions.
- NEW: ARIA accessibility — listbox, combobox, option roles, aria-expanded, aria-selected for screen readers.
- FIX: iOS/Safari — dropdown items now respond to touch events reliably. Added touchend handlers, tap highlight, and smooth scrolling.
- FIX: iOS — native autocomplete no longer overlaps custom dropdown (autocomplete=”aga-none” workaround).
- FIX: Race condition — rapidly selecting multiple addresses no longer applies stale results.
- FIX: Stale API responses discarded when user types faster than the API responds.
- FIX: Autocomplete dropdown no longer reappears after dragging the map pin.
- FIX: Null safety for config.formats preventing JS errors on some form types.
- FIX: Google Maps API polling loop now times out after 20 seconds instead of running forever.
- FIX: Added ABSPATH protection to 6 PHP files that were missing it.
- PERF: Combined 2 database queries into 1 for frontend form loading.
- PERF: Health check results cached in 5-minute transient.
- PERF: Google Maps script loaded with loading=async parameter.
5.1.2
- FIX: Settings toggle not saving — unchecking a toggle (e.g., “Do not load Google Maps JS API”) now properly saves as OFF.
- FIX: “pointer is not a function” JavaScript error on settings page caused by missing wp-pointer dependency.
- FIX: Added active tab tracking so saving on one tab doesn’t reset toggles on other tabs.
5.1.1
- FIX: Setup wizard “Sorry, you are not allowed to access this page” error on fresh activation.
- FIX: Wizard page now registers as standalone hidden page, accessible regardless of CPT timing.
- FIX: Added capability check and redirect loop guard for wizard.
5.1.0
- NEW: Address Validation with verified/warning/invalid badges (Pro).
- NEW: Geolocation “Use My Location” GPS button (Pro).
- NEW: Saved Addresses — show last 5 used addresses for logged-in users (Pro).
- NEW: Usage Analytics Dashboard — track searches, selections, top cities/countries (Pro).
- NEW: Place Type Filter — restrict to addresses, cities, businesses, regions (Pro).
- NEW: Custom dropdown CSS styling from Appearance settings tab (Pro).
- NEW: Native Elementor Widget — drag-and-drop address autocomplete widget.
- NEW: Elementor Pro Form Field — Address Autocomplete field type with smart mapping sub-fields and layout control.
- NEW: Shortcode
[aga_autocomplete]— add autocomplete to any page/post. - NEW: Form Config Duplicate — one-click duplicate button on configs list.
- NEW: Import/Export — JSON export/import for all form configurations.
- NEW: Diagnostic Health Check page — auto-tests API keys, enabled APIs, system info.
- NEW: Conflict Detection — warns when other plugins load Google Maps API.
- NEW: WhatsApp Chat Widget — 24/7 support button on all plugin admin pages.
- NEW: Review Request Banner — non-intrusive prompt after 14 days of use.
- NEW: Free-to-Pro Upgrade Banner — feature showcase after 7 days for free users.
- NEW: Smart Country-Aware Address Mapping — correct city/state mapping for 30+ countries.
- NEW: Country Restriction Select2 multi-select dropdown with all countries (max 5).
- NEW: Language Select2 dropdown with 80+ languages.
- NEW: Live Preview — test autocomplete from the form config admin page.
- IMPROVED: Zero-Config WooCommerce — auto-detects classic vs block checkout.
- IMPROVED: WooCommerce re-initialization on AJAX checkout updates and shipping toggle.
- IMPROVED: Modern admin UI with design tokens, unified component library.
- IMPROVED: All inline styles extracted to admin.css.
- IMPROVED: Saved addresses trigger map preview and reverse geocode.
- IMPROVED: Country restriction now properly supports multiple countries as array.
- FIXED: Masked API key (bullet characters) being saved to database.
- FIXED: Dropdown reappearing after address selection.
- FIXED: Geolocation shows friendly error on non-HTTPS sites.
5.0.0
- Major update: Single plugin architecture — no separate Pro download needed.
- Migrated to new Google Places API (programmatic approach, no style overrides).
- Added 3-step setup wizard for first-time configuration.
- Added WooCommerce auto-integration (Pro) — works with both classic and block checkout.
- Added form plugin presets for Contact Form 7, WPForms, Gravity Forms, and Elementor (Pro).
- Added draggable map preview with reverse geocoding (Pro).
- Added smart select matching for international address fields (works with all countries).
- Added React-compatible field updates for WooCommerce block checkout.
- Redesigned settings page with tabbed interface.
- Improved dropdown UX with loading spinner, no-results message, and Google attribution.
- Added API key validation button in settings.
- Multiple country restriction support (Pro).
- Per-form language override (Pro).
1.0.0
- Initial release.
