Gravity Forms Zip Code Validation: A Step By Step Guide

Learn how to use conditional logic to validate a customer’s postal code before they submit their order.

This article requires the GP Populate Anything perk.

Buy Gravity Perks to get this perk plus 47 other premium Gravity Forms plugins!

View Plugin Buy Gravity Perks

If you own a business that has a limited service area, it’s important to limit online orders to that service area. Otherwise, you have to check the delivery address for every order and will likely have to cancel orders that are placed outside of that service area. This leads to more work for you and customer disappointment.

Save yourself the potential headaches with a simple Gravity Forms zip code validation process — allowing you to check a customer’s zip code directly on the order form and prevent form submissions if they fall outside your service area.

In this tutorial, we’re going to show you how to use Gravity Forms to create a simple database of zip codes and validate against that database and populate data from that database into your forms.

gravity forms zip code validation

Getting Started

In order to have a list of zip codes to validate against, we first need to store them somewhere in the WordPress database. We’ll then use Populate Anything to retrieve that list of zip codes and validate against it. While there are lots of ways to create a database in WordPress, our preferred method is to use Gravity Forms, of course! 🧙‍♂️

Gravity Forms Zip Code Validation Steps

  1. Create Input Form and Submit Entries
  2. Add Zip Code Fields to Customer Form
  3. Add Validation Messages
  4. Set up Conditional Logic on Submit Button

Step 1 – Create Input Form and Submit Entries

We’re going to create a form specifically to submit entries with zip codes. You might have seen a similar method before in our Using Gravity Forms as a Simple Database article.

Only have a few codes to validate against? Check out our is in operator approach instead.

Start by adding a Single Line Text field to your input form. Name it “Zip Code” or “Postal Code,” and start submitting entries. Enter a single zip code per entry.

submit zip code entries for validation using Gravity Forms

Once you have entered all of the valid zip codes, you are done with the input form. If you decide in the future to adjust your service area, you can add new entries or delete old ones. Here’s an example of our service area.

an example of a service area including zip codes for validation

Step 2 – Add Zip Code Fields to Customer Form

With the database done, it’s time to add the zip code validation fields to our customer-facing form. Start by adding two Single Line Text fields to your form. Call the first one “Zip Code” and the second “Is Zip Code Valid?”

The “Is Zip Code Valid?” field is going to use Populate Anything to check if the entered zip code is stored in the database from the input form we built in Step 1. To do this, first, check Populate value dynamically and set the population type to “Gravity Forms Entry.” Then, select your input form.

using populate anything to dynamically populate zip code entries

Next, we’ll need to set the Filters so that the “Zip Code” field value entered in this form matches the zip codes stored in the database.

filter your form to ensure zip code values match

Instead of selecting a field value in the Value Templates, we’re going to insert the {count} merge tag. This will count the number of values that match our filtering, which we will use for Conditional Logic. To do this, first select Custom Value from the drop down, then insert the merge tag.

inserting the count merge tag for use with conditional logic in gravity forms

Lastly, set this field’s Visibility to Hidden. Your customers don’t need to see this field on the form.

set a field's visibility to hidden in gravity forms

In this example, we’re using a Single Line Text field for the zip code, but this method would also work with Address fields and some adjustments to the Conditional Logic.

Step 3 – Add Validation Messages

With the population sorted, the next step is to add validation messages. We’re going to add two for our form, one for success and one for failure. I like to end on a high note, so we’ll start with the failure message. 😁

Zip Code Validation Failure Message

Add an HTML field to your form and insert your message for when the user’s zip code falls outside your delivery area. I like to style mine a bit, so there’s some additional CSS included.

create a gravity forms zip code failure message

Enable Gravity Forms Conditional Logic on this field and use the following settings to only show it when the zip code doesn’t exist in our database.

enable conditional logic on a gravity forms zip code validation form

The conditional logic we’re using checks to see if the user has submitted a zip code into the “Zip Code” field and then checks the “Is Zip Code Valid?” field for any value outside of 0. Since we’re using the {count} merge tag in the Value Template, it will return 0 if the zip code doesn’t exist in the database, and 1 of it does.

