Version 1.0.0 · Updated April 2026
Before installing Address Autocomplete & Maps, ensure your environment meets these requirements:
⚠️ A Google Cloud account with billing enabled is required. Google offers a free monthly credit ($200 USD) which covers typical usage for most stores. You will only be charged if your usage exceeds the free tier.
address-autocomplete.zip, and click Install Now.address-autocomplete.zip on your local computer.address-autocomplete folder to /wp-content/plugins/.EA- licence key from your purchase confirmation email.Your licence key is also available from My Account → Orders on expertaddons.com.
This plugin relies on the Google Places API for address suggestions and the Maps JavaScript API for the map preview. Follow these steps to obtain and configure your API key:
console.cloud.google.com.Restricting your API key to your domain is strongly recommended. An unrestricted key exposed in the page source can be misused, leading to unexpected billing charges.
Once you have your Google API key:
The plugin immediately tests the key and displays a green confirmation notice if the key is valid and the required APIs are enabled. If the key fails validation, a warning is shown with a link to the relevant Google Cloud documentation.
You can enable autocomplete independently for billing and shipping addresses. Go to WooCommerce → Address Autocomplete → Settings → Fields.
When a customer starts typing in the address line 1 field, a dropdown of matching suggestions appears. After selecting a suggestion, the following fields are auto-filled:
Address Line 2 is intentionally left blank so the customer can add apartment, suite, or unit numbers manually.
By default, the autocomplete suggests addresses from all countries. You can restrict suggestions to specific countries to improve relevance and reduce API usage costs.
Google's Places API supports restricting to up to 5 countries at once. If you sell to more than 5 countries, leave this setting blank to allow worldwide suggestions.
Restricting to a smaller set of countries also reduces your API usage, which keeps costs lower if your store has high checkout traffic.
After a customer selects an address from the autocomplete dropdown, an embedded Google Map can appear below the address fields to give a visual confirmation of the selected location.
To configure: go to WooCommerce → Address Autocomplete → Settings → Map.
The map updates automatically each time a new address suggestion is selected. If the customer types a new address manually without using the autocomplete, the map does not update until a suggestion is selected.
Address Autocomplete & Maps is compatible with both the classic WooCommerce shortcode checkout ([woocommerce_checkout]) and the modern WooCommerce block-based checkout introduced in WooCommerce 8.x.
Block checkout support is enabled automatically — no additional configuration is required. The plugin detects which checkout type is active and loads the appropriate integration.
⚠️ Some third-party checkout plugins and page builders implement their own address fields that may not be compatible. If autocomplete is not appearing, check the Troubleshooting section below.
First, confirm your API key is saved and shows a green validation notice in WooCommerce → Address Autocomplete → Settings. Then open your browser's developer console (F12) and look for any JavaScript errors mentioning "Google" or "Places". The most common cause is an API key that has not had the Places API enabled, or an HTTP referrer restriction that blocks your domain.
This usually means the Geocoding API is not enabled in your Google Cloud project. Enable it in Google Cloud Console → APIs & Services → Library → Geocoding API and re-save your API key in the plugin settings.
Ensure Show map preview is enabled in the Map settings tab. Verify that the Maps JavaScript API is enabled in your Google Cloud project. Also confirm you do not have a Content Security Policy (CSP) header blocking maps.googleapis.com.
Check that Enable on Shipping Address is enabled in the Fields settings. Also confirm that the WooCommerce setting Ship to a different address is available at checkout — go to WooCommerce → Settings → Shipping → Shipping options and ensure "Force shipping to the customer billing address" is not checked.
Restrict your API key to your domain in the Google Cloud Console under Credentials → Edit Key → Application restrictions. Also check that your key has not been shared or committed to a public repository.
Our support team responds within 24 hours on business days. Email us at support@expertaddons.com and include your site URL, licence key, and a description of the issue for the fastest response.
Contact Support