WebX Developments

Checkout Address Autocomplete for WooCommerce documentation

Version 2.1.0 · Updated November 13, 2026

Set up takes about ten minutes, most of it creating the Google key. Questions? Contact support with your order number.

Requirements

  • WordPress 5.0 or newer, WooCommerce 8.0 or newer. Tested with WordPress 7.1 and WooCommerce 11.3.
  • PHP 7.4 or newer.
  • A Google Cloud project with billing turned on.

Install the plugin

  1. Download checkout-address-autocomplete-2.1.0.zip from Account → Downloads. Don't unzip it.
  2. In WordPress, go to Plugins → Add New Plugin → Upload Plugin, choose the ZIP, click Install Now, then Activate.

Activate your license

  1. On this site, open Account → Licenses and click Show license key. Copy the key; it starts with wx_.
  2. In WordPress, go to WooCommerce → Address Autocomplete License, paste the key and click Activate / replace key. The status changes to Active.

Each website domain uses one activation. To move the license, click Deactivate this website on the old site, or click Deactivate next to it in Account → Licenses.

Create a Google API key

  1. Open the Google Cloud console and create a project, or choose an existing one. Make sure billing is enabled.
  2. Under APIs & Services → Library, enable Maps JavaScript API and Places API (New).
  3. Under APIs & Services → Credentials, click Create credentials → API key.
  4. Edit the key and restrict it:
    • Application restrictions: Websites. Add https://yourstore.com/* (and https://www.yourstore.com/* if you use www).
    • API restrictions: Maps JavaScript API and Places API (New).
  5. Copy the key.

This key is used in the visitor's browser, so the website restriction is what stops other sites from using it.

Configure the plugin

Go to WooCommerce → Address Autocomplete.

Address Autocomplete settings

SettingWhat it does
Google API KeyThe key you created above.
Enable billing addressSuggestions on the billing street address field.
Enable shipping addressSuggestions on the shipping street address field.

Click Save Changes, then open your checkout and type the start of an address.

How it works at checkout

  1. The customer chooses their country (or WooCommerce preselects it).
  2. They type three or more characters in Address. Up to five suggestions in that country appear under the field.
  3. They click a suggestion, or use the arrow keys and press Enter.
  4. Street, apartment or unit, city, state or province, postcode and country are filled. The customer can still edit anything.

Suggestions on the block checkout

On the block checkout, the shipping address comes first; billing uses the same address unless the customer unticks Use same address for billing. On the classic checkout, billing comes first and shipping appears under Ship to a different address?.

Costs and Google billing

Each address search is a Google autocomplete session: the suggestions while typing, plus one place lookup when the customer picks an address. The plugin uses session tokens so Google bills them together. See Google Maps Platform pricing for current rates and the monthly free allowance. To control spend, set a budget alert and API quotas in the Google Cloud console.

Troubleshooting

No suggestions appear. Open your browser's developer console on the checkout page. Google's message tells you what's wrong:

  • ApiNotActivatedMapError or API not enabled: enable Maps JavaScript API and Places API (New).
  • RefererNotAllowedMapError: add your domain to the key's website restrictions, including www if used.
  • BillingNotEnabledMapError: turn on billing for the Google Cloud project.

The state isn't filled. For a few countries Google's region name doesn't match WooCommerce's list. The customer can choose it from the list; everything else is still filled.

Suggestions are in the wrong country. Suggestions follow the selected country. Change the country first, then type the address.

Updates and uninstall

Updates appear in Dashboard → Updates while your license is active. Deactivating the plugin removes suggestions from checkout; deleting it removes its settings. Orders are never changed.

Changelog

2.1.0

  • Works with the WooCommerce block checkout.
  • Uses Google Places API (New), required for Google Cloud projects created since March 2025.
  • Keyboard and screen-reader support.
  • Country filled as a code; state matched to WooCommerce's list.
  • Shop Managers can save settings.
  • License activation and one-click updates.