Zip Code Validation Success Message

The success message is set up similarly to the failure message, but with slightly different conditional logic. Below is my success message HTML.

create a success message after validating zip codes

And here you can see the conditional logic settings.

conditional logic settings for a zip code validation form

As you can see, the “Zip Code” field logic is identical, but this time we’re checking the “Is Zip Code Valid” field for values greater than 0. {count} will return 1 when the zip code exists in the database, so using greater than has the advantage of still triggering the conditional logic even if you accidentally enter the zip code more than once when building your database.

Step 3 – Set up Conditional Logic on Submit Button

The last step is to set up conditional logic on the Submit button. This will hide the Submit button when the entered zip code isn’t valid, preventing the customer from placing an order that we can’t fulfill.

The conditional logic rules match our success validation message exactly. We’ll show the button when there is an entered zip code and that zip code is found in the database.

set up a conditional logic on submit button in gravity forms

Ready For Orders

With everything in place, our form is ready to take orders. When someone enters their zip code, the database checks to see if their zip code is within our delivery area. If it is, we show them a message and display the submit button; if not, they see a failure message and the submit button is hidden.

an example of zip code validation in gravity forms

An Alternate Approach

The Populate Anything approach is perfect when you have many zip codes, but if your service area only includes a handful of postal codes, you may find our “is In” conditional logic operator to be an easier option. We wrote a snippet that adds the operator to conditional logic for any field that supports it.

Once installed, using the operator is easy. In the success message conditional logic, select the “is in” operator and insert your zip codes as a comma-delimited list.

using conditional logic to validate zip codes

For the failure message, you’ll need to add multiple conditions to show the message if the zip code doesn’t match.

using conditional logic and a failure message for zip codes

You’re good to go. Have questions? Reply in the comments or shoot us a message!

More on Gravity Forms Validation

Gravity Forms Email Validation — learn how to check an email live as a form is being filled out, without having to hit submit.

Gravity Forms for Age-Verification — how to set up age-based validation (often used for products like Alcohol).

Gravity Forms Advanced Phone Field — A Gravity Forms add-on for validating phone numbers in real time, detecting country codes automatically, improving up your Phone field with modern visuals.

Make Your Gravity Forms Validation Errors Mobile Friendly(er) — improve Gravity Forms validation errors for mobile users by automatically focusing on the first field with a validation error.

Require an Existing Value for Submission with Gravity Forms — ensure that a value entered in Form B has been previously submitted (or generated) on Form A. 

