Description
Address autocomplete and validation adds real-time address autocomplete and verification to your WooCommerce block checkout, powered by the Smarty address intelligence API.
Features:
- Real-time address suggestions as customers type — US and international
- Automatic form-fill for street, city, state, and postal code on selection
- Address verification at checkout submission — catches typos before the order is placed
- Side-by-side correction UI when a standardized address is available
- Prompts for a missing apartment, suite, or unit number when one is expected
- Address autocomplete on admin order pages when you create or edit an order
- One-click account connection — sign in with Smarty and pick a key, no copy-and-paste
- Automatically detects which Smarty services your account is subscribed to
- Supports US territories with ZIP+4 postal codes (Guam, Palau, American Samoa, and more)
- Works with both shipping and billing address fields
- Styled to match your theme — no layout conflicts
Requirements:
- WooCommerce block checkout (the classic shortcode checkout is not supported)
- A Smarty account with at least one embedded key — sign up for free at smarty.com
External Services
This plugin connects to the Smarty address-intelligence API to provide address autocomplete and verification. This connection is required for the plugin to function.
Address autocomplete and verification (customer checkout and admin order pages)
As a customer types an address, and when an order is submitted, the address fields (street, secondary/unit, city, state, postal code, and country) are sent to Smarty’s lookup and verification endpoints so they can be suggested and validated:
- us-autocomplete-pro.api.smarty.com
- international-autocomplete.api.smarty.com
- us-street.api.smarty.com
- international-street.api.smarty.com
Account connection (store administrators only)
When a store administrator connects a Smarty account, the plugin uses OAuth and then retrieves the account’s embedded API keys and subscription status from:
- oauth.api.smarty.com
- security.api.smarty.com
- subscription.api.smarty.com
Data is sent only to Smarty. Its use is governed by Smarty’s subscription agreement and privacy policy:
- Subscription Agreement: https://www.smarty.com/legal/subscription-agreement
- Privacy Policy: https://www.smarty.com/legal/privacy-policy
Screenshots
Installation
- In your WordPress admin, go to Plugins Add New and search for “Address autocomplete and validation”.
- Click Install Now, then Activate.
- Go to WooCommerce Settings Integrations Smarty Address Autocomplete and Validation.
- Click Connect with Smarty and sign in to your Smarty account to authorize the connection.
- Back on the settings page, select an embedded key from the dropdown and click Save changes.
- Optionally, use the Active Subscriptions toggles to enable or disable individual Smarty services.
- Make sure your checkout page is using the WooCommerce block checkout.
You don’t need to copy or paste an API key — the plugin loads the embedded keys from your Smarty account for you after you connect. If you don’t have an account, sign up for free.
Prefer to install manually? Use Plugins Add New Upload Plugin to upload the ZIP, or extract the smarty-address-autocomplete-for-woocommerce folder into /wp-content/plugins/.
FAQ
-
Does this work with the classic WooCommerce checkout?
-
No. The plugin is built for the WooCommerce block checkout introduced in WooCommerce 8.3. The classic shortcode-based checkout (
[woocommerce_checkout]) is not supported. -
How do I connect the plugin to my Smarty account?
-
On the settings page, click Connect with Smarty and sign in to authorize the connection. The plugin then loads the embedded keys from your account into a dropdown — just pick one and click Save changes. No copying or pasting of keys is required.
-
I don’t have any embedded keys to select.
-
That means the connected Smarty account has no embedded keys yet. Log in at smarty.com, create an embedded key under API Keys, then click Change Key on the settings page to reload the list. Embedded keys are designed for client-side use and can be scoped to your domain, so make sure the key is authorized for your store’s domain.
-
What are the Active Subscriptions toggles?
-
After you connect, the plugin detects which Smarty services your account is subscribed to (US and international address verification and autocomplete). Subscribed services are enabled by default; toggle any off if you don’t want to use them. Services you’re not subscribed to are shown but can’t be enabled.
-
What happens if my connection expires?
-
If your saved authorization expires or is revoked, the plugin shows a notice with a Reconnect now link. Click it, then click Connect with Smarty again to restore the connection.
-
Does autocomplete work for international addresses?
-
Yes. When a customer selects a non-US country, the plugin automatically switches to the Smarty international autocomplete API. Supported countries are listed in the Smarty documentation.
-
Does address verification work internationally?
-
Yes. Verification is supported for countries covered by the Smarty international street address API. For unsupported countries, verification is skipped and checkout proceeds normally.
-
Will this slow down my checkout?
-
Autocomplete suggestions are fetched asynchronously with a 200ms debounce, so they don’t block typing. Verification happens only when the customer clicks Place Order and adds less than one second in most cases.
-
What happens if the Smarty API is unreachable?
-
Autocomplete silently skips suggestions. Verification fails open — if the API call errors, the checkout proceeds without verification so customers are never blocked by an outage.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Address autocomplete and validation” is open source software. The following people have contributed to this plugin.
Contributors
Translate “Address autocomplete and validation” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0.0
- Initial release.
- Real-time US and international address autocomplete on the block checkout.
- Address verification with correction UI at order submission.
- Missing apartment/suite/unit prompt at checkout.
- Address autocomplete on admin order pages.
- One-click Smarty account connection with embedded key selection.
- Automatic detection of subscribed Smarty services.
- ZIP+4 postal code support for US territories.