The AddressFinder plugin for Shopify adds an autocomplete capability to the billing and shipping address fields for New Zealand and Australian Shopify Stores.
- Get verified addresses – No more mistakes. Save addresses straight from your webform to your database.
- Access the latest addresses – Access addresses frequently refreshed from multiple sources.
- No software required – AddressFinder is a JavaScript widget and API. This plugin requires ZERO programming experience.
Register for a free AddressFinder account at one of these links:
Existing users can obtain their API key from the AddressFinder Portal.
Read more on the AddressFinder Shopify Plugin page.
AddressFinder-Shopify provides support for the same browsers that Shopify support. See the list of Shopify supported browsers.
Presently, this includes the latest two versions of all browsers: Google Chrome, Mozilla Firefox, Apple Safari, Microsoft Edge, Opera, Apple Safari for iOS and Google Chrome for Android.
If you already have Google Analytics installed, please start at Step 4.
- Log into the admin panel for your Shopify site, and navigate to Online Store -> Preferences.
- Scroll down to the Google Analytics section. To complete this section you must have a Google Analytics account. If you do not have one, please read the following article: https://help.shopify.com/manual/reports-and-analytics/google-analytics. You will need to enter your Google Analytics Tracking Code(this will be in the format: "UA-XXXXXXXX-XX")
- Click Save
- Reopen your Shopify Online Store Preferences and go to the Google Analytics section. Your Tracking Code should appear here.
- Copy the following script into the "Additional Google Analytics Javascript" textbox that is displayed. However if there is already text present in this textbox, then append the following text:
(function(d,w){
w.AddressFinderPlugin = {
key: "ADDRESSFINDER_DEMO_KEY"
};
var s = d.createElement("script");
s.src = "https://api.addressfinder.io/assets/shopify/v1/boot.js";
s.async = 1;
d.body.appendChild(s);
})(document, window);
- Tick the "Use Enhanced Ecommerce" checkbox at the bottom of the Google Analytics section.
- Replace the
ADDRESSFINDER_DEMO_KEYplaceholder in the snippet you added in step 5 with your own AddressFinder key
You can add advanced options by adding key-value pairs to AddressFinderPlugin, inside a 'widgetOptions' object. For example, to hide the addressfinder byline:
w.AddressFinderPlugin = {
key: "ADDRESSFINDER_DEMO_KEY",
widgetOptions: {
byline: false
}
};
For a full list of possible options visit our Widget Documentation
If you need to add different options for each country you can enter them in objects with the keys 'nzWidgetOptions' and 'auWidgetOptions'.
w.AddressFinderPlugin = {
key: "ADDRESSFINDER_DEMO_KEY",
nzWidgetOptions: {
byline: false
},
auWidgetOptions: {
byline: true
}
};
For the full list of NZ specific options For the full list of AU specific options
New users can register for a free AddressFinder account at one of these links:
Existing users can obtain their API key from the AddressFinder Portal.
Here in New Zealand we have different rules and regulations when it comes to the way we set out our addresses. In order to capture all of the correct address information we suggest you make a couple of adjustments to the billing/shipping page layout. These adjustments are 1) inclusion of the 'Address Line 2' field and 2) renaming of the 'Address line 2' and 'City' fields.
- Go into your Shopify settings>Checkout and scroll down to Form Options. (https://addressfinder.myshopify.com/admin/settings/checkout) As per below, make 'Address line 2 (apartment,unit etc)' Optional. You may want to make 'Company Name' and 'Phone Number' optional also. Then Save.
-
Remain in the Shopify Settings>Checkout page and scroll down further to the 'Checkout Language' section.
Click on 'Manage Checkout Language'.
Scroll all the way down to 'Checkout Contact' and then further to the 'Optional address2 label' field. Populate this with "Address 2 (optional)". Also populate the 'City Label' field with "Town/City". Then Save.
Depending on your theme your shipping page should look something like this...
Here in Australia, we have different rules and regulations when it comes to the way we set out our addresses. In order to capture all of the correct address information we suggest you make a couple of adjustments to the billing/shipping page layout. These adjustments are 1) inclusion of the 'Address Line 2' field and 2) renaming of the 'Address line 2' and 'City' fields.
- Go into your Shopify settings>Checkout and scroll down to Form Options. (https://addressfinder.myshopify.com/admin/settings/checkout) As per below, make 'Address line 2 (apartment,unit etc)' Optional. You may want to make 'Company Name' and 'Phone Number' optional also. Then Save.
-
Remain in the Shopify Settings>Checkout page and scroll down further to the 'Checkout Language' section.
Click on 'Manage Checkout Language'.
Scroll all the way down to 'Checkout Contact' and then further to the 'Optional address2 label' field. Populate this with "Address 2 (optional)". Also populate the 'City Label' field with "Suburb/Locality". Then save.
Depending on your theme, your checkout page should look something like this...
The AddressFinder plugin for Shopify is released under the permissive free software MIT License.
See BUILD.md for instructions on how to build this plugin from source.