Guides01 July 2026

How to add email and phone verification lite to BigCommerce

Email verification lite and phone verification lite are available on all active Addressfinder plans, including during your trial.

This guide covers how to enable email and phone verification lite in your BigCommerce store.

Before you start, you'll need:

An Addressfinder account (active plan or active trial)
Your Addressfinder licence key (find it under Credentials in the Addressfinder Portal)
Access to your BigCommerce admin dashboard
Your domain registered in the portal

If you're already using Addressfinder on BigCommerce this snippet replaces your existing configuration. Copy your current settings from the BigCommerce admin before proceeding so you can carry them across.

Steps to integrate

Open your BigCommerce admin dashboard and go to Settings > Advanced > Data solutions.
Select Site Verification Tags and click Connect.
Copy the code snippet below and paste it into the input field, or add the email and phone configuration below your existing address config as shown below.
Replace your_licence_key with your Addressfinder licence key.
Set defaultCountryCode in pvWidgetOptions to your primary market (AU or NZ).
Click Connect to save.

Not using this for Australia Post checkout? Update allowedCountryCodes and nonMobile to suit your markets, see the note below the snippet.

For advanced configuration options, see the email verification widget options and phone verification widget options docs.

Code snippet

The following snippet is pre-configured with our recommended settings for meeting Australia Post's contact detail requirements.

Replace your_licence_key with your Addressfinder licence key before going live.

<script>
(function(d, w) {
    w.AddressFinderConfig = {
        key: "your_licence_key", // Replace this with your licence key
        addressWidgetEnabled: true,
        emailWidgetEnabled: true, // Change this to false to turn off Email Verification
        phoneWidgetEnabled: true, // Change this to false to turn off Phone Verification
        auWidgetOptions: {
            address_params: {
                source: "gnaf,paf",
                post_box: "0" // Delete this line to allow Australian PO Boxes
            }
        },
        nzWidgetOptions: {
            address_params: {
                delivered: "1",
                post_box: "0" // Delete this line to allow New Zealand PO Boxes
            }
        },
        evWidgetOptions: {
            check: "format",   // USES THE LITE VERIFICATION CHECK
            rules: {
                unverified: {
                    rule: "warn",
                    message: "Please check and correct your email address."
                }
            }
        },
        pvWidgetOptions: {
            defaultCountryCode: "AU",
            allowedCountryCodes: "AU", // remove or update to support other countries, e.g. "AU, NZ"
            verifyFormatOnly: true,  // USES THE LITE VERIFICATION CHECK
            timeout: "1",
            rules: {
                unverified: {
                    rule: "warn",
                    message: "Please enter a valid Australian mobile phone number."
                },
                countryNotAllowed: {
                    rule: "warn",
                    message: "Please enter a valid Australian mobile phone number."
                },
                nonMobile: {
                    rule: "block",
                    message: "Please enter a valid Australian mobile phone number."
                }
            }
        }
    };
    w.addEventListener("DOMContentLoaded", function() {
        var s = d.createElement("script");
        s.src = "https://api.addressfinder.io/assets/bigcommerce/v2/boot.js";
        s.async = 1;
        d.body.appendChild(s);
    });
})(document, window);
</script>

The key setting is check: "format" in evWidgetOptions for email verification lite and verifyFormatOnly: true in pvWidgetOptions for phone verification lite. Both run format validation only, which is free on all active plans. Removing either param reverts to standard verification, consuming a lookup from your plan.

Email verification lite only evaluates format and syntax. Rules based on domain or account-level checks such as disposable, role and public addresses aren't available in lite mode. These become available when using the full email verification service.

Serving other markets?

Update defaultCountryCode to your primary market and adjust allowedCountryCodes to include the countries you accept (comma-separated ISO2 codes, e.g. "AU, NZ"). Change nonMobile to warn or allow if you want to accept landlines as well as mobiles.

Switching from full email or phone verification to lite

Add check: "format" to your existing evWidgetOptions config and verifyFormatOnly: true to your pvWidgetOptions config.

Removing check: "format" reverts to standard email verification, which is a charged service.

For more information on full services, read the BigCommerce docs.

Start verifying data in minutes

30-day free trial. No credit card required. Cancel anytime.

Start free trial Talk to us