Guides01 July 2026
How to add email and phone verification lite to your widget
Email verification lite and phone verification lite are now available on all paid Addressfinder plans, including during your trial.
This guide covers how to add lite services to your website using the Addressfinder widget.
Both services validate format and syntax at point of capture, checking that an email or phone number is correctly structured before it enters your system. They run instantly and are free to use. If you need deeper checks (domain, connection, or live number verification), you can upgrade to the full services at any time.
Integrating a different way? See our API docs or plugin guides.
What's in the guide
Before you start you'll need:
- An Addressfinder account (active plan or trial)
- Access to the HTML of the page or form you want to update
- Your Addressfinder licence key (find it under Credentials in the Addressfinder Portal)
- Your domain registered in the portal
Steps to integrate
- Copy and paste the code snippet into the HTML of your page, immediately before the closing </body> tag or directly below your Addressfinder address widget code if using.
- Replace your_licence_key with your Addressfinder licence key.
- Update addressSelector to match the ID of your email field (e.g. #email).
- Update phoneSelector to match the ID of your phone field (e.g. #phone).
- Replace your_licence_key in the phone snippet with the same Addressfinder licence key.
- Set defaultCountryCode to the ISO2 code for your primary market (AU, NZ etc).
- Add the URL of your website (e.g. https://yourwebsite.com) to the domains page in the Addressfinder Portal.
- Test the integration by entering different values into each field. Check the inline feedback and adjust the rules if needed.
If using only email or phone, simply remove the unneeded section from the snippet.
For advanced configuration options, see the email verification widget options and phone verification widget options docs.
If you don't have an Addressfinder account, sign up for a free trial.
Code snippet
The following snippet is pre-configured with our recommended settings for meeting Australia Post's checkout requirements, restricting phone numbers to valid Australian mobiles. If you serve other markets, see the note below the snippet for how to adjust this.
Copy and paste the following code into your page HTML, immediately before the closing </body> tag or directly below your Addressfinder address widget code if using.
<!-- Email Verification Lite -->
<script>
(function (d) {
var conf = {
addressSelector: '#your_email_field_id',
licenceKey: "your_licence_key",
check: "format",
rules: {
unverified: {
rule: "warn",
message: "Please check and correct your email address."
}
},
};
d.addEventListener("DOMContentLoaded",function(){if(d.querySelector(conf.addressSelector)){var e=d.createElement("script");e.src="https://api.addressfinder.io/assets/email/v2/widget.js",e.async=!0,e.onload=function(){new AddressfinderEmail.Email.Widget(conf.addressSelector, conf.licenceKey, conf)},d.body.appendChild(e)}});
})(document);
</script>
<!-- Phone Verification Lite -->
<script>
(function (d) {
var conf = {
phoneSelector: '#your_phone_field_id',
licenceKey: 'your_licence_key',
defaultCountryCode: 'AU',
allowedCountryCodes: "AU", // remove or update to support other countries, e.g. "AU, NZ"
verifyFormatOnly: true,
rules: {
unverified: {
rule: 'warn',
message: 'Please enter a valid Australian mobile phone number.',
},
nonMobile: {
rule: 'block',
message: 'Please enter a valid Australian mobile phone number.',
},
countryNotAllowed: {
rule: 'block',
message: 'Please enter a valid Australian mobile phone number.',
},
},
};
d.addEventListener("DOMContentLoaded",function(){if(d.querySelector(conf.phoneSelector)){var e=d.createElement("script");e.src="https://api.addressfinder.io/assets/phone/v2/widget.js",e.async=!0,e.onload=function(){new AddressfinderPhone.Phone.Widget(conf.phoneSelector, conf.licenceKey, conf)},d.body.appendChild(e)}});
})(document);
</script>
For email verification lite, the key setting is check: "format". This tells the widget to run format validation only, which is free on all paid plans. If check is set to domain or connection, the widget will perform standard email verification, consuming a lookup from your plan.
Lite only evaluates email format and syntax, so rules based on domain or account-level checks, such as disposable, role and public addresses, aren't available and will have no effect if added. These become available when using the full email verification service.
For phone verification lite, the key setting is verifyFormatOnly: true. The snippet above defaults to Australian mobile numbers only, set via allowedCountryCodes: "AU" and nonMobile: "block". If verifyFormatOnly is removed or set to false, the widget will perform standard phone verification, consuming a lookup from your plan.
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.
About the recommended configuration
The code examples above default to strict settings for Australian mobile numbers, in line with Australia Post's checkout requirements. For most other integrations we recommend warn rather than block.
- block prevents a user from submitting the form if their input triggers a rule. For most checkout and data capture flows, that is a higher cost than receiving an imperfect contact detail. A blocked sale is worse than a slightly messy email list. warn shows the user a message and lets them proceed.
- If you don't need to enforce Australian mobile numbers specifically, change nonMobile and countryNotAllowed to warn, and update allowedCountryCodes to suit your markets.
You can adjust all rules to suit your needs. See email verification widget options and phone verification widget options for the full list.
Switching from full email or phone verification to lite
If you are already using our standard email verification or phone verification services, switching to lite is a single param change:
- Email Verification: add check: "format" to your existing config
- Phone Verification: add verifyFormatOnly: true to your existing config
Important: removing these params, or misconfiguring them, will revert to our standard full verification, which is a charged service. If you notice verification responses taking longer than usual (over half a second), check that the lite param is set correctly before going live.
The full checkout solution
With address autocomplete alongside email and phone verification, your customers get a faster, more accurate checkout experience. Be ready for the 4,000+ Parcel Locker addresses coming to our Australia Post PAF dataset in August, allowing your customers to choose a delivery option that suits them.
Set up address autocomplete using Addressfinder widget code generator.
FAQs
Does lite work during a free trial?
Yes. Email Verification Lite and Phone Verification Lite are available on all paid plans and active trials.
Can I use lite for bulk verification?
No. Lite is available for widget and API integrations only. Bulk verification uses the full services. See bulk verification for details.
Why are some metadata fields returning null?
The lite services are perform format-only verification, fields that require a deeper check (domain status, connection status, line type, line status) return null. This is expected. If your integration is built to expect true or false for these fields, update your code to handle null before going live.
If you have any questions, get in touch with our support team.
Start verifying data in minutes
30-day free trial. No credit card required. Cancel anytime.