Google Address Autocomplete

Google Address Autocomplete allows your WooCommerce store to autofill checkout and My Account addresses with Google Places suggestions, show an interactive map with a draggable marker, and save exact delivery coordinates to every order.

Requirements

↑ Back to top

You need a Google API key with these three APIs enabled in Google Cloud Console, and billing active on the project:

• Places API — powers address suggestions
• Maps JavaScript API — powers the interactive map
• Geocoding API — powers address-to-field mapping and coordinates

To create your key:

1. Go to console.cloud.google.com and create or select a project.
2. Open APIs & Services → Library and enable the Places API, Maps JavaScript API, and Geocoding API.
3. Open APIs & Services → Credentials → Create credentials → API key.
4. (Recommended) Under Application restrictions, choose HTTP referrers and add your store domain, e.g. https://yourstore.com/*
5. Ensure billing is enabled on the project — Google requires it even within the free monthly usage credit.

Installation

↑ Back to top

1. Download the plugin .zip from your WooCommerce account.
2. In WordPress admin, go to Plugins → Add New → Upload Plugin.
3. Upload the .zip and click Install Now, then Activate.
4. Make sure WooCommerce is installed and active.

Getting Started

↑ Back to top

1. Go to WooCommerce → Settings → Address Autocomplete.
2. In General Settings, paste your Google API key into the API Key field.
3. Tick Enable for Checkout (Billing) and Enable for Checkout (Shipping). Optionally tick the two My Account options.
4. Click Save changes.
5. Open your checkout page, start typing an address, and select a suggestion — the address fields fill automatically.

If the API key is misconfigured, a notice at the top of the settings page tells you exactly which Google API needs to be enabled.

Settings

↑ Back to top

General Settings

↑ Back to top

• API Key — your Google API key.
• Enable for Checkout (Billing / Shipping) — turn autocomplete on for each checkout address form.
• Enable for My Account (Billing / Shipping) — turn autocomplete on for the saved-address forms in My Account.
• Restricted Countries — select the countries where autocomplete and the map should appear. For all other countries, standard WooCommerce fields are used.

Address Fields Settings

↑ Back to top

• Autocomplete Field Label — customize the label of the dedicated autocomplete search field.
• Combine Address — merge Address Line 1 and Address Line 2 into a single line.
• Disable — remove the dedicated autocomplete field and attach autocomplete directly to Address Line 1 instead.
• Address Pattern — choose Street No then Street Name, or Street Name then Street No.
• Pattern Countries — apply the chosen pattern only to selected countries.

Google Map Settings

↑ Back to top

• Enable — show an interactive Google Map on the checkout page.
• Zoom — default zoom level (e.g. 14 for street level).
• Default Language — language of the map interface.
• Enable For Billing / Enable for Shipping — allow customers to drag the map marker for each address type. Dragging updates the address fields in real time.
• Map Styling Script — paste a JSON style from Snazzy Maps to match your brand.
• Marker Icon — use the default marker or upload a custom icon.

Address Mapping (optional, advanced)

↑ Back to top

• Tick Enable mapping for custom control over how Google address components fill each field.
• Use placeholders in each field, for example: Address 1 = {street_number} {route}, City = {locality}, State = {administrative_area_level_1}, Postcode = {postal_code}.
• Leave mapping disabled to use the built-in default mapping, which works for most stores.

Usage

↑ Back to top

1. On checkout (billing and/or shipping), customers see a search field labeled Enter a location above the address fields.
2. As they type, Google Places shows matching address suggestions.
3. Selecting a suggestion automatically fills Address, City, State, Postcode, and Country.
4. If the map is enabled, a Google Map appears showing the selected location with a marker.
5. If drag & drop is enabled, customers can drag the marker to their exact spot; the address fields update automatically.
6. The location’s latitude and longitude are saved to the order and shown in WooCommerce → Orders, ready for delivery and dispatch.

The same behavior applies to the billing and shipping address forms in My Account → Addresses when those options are enabled.

Troubleshooting

↑ Back to top

Autocomplete field doesn’t appear on checkout

• Confirm Enable for Checkout is ticked and saved, and the API key is entered.
• If you set Restricted Countries, autocomplete only appears for those countries.
• Clear any cache and reload the checkout.

A notice says an API is not enabled / REQUEST_DENIED

• Enable Places API, Maps JavaScript API, and Geocoding API for the project that owns your key.
• Confirm billing is enabled on the project.
• If you set key restrictions, include your store domain in the HTTP referrer list.

Suggestions appear but fields don’t fill

• Select a suggestion from the dropdown rather than typing the full address manually.
• If Address Mapping is enabled, check each field has valid placeholders, or disable mapping to use the default.

The map doesn’t show

• Enable it under Google Map Settings → Enable, and confirm Maps JavaScript API is enabled.
• A “For development purposes only” watermark means billing isn’t enabled on your Google project.

Frequently Asked Questions

↑ Back to top

Do I need a paid Google account?
You need a Google Cloud project with billing enabled, but Google provides a monthly free-usage credit that covers typical store volumes. Usage beyond that is billed by Google directly.

Which checkout does this support?
Both the WooCommerce Checkout Blocks (block checkout) and the classic shortcode checkout.

Is it compatible with HPOS?
Yes. Fully compatible with High-Performance Order Storage.

Can customers still type an address manually?
Yes. The autocomplete field is an enhancement — customers can always fill the standard fields by hand.

Where do I see the saved coordinates?
In WooCommerce → Orders, open an order — the latitude and longitude appear in the order details.