Comments

  1. Peter
    Peter January 10, 2024 at 4:15 pm

    Awesome tutorial thanks! There’s one little tweak that I think helps. On the conditional formatting for the validation messages, I added an additional condition of: Zip Code – Greater Than – 5 This way the message doesn’t show until someone has entered all 5 digits of the zip code. I found without it the validation message was showing prematurely that there was no match.

    Cheers.

    Reply
    1. David Smith
      David Smith Staff January 10, 2024 at 10:38 pm

      I couldn’t quite get that to work, Peter. Well, it works for the success message but the failure message never shows. Got a screenshot of your exact settings?

  2. Jesper
    Jesper November 27, 2023 at 5:40 am

    This tutorial looks fantastic! I have one Question before I start making changes to my forms.

    Is there a way to setup different Shipping cost depending on Zip Code, using this Guide?

    Reply
    1. Dario
      Dario November 27, 2023 at 12:16 pm

      Hi Jesper, we’ve already followed via email. The closest we have is this snippet. A simple method for using a Calculated Product field (or User Defined Price field) as a shipping field.

    1. Samuel Bassah
      Samuel Bassah Staff September 27, 2023 at 8:54 am

      Hi,

      Only the GP Populate Anything Perk is required for this setup, so the Basic license should be enough.

      Best,

  3. Malcolm Taite
    Malcolm Taite June 7, 2023 at 11:48 am

    Hi, Great tutorial!

    Would this work if I had a very large list of zip codes? For example 20,000?

    Thanks

    Reply
    1. Dario
      Dario June 7, 2023 at 11:56 am

      Hi Malcolm, yes, it should work for a list of 20,000 zip codes 🔎.

      Here if you have any questions.

    1. Samuel Bassah
      Samuel Bassah Staff April 20, 2023 at 3:31 pm

      Hi Anjon,

      We currently do not have a snippet for “not in” condition. If you have an active Pro license, you can contact us via our support form and submit a snippet request for this.

      Best,

  4. Jennifer Strumbel
    Jennifer Strumbel April 12, 2023 at 5:30 pm

    Is it possible to have multiple success messages?

    For example: Based on the zip code or zip code range, the success message would display different information. Only need one failure message but the success message would differ based on the zip code.

    Reply
    1. Samuel Bassah
      Samuel Bassah Staff April 13, 2023 at 9:51 am

      Hi Jennifer,

      Since the text of the success message is within an HTML field, you can use multiple HTML Fields and set up the conditional logic them to show each based on specific zip codes.
      I hope this helps.

      Best,

  5. BOUCHAIR
    BOUCHAIR November 16, 2022 at 1:42 pm

    Hello I need to check if the entered zip code begin as a zip code stored in database Example : We store in database : 44,55,60,72,… as zip codes

    Now I want to validate 44100, will this works ?

    Thank you

    Reply
    1. Dario Space
      Dario Space November 16, 2022 at 1:54 pm

      Hi,

      Not exactly, because this tutorial populates from a Gravity Forms Entry. If you have the values saved on a Database table you will need to tweak it a bit for Populate Anything to populate the data from the Database instead. If you have an active Gravity Perks License, you can get in touch with us via our support form so can dig into this.

      Best,

    2. BOUCHAIR
      BOUCHAIR November 17, 2022 at 3:57 pm

      Hello, Thank you for your reply, you haven’t understand me The data is populated via the Gravity form plugin, but i don’t add all the zip code (5 digits) but only the 2 first digits. When a customer try to valid a zip code (5 digits), the system must check if it begins by the good digits.

      Example: 44 added via gravity form and want to be able to validate 44100 Good (begins with 44), 95000 Not good (not begins with 44)

      If this is Ok, i will take a license.

  6. Ruslan
    Ruslan July 17, 2022 at 2:52 pm

    I am stuck on the first step. It says … and start submitting entries… where should I submit the entries?

    “Start by adding a Single Line Text field to your input form. Name it “Zip Code” or “Postal Code,” and start submitting entries. Enter a single zip code per entry.”

    Reply
    1. Samuel Bassah
      Samuel Bassah Staff July 18, 2022 at 8:07 am

      Hi Ruslan,

      You can submit the entries by previewing the form on the backend and completing it one after the other.

      Best,

  7. Marco van Wynbergen
    Marco van Wynbergen June 16, 2022 at 9:50 am

    I was wondering, isn’t the Alternate Approach much faster when you have a big list of zipcodes in stead of filling in every zipcode in single line field? My client has 100 zipcodes for instance. Or am I missing something here?

    Reply
    1. Dario Space
      Dario Space June 16, 2022 at 9:58 am

      Hi Marco,

      Yes and no. With the IS IN operator, you will need to add the values in the Conditional Logic of the form. Evaluating Conditional Logic is much less performant than using Populate Anything.

      I hope this helps!

      Best,

    2. Marco van Wynbergen
      Marco van Wynbergen June 17, 2022 at 7:49 am

      Forget this reply. I see it now. I was hoping to have an easy way to import a lot of zipcodes at once.

      Marco

  8. Veronique Maury
    Veronique Maury May 10, 2022 at 3:19 am

    Excellent tutorial Scott! This give me a lot of idea on how to implement validation on all sorts of fields. Thanks!

    Reply

Leave a Reply

Your email address will not be published. Required fields are marked *

  • Trouble installing this snippet? See our troubleshooting tips.
  • Need to include code? Create a gist and link to it in your comment.
  • Reporting a bug? Provide a URL where this issue can be recreated.

By commenting, I understand that I may receive emails related to Gravity Wiz and can unsubscribe at any time.

Grab a bundle of free Gravity Forms plugins

Enter your email and receive our most popular free plugins and snippets, plus access to hundreds of others.

This field is for validation purposes and should be left unchanged.