How to use ZipCode Checker App on Wix? - Full Guide
- Dev Vora
- May 11
- 6 min read
1.1 Install ZipCode Checker app from app market. Before adding widgets on the site or product page, it is recommended to set up everything on app dashboard.
1.2 Configure Wix Shipping. Go to Wix Store shipping settings and enable the entire country you ship to. If you have multiple countries, select multiple. But remember to select entire country, not few regions. ZipCode Checker will handle where you want orders from. For that entire country must be enabled. If you have global store with shipping support to all countries, enable rest of the world.

However, you can set different regions of same country in various shipping groups for customizing shipping rates. Just make sure the regions you enabled or disabled here do not conflict with zip codes you upload on the app. Objective here is to prevent mismatch between shipping settings and zip codes list on zipcode checker app.
2.1 Go to app dashboard page for setup. Do not add widgets onto site before setting this up. Download sample csv format to add your zip codes list.

Before adding zip codes to csv file, consider how you will use the list. Include toggle will only allow orders from the zip codes you added in csv. Any other zip codes will be rejected. Exclude toggle will allow orders from all zip codes except for ones you added in csv.

You can add zip codes below the first title row. Remember the first row should remain as it is. Second column is for setting shipping time message. It is optional. The message you want to show to users when they input their zip code. You can set different for each zip code. Any other messages can be also added like local greetings in local language. Third column is for adding notes for your own reference. It will not affect anything else.

For charging additional fees on zip code, check Section 5. Zip code range start and range end optional fields are for easy and fast management of bulk zip codes, detailed in Section 6

You can also create your own csv file. The first row should be same as in sample file. Hit upload button and select your file. It will validate the csv and might take few minutes to complete the process. Alternatively you can directly click Edit in CMS and add zip codes there directly without uploading a file.
Please note if you want to add more than 100K zip codes, you have to upload them using the append method shown in step 5 below. Due to Wix's limit, adding large number of zip codes all at once is not supported. You have to divide the csv and upload them one by one. You can use our csv splitter here to split the large file you made into multiple files. Then upload and append one by one.
2.2 You can manage your zip codes on Wix CMS directly and edit the list on it. On the right side the blue text shows when you uploaded csv the last time. Clicking on it will download that file. The one you uploaded last time. Download CSV of current zip codes button will download the current zip codes in CMS.

2.3 Suppose you want to add more zip codes to list already on CMS, you can prepare another csv file and click upload again. It will prompt you to select between two options. Overwrite and Append. Clicking append will add all these new zip codes in new csv to existing zip codes you have on the CMS. Overwrite will wipe out all the existing zip codes on CMS and replace them with new ones you uploaded.

3.1 Initial setup is done now. The app will prevent orders on Wix Checkout showing customers that shipping is not supported to their zip code. After this you can optional plugin widget on product page as convenience for site visitors to let them check support for their zip code directly on the product page. This also entices them to interact with your website hence increasing chances of converting site visitor into a customer.
Launch site editor and go to product page. Select product page element and click on plugins button.

Here you will see two of our widgets. ZipCode Checker and Collapsible ZipCode Checker. Add any one of them. Its possible to add both too.

You can select the entire element and customize all the default texts you can see by clicking on messages button. Entire element’s design can be changed by going to side inspector panel.


You can also select individual elements like input text box and button to customize their style and layout to match it to overall look of your site.

These plugin widgets can also be placed into six other positions if you don’t want to keep it above the cart button. Select the widget and click three dots to move the plugin.

For sites that follow Right to Left text, we have made preset for it. You can change the widget look to match it. You can find same preset for collapsible plugin widget too.

3.2 We have also made general widget element that can be added anywhere on site as per your needs. Even in lightboxes.

4. To turn off the zip code checking on checkout, or to not prevent users from placing orders, you can simply disable zip code validation checkout. This way the app won't affect checkout validation and you can still use zip code checker widgets. Widgets will just work fine; but it will take orders from any zip code. Note that disabling this will also disable additional fees on checkout.

5. With recent update, there is new feature to add additional pricing for each zip code. This can be useful if you want to charge different shipping rates for different zip codes - more fine control over the regions defined in Wix Shipping settings.
We specifically decided to not give it as shipping fee, so you can use it in conjunction with Wix shipping settings. You can set the fees there or keep free delivery and on top of that charge additional fees on zip codes with our app.
The fees will appear on checkout as below. You can change the additional fee title from its column to any name you like. For example, extra shipping charge, remote destination surcharge, New York local shipping fee..

Just enter the fees you want to charge in additional fees column, without mentioning any currency. It will use primary currency of store automatically. Beyond fixed price, you can also charge the users based on the number of products or total shipping weight of products with formulas. For example, you can write 10, to charge flat 10 cost in your site's currency or write quantity*10 to charge 10 cost per quantity of product / weight*10 to charge 10 cost per unit of weight.

To charge on based of weight, you have to enter shipping weight in particular product listing. Generally shipping companies charge you based on volumetric weight or dead weight whichever is higher. So it is recommended to calculate volumetric weight of entire package beforehand and add it to product listing instead of writing actual product weight. You can write actual product weight in product description.

6. It could get lengthy to add or manage zip codes if your coverage has so many of them. There are two shortcut ways for faster workflow:
6.1 Using Wildcard characters ( in column named Zip codes )
You can use wildcard to match a bunch of zip codes starting with same characters. We support two wildcard characters: * and #
* (asterisk sign) matches any number of characters at the end of the zip code
# (number / pound sign) matches only single character at a time at the end of the zip code
For example,
AB1* will match all zip codes starting with AB1 followed by any number of characters like AB1, AB1AAC, AB1000000 etc.
AB1### will only match zip codes starting with AB1 and total 6 characters in length like AB1000. AB111A, AB1ZZZ etc.
So if any region has same starting characters, you can use * to support all zip codes starting with those characters. No need to enter every single of them. Similarly with # you can define how long zip code should be in contrast to * where it will allow input of any number of characters after first characters

6.2 Using Range ( in columns named Zip codes Range Start and Range End )
If certain region or areas follow sequence then you can add starting and ending range to support all of zip codes in middle.
For example, New York state has many zip codes that are in sequence like 10001 - 10040, you can just add these in range start and range end column. All zip codes in between them will automatically be counted.

Comments