Welcome to the official documentation for AutoComplete Address Checkout For WooCommerce. This plugin adds Google Places address autocomplete to your WooCommerce checkout page — billing and shipping fields are filled instantly when a customer selects their address.
Pro Version | Support | WordPress.org
1. Requirements
- WordPress 5.0 or higher
- WooCommerce 6.0 or higher
- PHP 7.4 or higher
- A valid Google Maps API key with Places API and Maps JavaScript API enabled
2. Installation
Install via WordPress Plugin Directory
- Go to WordPress Admin → Plugins → Add New
- Search for AutoComplete Address Checkout For WooCommerce
- Click Install Now then Activate
- Go to WooCommerce → AutoComplete Address to configure
Install via ZIP Upload
- Download the plugin ZIP file
- Go to WordPress Admin → Plugins → Add New → Upload Plugin
- Choose the ZIP file and click Install Now
- Click Activate Plugin
3. Getting a Google API Key
The plugin requires a Google Maps API key to work. Follow these steps to get one:
- Go to Google Cloud Console
- Create a new project or select an existing one
- Go to APIs & Services → Library
- Search for and enable Maps JavaScript API
- Search for and enable Places API
- Go to APIs & Services → Credentials
- Click Create Credentials → API Key
- Copy the API key
- Paste it into WooCommerce → AutoComplete Address → Google API Key
Note: Google requires billing to be enabled on your Cloud project to use the Places API. New accounts receive a free monthly credit that covers most small to medium store usage.
4. Plugin Settings
Go to WooCommerce → AutoComplete Address to access all settings.
General Settings
| Setting | Description | Default |
|---|---|---|
| Enable Plugin | Turn the autocomplete feature on or off | Enabled |
| Google API Key | Your Google Maps API key. Required for autocomplete to work. | — |
| Placeholder Text | The text shown inside the autocomplete search field | Search your address… |
| Place Type | Filter what types of locations appear in suggestions. See Place Types section. | address |
Address Fields
Choose which fields are automatically filled when a customer selects an address.
| Field | Description |
|---|---|
| Street Address (Line 1) | House/building number and street name |
| Street Address (Line 2) | Apartment, suite, unit, neighborhood |
| City | Town or city name |
| State | State, province, or region |
| Postcode | ZIP or postal code |
| Country | Country code (e.g. IN, US, GB) |
5. Free vs Pro Features
| Feature | Free | Pro |
|---|---|---|
| Google Places address autocomplete | ✅ | ✅ |
| Classic checkout support | ✅ | ✅ |
| Block checkout support | ✅ | ✅ |
| Billing address autocomplete | ✅ | ✅ |
| Shipping address autocomplete | ✅ | ✅ |
| Auto-fill all address fields | ✅ | ✅ |
| Custom placeholder text | ✅ | ✅ |
| Place types filter | ✅ | ✅ |
| Country-specific address filtering | ❌ | ✅ |
| Restrict to up to 15 countries | ❌ | ✅ |
| Priority support | ❌ | ✅ |
6. Country Restriction (Pro Only)
The Pro version allows you to restrict autocomplete suggestions to specific countries. Only addresses from your selected countries will appear in the dropdown.
How to set it up
- Go to WooCommerce → AutoComplete Address → Country Restriction
- Enter country codes separated by commas — e.g.
IN,US,GB,AU - Save settings
Country Code Examples
| Country | Code |
|---|---|
| India | IN |
| United States | US |
| United Kingdom | GB |
| Australia | AU |
| Canada | CA |
| United Arab Emirates | AE |
Note: You can add up to 15 country codes. Use standard 2-letter ISO 3166-1 alpha-2 codes in uppercase.
7. Place Types
Place Types control what kind of locations appear in the autocomplete suggestions.
| Value | Shows | Best For |
|---|---|---|
address | Precise street addresses | Most WooCommerce stores — recommended |
geocode | All geocoding results including areas | Stores that deliver to areas not just addresses |
establishment | Businesses and points of interest | Stores delivering to business addresses |
(regions) | Regions, areas, countries | Stores shipping to broad regions |
(cities) | Cities only | City-level delivery stores |
Tip: For most WooCommerce stores, keep this set to address for the most accurate checkout results.
8. FAQ
Does the plugin work with the WooCommerce block checkout?
Yes. The plugin supports both the classic WooCommerce checkout and the Gutenberg block-based checkout introduced in WooCommerce 8.x.
Do I need a Google API key?
Yes. A valid Google Maps API key with Places API and Maps JavaScript API enabled is required. See the Getting a Google API Key section above.
Is the autocomplete free to use?
The plugin is free. Google Maps API usage is free up to a monthly credit limit. Most small to medium stores stay within the free tier. See Google Maps Platform pricing for details.
Can I restrict autocomplete to my country only?
Country restriction is a Pro feature. Upgrade to Pro to restrict suggestions to specific countries.
Does it work for both billing and shipping addresses?
Yes. The autocomplete field is added to both billing and shipping address forms automatically.
Does the plugin store customer address data?
No. The plugin does not store or log any customer data. Only the partial address text typed by the customer is sent to Google to fetch suggestions.
The autocomplete is not appearing. What should I check?
- Make sure your Google API key is entered correctly in settings
- Make sure Places API and Maps JavaScript API are enabled in Google Cloud Console
- Make sure billing is enabled in your Google Cloud project
- Check your browser console for any API key errors
- Make sure the plugin is enabled in settings
Does this work with custom checkout plugins like Checkout Field Editor?
The plugin targets standard WooCommerce address field IDs. Compatibility with heavily customised checkouts may vary. Contact support if you have a specific setup.
9. Support
Free Support
Post your question on the WordPress.org support forum.
Pro Support
Pro users get priority support directly from the development team. Contact us here.