# Installing Address Validation for WooCommerce

Add address validation to your WooCommerce store to improve checkout completion rates and ensure accurate shipping information. This guide walks you through signing up for a free trial, installing the plugin, configuring it, and exploring advanced settings.

## Overview[​](#overview "Direct link to Overview")

Use Address Lookup to enhance your WooCommerce checkout experience. For more details on capabilities and setup, see our [Address Lookup guide](/docs/address-lookup.md).

## Screenshots[​](#screenshots "Direct link to Screenshots")

### Address Lookup[​](#address-lookup "Direct link to Address Lookup")

![Add Address Lookup to your checkout address forms-screenshot](/assets/images/woocommerce-al-checkout-929cbca6913afef807e24f274aa006a8.png)

![Add Address Lookup to your order page-screenshot](/assets/images/woocommerce-al-orders-800865f0a87744de7e2798f866292d48.png)

***

## Step 1: Sign Up for a Free Trial[​](#step-1-sign-up-for-a-free-trial "Direct link to Step 1: Sign Up for a Free Trial")

To use AddressZen, you'll first need to create an account and get your API key.

1. If you don't have an account [sign up to create a free account](https://account.addresszen.com/users/sign_up).
2. Navigate to the [**KEYS**](https://account.addresszen.com/tokens) section in your account.
3. **Copy your API Key -** you'll need this to complete the setup in WooCommerce. It's a string of characters that begins with the letters `ak_`. On signing up, your first key will have a balance of 200 free lookups for testing.

***

## Step 2: Install the WooCommerce Plugin[​](#step-2-install-the-woocommerce-plugin "Direct link to Step 2: Install the WooCommerce Plugin")

You have two ways to install the AddressZen plugin for WooCommerce: directly through WordPress or manually.

### Method A: Install via WordPress[​](#method-a-install-via-wordpress "Direct link to Method A: Install via WordPress")

This is the simplest method to integrate address validation into your WordPress site.

1. **Log in to your WordPress Admin Dashboard**.
2. Go to **Plugins** > **Add New**.
3. Search for **"AddressZen"** and click **Install Now**.
4. After installation, click **Activate**.

### Method B: Install Manually[​](#method-b-install-manually "Direct link to Method B: Install Manually")

1. **Download the AddressZen WooCommerce plugin** from [GitHub](https://github.com/addresszen/woocommerce/releases) (should be a .zip file) or download the latest version straight from the [WordPress Marketplace](https://wordpress.org/plugins/addresszen/).
2. Unzip the release you downloaded.
3. Log in to your **WordPress Admin Dashboard**.
4. Go to **Plugins** > **Add New** > **Upload Plugin**.
5. Click **Choose File** and select **"AddressZen"** from the file you downloaded.
6. Click **Install Now**, then **Activate**.

> **Developer Note**: If you're familiar with FTP, you can also upload the unzipped plugin folder directly to your `/wp-content/plugins/` directory. This method is useful for servers with file upload limitations or when you need to modify plugin files before activation.

***

## Step 3: Configure the Plugin[​](#step-3-configure-the-plugin "Direct link to Step 3: Configure the Plugin")

Once the plugin is installed, it's time to configure it.

1. In your WordPress Admin, go to **WooCommerce** > **Settings**.
2. Click on the **Integration** tab, and then select **"AddressZen".**
3. Make sure the plugin is activated. The box **Enabled** should be ticked.
4. **Enter your API Key** (the one you copied when signing up) in the designated field. You can always find the API Key under KEYS in your AddressZen account.

tip

Give the key a specific name, so it's clear what it's used for in case you need to create more keys, e.g. shipping address.

API Key Security Settings

For enhanced security and usage control, you can configure additional settings in your AddressZen account:

* **Daily lookup limits**: Prevent excessive usage
* **URL restrictions**: Limit where your key can be used
* **IP whitelisting**: Restrict usage to specific IP addresses

Learn more in our [API Key Settings documentation](/docs/guides/api-key-settings.md).

5. Enable Address Lookup by ticking the checkbox. If you are unsure about the best setup, read our [Address Lookup guide](/docs/address-lookup.md).
6. Click **Save Changes**.

![Configuring settings-screenshot](/assets/images/woocommerce-settings-c247923f6b3afb4f383d891e77490293.png)

***

## Advanced Configuration Options[​](#advanced-configuration-options "Direct link to Advanced Configuration Options")

### Optional Settings[​](#optional-settings "Direct link to Optional Settings")

The following settings are optional and can be adjusted to suit your specific requirements.

![Configuring advanced settings-screenshot](/assets/images/woocommerce-advanced-15d8c03e662d0fbc763ffad80ec9887d.png)

Make any necessary changes, and don't forget to **Save**.

For developers who need additional control over the plugin's behavior, advanced JSON configuration options are available.

| Setting                                         | Description                                            | Format            | Documentation                                  |
| ----------------------------------------------- | ------------------------------------------------------ | ----------------- | ---------------------------------------------- |
| **Address Autocomplete Configuration Override** | JSON configuration to override Address Lookup defaults | Valid JSON object | [Address Lookup docs](/docs/address-lookup.md) |

#### Example Configuration Override[​](#example-configuration-override "Direct link to Example Configuration Override")

```
{

	"defaultCountry": "USA",

	"detectCountry": false,

	"hideToolbar": true

}
```

> **Warning**: Be careful when modifying these settings, as invalid JSON will prevent address validation from functioning correctly. Always validate your JSON using a JSON validator before saving.

***

## Step 4: Test the Integration[​](#step-4-test-the-integration "Direct link to Step 4: Test the Integration")

To make sure the address verification works:

1. Go to your **WooCommerce checkout page**.
2. Begin typing an address in the address field.
3. The AddressZen address lookup tool should automatically suggest addresses as you type.

***

## Elementor Integration[​](#elementor-integration "Direct link to Elementor Integration")

If you're using **Elementor** to design your WooCommerce checkout pages, you can still enable address verification with a few simple steps. This is necessary as Elementor disables the default page actions, which can prevent checkout plugins from functioning correctly. To resolve this issue, follow these steps:

#### Step 1. Add a PHP snippet to your WordPress Site[​](#step-1-add-a-php-snippet-to-your-wordpress-site "Direct link to Step 1. Add a PHP snippet to your WordPress Site")

You can do this either by editing your `functions.php` file or by using a PHP snippet plugin. The snippet defines a function that reactivates the WooCommerce-specific checkout hooks.

```
/**

 * Re-invokes certain WooCommerce hooks to activate the AddressZen address verification plugin on checkout.

 * Requires the shortcode "[do_woocommerce_hooks]" to be added to the checkout page.

 */

add_shortcode("do_woocommerce_hooks", function () {

	// Loads JavaScript and CSS assets

	do_action("woocommerce_before_checkout_form");

	// Injects credentials and initializes above assets

	do_action("woocommerce_before_checkout_form");

});
```

#### Step 2: Add the Shortcode to Your Custom Checkout Page[​](#step-2-add-the-shortcode-to-your-custom-checkout-page "Direct link to Step 2: Add the Shortcode to Your Custom Checkout Page")

On your custom checkout page, include the following shortcode:

```
[do_woocommerce_hooks]
```

This will trigger the function you defined in Step 1, enabling the address verification feature. The AddressZen plugin will automatically activate on any standard WooCommerce checkout fields, so no additional setup is required within Elementor itself.

#### Step 3: Test[​](#step-3-test "Direct link to Step 3: Test")

Test the address fields in Elementor to ensure the lookup tool works correctly. It should automatically suggest addresses as you type.

***

## Troubleshooting[​](#troubleshooting "Direct link to Troubleshooting")

If you encounter any issues during installation or configuration:

* Make sure you’ve correctly entered your API key.
* Check if the plugin is up to date (you can update plugins via the WordPress admin panel).
* Ensure that your theme or page builder (Elementor, etc.) is compatible with WooCommerce and the AddressZen plugin.

info

If you need support, you can reach out to us on our [support page](https://addresszen.com/support).