How to add address autocomplete to Gravity Forms

Gravity Forms core does not add Google address suggestions by itself. The supported manual route is to install the official Geolocation Add-On, which adds Google Places integration to Address fields. You can also use a specialist extension if you need features such as country restrictions, map fields, or more control over how addresses are populated.

The official add-on is a sensible choice if you already have access to it. A third-party extension is usually quicker when you only want autocomplete and do not need the wider geolocation features.

In Google Cloud, select or create a project, add a billing method, and enable the APIs required by your chosen integration. The official Geolocation Add-On requires Places API and Maps JavaScript API. Create an API key, restrict it to your website’s HTTP referrers, and restrict its API access to only the services you need. Include staging or local domains if you will test there.

Check which Places version your integration supports before enabling APIs. The current Gravity Forms add-on supports the new Places API and has a setting for legacy keys, while the current Gravity Perks documentation says its autocomplete integration is not compatible with Places API (New). Using the wrong API version is a common reason for an empty suggestion list or a browser console error.

Install and activate the Geolocation Add-On, then go to Forms → Settings → Geolocation. Paste the Google Places API key into the key field and save. A green check mark indicates that Gravity Forms has accepted the key. Gravity Forms 2.6 or later is required according to the add-on documentation.

Next, edit the form and open the settings for its Address field. Under the advanced settings, enable Enable Geolocation Suggestions, then save the form. Repeat this for every Address field that should offer suggestions.

Embed the form on a public page and type several characters into the address field. Select a Google suggestion rather than merely typing an address, then confirm that the street, city, state or province, postal code, and country populate the intended inputs.

Test desktop and mobile layouts, international addresses if relevant, apartment or unit numbers, validation, notifications, and the saved entry. Google suggestions do not guarantee that a unit number will be included, so keep the address line 2 or unit field editable and ask users to verify the result. Support reports also commonly involve popups, JavaScript conflicts, and partial population when a single-line field is used instead of the structured Address field.

If no suggestions appear, check the browser console, confirm that the key is authorised for the exact domain, verify billing, and make sure the required APIs are enabled. Also check that another plugin is not loading a conflicting Google Maps JavaScript library. Gravity Forms includes a Google Maps Conflicts setting, but its documentation recommends leaving it disabled unless a conflict is actually occurring.

If the key works but the wrong countries appear, use the integration’s country restriction setting. If only the first address line fills, use a structured Address field and select a complete suggestion. Do not remove normal address inputs or validation just because autocomplete is enabled; users must still be able to correct incomplete or unusual addresses.

For the quickest setup, install Gravity Perks Address Autocomplete, enter the Google API key under Forms → Settings → Autocomplete, and enable Enable Google Address Autocomplete in each Address field’s Perks settings. Its documentation describes the same Google Places API and Maps JavaScript API connection, with options for country restrictions and address-field population.

This route is a good fit when Gravity Forms is your main form builder and you want address suggestions without configuring the wider geolocation feature set. Follow the plugin’s current API instructions carefully, especially its restriction against Places API (New), and test the form after activating any caching or optimisation plugin.