Address Autocomplete

Swft uses the Google Places Autocomplete API to provide real-time address suggestions as the shopper types their postcode or street address. Selecting a suggestion populates all address fields instantly — street, city, county, postcode, and country.

How it works

The autocomplete field replaces the standard address line 1 input. As the shopper types, suggestions are fetched from the Places API restricted to the countries enabled for the merchant. Selecting a result triggers a Place Details lookup that returns structured address components, which Swft maps to WooCommerce billing and shipping field equivalents.

Field mapping:

Places component	Swft field
street_number + route	Address line 1
subpremise	Address line 2
postal_town or locality	City
administrative_area_level_2	County / state
postal_code	Postcode
country	Country

Configuration

Address autocomplete is enabled by default for all merchants. To disable it:

{
  "modules": {
    "addressAutocomplete": false
  }
}

To restrict autocomplete to specific countries (recommended — reduces noise for single-market merchants):

{
  "modules": {
    "addressAutocomplete": {
      "countries": ["GB", "IE"]
    }
  }
}

API key

Swft manages the Google Places API key at the platform level. You do not need a Google Cloud account or a Places API key. Usage is included in all Swft plans.

Tip

If your checkout serves multiple countries, leave countries unconfigured. The Places API will suggest addresses globally and Swft will select the appropriate country code.

Fallback

If the Places API request fails (network error, quota exceeded), the autocomplete field degrades to a standard text input. All address fields remain editable manually, so no shopper is ever blocked.