Title: Autocomplete Google places
Author: Kais Chrouda
Published: <strong>April 1, 2022</strong>
Last modified: June 16, 2026

---

Search plugins

![](https://ps.w.org/autocomplete-google-places/assets/banner-772x250.png?rev=3573649)

![](https://ps.w.org/autocomplete-google-places/assets/icon-256x256.png?rev=3573611)

# Autocomplete Google places

 By [Kais Chrouda](https://profiles.wordpress.org/kais1977/)

[Download](https://downloads.wordpress.org/plugin/autocomplete-google-places.3.3.0.zip)

 * [Details](https://pcd.wordpress.org/plugins/autocomplete-google-places/#description)
 * [Reviews](https://pcd.wordpress.org/plugins/autocomplete-google-places/#reviews)
 *  [Installation](https://pcd.wordpress.org/plugins/autocomplete-google-places/#installation)
 * [Development](https://pcd.wordpress.org/plugins/autocomplete-google-places/#developers)

 [Support](https://wordpress.org/support/plugin/autocomplete-google-places/)

## Description

This plugin enables Google Places address auto-completion on text input fields (
order, checkout and registration pages). When a user starts typing an address and
picks a suggestion, the plugin auto-fills the street, city, state, postcode and 
country fields. You only need a valid Google Places API key.

The plugin targets the standard WooCommerce-style billing and shipping address fields(
for example `billing_address_1` and `shipping_address_1`).

As of version 3.0.0 the front-end script is written in modern, dependency-free vanilla
JavaScript (no jQuery required) and the bundled CMB2 settings library has been updated
for security.

### External services

This plugin connects to the Google Maps JavaScript API (Places library) to provide
address autocomplete and suggestions. This is required for the plugin to function.

When a visitor types in an address field, the text entered is sent to Google to 
return address predictions, and the selected address details are returned to fill
the form. The plugin loads the Google Maps script from Google’s servers using the
API key you configure on the settings page, along with your site’s language and 
region.

No data is sent until a visitor interacts with an address field on a page that contains
a supported field. You must provide your own Google API key.

 * Service provider: Google Maps Platform
 * Terms of Service: https://cloud.google.com/maps-platform/terms
 * Privacy Policy: https://policies.google.com/privacy

## Screenshots

[⌊The "Google Places" settings page where you enter your API key.⌉⌊The "Google Places"
settings page where you enter your API key.⌉[

The “Google Places” settings page where you enter your API key.

[⌊Address fields auto-filled after selecting a Google Places suggestion.⌉⌊Address
fields auto-filled after selecting a Google Places suggestion.⌉[

Address fields auto-filled after selecting a Google Places suggestion.

## Installation

 1. Upload the plugin files to the `/wp-content/plugins/autocomplete-google-places`
    directory, or install the plugin through the WordPress Plugins screen directly.
 2. Activate the plugin through the **Plugins** screen in WordPress.
 3. Open the **Google Places** admin menu (location-pin icon) and enter your Google
    Places API key.
 4. Save. Autocomplete is now active on pages that contain the supported address fields.

## FAQ

### Is this a paid plugin?

No, it is completely free.

### Do I need a Google API key?

Yes. As of 3.0.0 there is no built-in fallback key. Create a key in the Google Cloud
Console with the Maps JavaScript API and the Places library enabled, then enter 
it on the **Google Places** settings page.

### Does it still require jQuery?

No. As of 3.0.0 the front-end script is pure vanilla JavaScript and no longer enqueues
jQuery.

### Which fields are supported?

The standard WooCommerce-style billing and shipping address fields. When an address
is selected, address line 1, city, state, postcode and country are filled automatically.

### Can I use it on custom form fields?

Yes. In the “Custom fields (Form ID / class)” setting you can target address fields
on most forms (Contact Form 7, Gravity Forms, Elementor, and other standard HTML
forms) by ID and/or CSS class. Fields added dynamically (Ajax, modals, multi-step
forms) are detected automatically.

### It does not work on a field built with React or Vue. Why?

Some plugins and themes build their address fields with a JavaScript framework such
as React or Vue, where the field value is fully controlled by the framework. On 
those fields, no external autocomplete (including this one) can attach reliably,
because the framework re-renders the input and overrides external changes. This 
is a limitation of how those frameworks work, not of this plugin. Standard HTML 
fields are fully supported. Improved support for framework-based fields is planned
for a future release.

## Reviews

![](https://secure.gravatar.com/avatar/55f09354175ef847b4ab744514af5766a68f8e10f2eec3a773924aabaf4bc80b?
s=60&d=retro&r=g)

### 󠀁[Great](https://wordpress.org/support/topic/great-14401/)󠁿

 [mysoun](https://profiles.wordpress.org/mysoun/) April 3, 2022

Hi Thx for this plugin that offer premium service for free

 [ Read all 1 review ](https://wordpress.org/support/plugin/autocomplete-google-places/reviews/)

## Contributors & Developers

“Autocomplete Google places” is open source software. The following people have 
contributed to this plugin.

Contributors

 *   [ Kais Chrouda ](https://profiles.wordpress.org/kais1977/)
 *   [ chroudakais ](https://profiles.wordpress.org/chroudakais/)

[Translate “Autocomplete Google places” into your language.](https://translate.wordpress.org/projects/wp-plugins/autocomplete-google-places)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/autocomplete-google-places/),
check out the [SVN repository](https://plugins.svn.wordpress.org/autocomplete-google-places/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/autocomplete-google-places/)
by [RSS](https://plugins.trac.wordpress.org/log/autocomplete-google-places/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 3.3.0

 * New: custom field targeting now works with dynamically added fields. A MutationObserver
   detects address inputs that appear after page load (React/Ajax modals, multi-
   step forms, dynamically rendered checkouts) and attaches autocomplete to them
   automatically.
 * Improved: auto-filled values are now written in a way that React and other controlled-
   input frameworks register correctly, so the filled address is no longer reverted
   on the next render.

#### 3.2.0

 * New: multilingual support. The autocomplete now follows your WordPress site language
   and region (e.g. fr_FR), so suggestions and the predictions UI appear in the 
   visitor’s locale.
 * New: “Suggestion type” setting. Choose what Google suggests — street addresses(
   default), addresses & areas, cities only, regions, or businesses & places.
 * New: “Custom fields (Form ID / class)” option. Target address inputs on any form(
   Contact Form 7, Gravity Forms, custom forms) by ID and/or CSS class, separated
   by commas. When a suggestion is selected, the matched field is filled with the
   full street address and nearby city and postcode fields are auto-filled when 
   present. This restores and improves the old “Form ID” targeting from the 1.x 
   line.

#### 3.1.0

 * New: choose the autocomplete country scope from the admin settings. Default is
   Worldwide (works in all of Europe, USA, Canada, Japan and everywhere else); optionally
   restrict to up to 5 countries (Google’s maximum).
 * New: redesigned admin settings screen built with React (WordPress’ bundled wp.
   element), including a one-click “Test API key” button that verifies your Google
   Places key live.
 * Changed: replaced the bundled CMB2 library with a lightweight custom settings
   page (saved via the WordPress Settings API). This removes the vendored library
   entirely.

#### 3.0.0

 * Major release.
 * Rewrote the front-end script in modern vanilla JavaScript (ES6); removed the 
   jQuery dependency from the script and its enqueue.
 * Security: upgraded the bundled CMB2 library from 2.10.1 to 2.12.0 (addresses 
   CVE-2024-1792) and removed the dead root CMB2 loader.
 * Security: removed the hardcoded Google Maps API key fallback; the Maps script
   now loads only when an API key is configured.
 * Security: the Google Maps URL is now built with rawurlencode() and escaped with
   esc_url_raw().
 * Hardening: moved the direct-access guard ahead of all includes, removed unused
   example files, and added a directory-listing guard to /js.
 * Added uninstall cleanup of stored plugin options.
 * Compatibility: raised the minimum PHP requirement to 7.4 (required by CMB2 2.12.0);
   updated “Tested up to”.

## Meta

 *  Version **3.3.0**
 *  Last updated **2 weeks ago**
 *  Active installations **50+**
 *  WordPress version ** 5.6 or higher **
 *  Tested up to **7.0**
 *  PHP version ** 7.4 or higher **
 *  Language
 * [English (US)](https://wordpress.org/plugins/autocomplete-google-places/)
 * Tags
 * [Address AutoComplete](https://pcd.wordpress.org/plugins/tags/address-autocomplete/)
   [autocomplete](https://pcd.wordpress.org/plugins/tags/autocomplete/)[google address autocomplete](https://pcd.wordpress.org/plugins/tags/google-address-autocomplete/)
 *  [Advanced View](https://pcd.wordpress.org/plugins/autocomplete-google-places/advanced/)

## Ratings

 5 out of 5 stars.

 *  [  1 5-star review     ](https://wordpress.org/support/plugin/autocomplete-google-places/reviews/?filter=5)
 *  [  0 4-star reviews     ](https://wordpress.org/support/plugin/autocomplete-google-places/reviews/?filter=4)
 *  [  0 3-star reviews     ](https://wordpress.org/support/plugin/autocomplete-google-places/reviews/?filter=3)
 *  [  0 2-star reviews     ](https://wordpress.org/support/plugin/autocomplete-google-places/reviews/?filter=2)
 *  [  0 1-star reviews     ](https://wordpress.org/support/plugin/autocomplete-google-places/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/autocomplete-google-places/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/autocomplete-google-places/reviews/)

## Contributors

 *   [ Kais Chrouda ](https://profiles.wordpress.org/kais1977/)
 *   [ chroudakais ](https://profiles.wordpress.org/chroudakais/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/autocomplete-google-places/)