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.

June 2, 2021: Migrated snippet to the Snippet Library.

August 27, 2020: Fixed issue where script was output in AJAX requests (e.g. Partial Entries heartbeat ticks).

October 11, 2019: Updated how scrolling to first error worked to be more consistent.

October 4, 2019: Added support for forms with conditional logic enabled.

Want a UI for this?
Our simple plugin will apply this functionality to all forms out of the box. If you’d like a setting to enable this per form, Dennis Hunink has created an alternate plugin that provides support for this. Check it out!

Gravity Forms validation errors are highly visible when you’re browsing the form on your laptop. You see the clear message that there are errors on the page and typically at least one of those validation errors is visible above the fold.

On mobile, it’s a different story. Even for simple forms, the user can end up scrolling quite a bit to find the field with the validation error. At it’s best this can be little confusing. And at it’s worst? It can be downright frustrating.

So what do we do about it?

This snippet will make Gravity Forms’ validation errors just a little more mobile-friendly. Also, while we wrote this snippet to address mobile forms, this functionality will be applied to the from on Desktop browsers as well.

How? This snippet will scroll the page down to the first error and give that input focus. This will allow users to immediately identify that there is a validation error and start them right at the the first field that needs their attention.

gw-mobile-friendly-validation-errorsLeft: Default validation error. Right: Mobile-friendly focus applied to first field w/ error.


Copy and paste the snippet into your theme’s functions.php. That’s it! The functionality will now be applied to all of your forms.

If you’d like to limit this to a specific form, just change the filter from gform_pre_render to gform_pre_render_123, where 123 is your form ID.

Speaking of mobile validation… have you heard of Gravity Forms Advanced Phone Field? This powerhouse perk will validate phone numbers automatically, reducing fake numbers and spam. It also automatically detect each user’s country code, capture phone metadata on submission, and enhance your form’s UX with stylish visuals.

That’s all for now!

Let us know if this was useful to you in the comments below.


    1. Scott Ryer
      Scott Ryer Staff January 22, 2024 at 2:00 pm

      Hi Wayne,

      I can’t seem to replicate this one locally. Let’s dig into this one via support. I’ve sent you an email with more details.

    1. Dario
      Dario August 23, 2023 at 3:20 pm

      Thanks Jannet. I was able to reproduce the issue. I’ll pass this on to our dev team for investigation.

  1. AeroStar
    AeroStar October 20, 2022 at 10:05 am


    (1) Does your code snippet work with Gravity Forms, V2.6.7? (latest version as of today).

    (2) Does your code snippet work when a gravity form is embedded in a modal? We couldn’t get it to work for us.

    (3) In some cases, our gravity form scrolled to the form’s top (main) validation message (not the field error message) and placed it in the middle of our screen. What could be causing this?

    (4) How can we modify your code snippet to account for a sticky menu? We need an offset of, say, 100px.

    Thank you!

    1. Dario Space
      Dario Space October 20, 2022 at 11:05 am

      Hi Aerostar

      The snippet should work with Gravity Forms 2.6.7. It seems they will need some customizations to the snippet about the other questions. If you have an active Gravity Perks license, get in touch with us via the support form.


    1. Scott Ryer
      Scott Ryer Staff May 31, 2022 at 11:44 am

      Hi Tomasz,

      I just tested this on my iPhone, and the form is scrolling to the “Message” field, which is the first field that doesn’t contain any values and is showing a validation error.

      If you’re experiencing a different behavior, can you drop us a line so we can investigate this further?

  2. Jordan Dick
    Jordan Dick November 18, 2021 at 2:38 pm

    This is very useful. It’s astounding that this feature isn’t part of Gravity Forms out of the box. Why wouldn’t it be? The user experience is very poor without this. Thank you for posting this.

    1. Dario Space
      Dario Space May 28, 2021 at 10:33 am

      Hi Martin,

      I’m unable to recreate any issues when I test on GF 2.5. It works as expected.

      If you have a Gravity Perks license, you can get in touch with us via our support form so we can assist you further.


  3. Dale Reardon
    Dale Reardon July 28, 2020 at 10:39 am


    Have just installed and tried this out and it is just amazing!

    I am blind and use a screenreader and often have problems with forms identifying where the problem entry is – this just fixes it perfectly and on desktop as well.

    Such a small changes but it really does make filling out a form so much easier.


    1. Ryan Donovan
      Ryan Donovan July 28, 2020 at 10:41 am

      Hello Dale, thank you so much for the kind words. We are extremely happy to hear that this has made things easier. We hope you have a wonderful day.

  4. Monica
    Monica January 20, 2020 at 10:49 am

    It works quite fine to me but I need to scroll a little bit more. How can I add an offset to adjust the scroll using default pixel starting from first error?

  5. Robert
    Robert November 25, 2019 at 7:39 pm

    Hello. I have a issue whit the plugin on a multi page gravity form.

    When I am on page 2-5 on the form on my iPhone, I get a big white space over the form, and I have to scroll down to find the form.

    Does this plugin support multi page forms?

    1. David Smith
      David Smith Staff August 1, 2019 at 7:49 am

      Hi Will, this is a snippet. You can download it at via the “Download Code” at the top of the article.

    2. Will Gray
      Will Gray August 1, 2019 at 7:55 am

      Hi David

      I added the snippet to my functions PHP file but it just keeps saying

      Your PHP code changes were rolled back due to an error on line 560 of file wp-includes/functions.php

      No idea how to fix it was hoping there was a plugin

      no worries


    3. Will Gray
      Will Gray August 1, 2019 at 8:11 am

      Hi David

      I’ve managed to increase the wordpress memory and added the snippet works on mobile but not on desktop.

      Cheers Will

  6. Carol
    Carol January 28, 2019 at 6:24 am

    Hi there! This isn’t working for me. I am testing this on my desktop. My form is located at the bottom of the page and when I submit the form – with errors – it takes me to the top of the page so I can’t see the error message. Any suggestions?

    1. Carol
      Carol January 30, 2019 at 7:12 am

      Thank you for your response David. I understand your demo is working, however it is the only item on the page and it is a short form, so it is difficult to test whether the script is working in a situation where the form is long and positioned lower on the page.

      I have re-copied the code in my functions.php and tried it again. (I removed the opening <?php because it was already in the file.)

      This functions.php life is located in my child theme.

      I even tested it by adding the code in the theme’s functions.php file and it still isn’t working properly.

      Is it possible for you to test the form on my page to see what I am experiencing — or could you lengthen your demo so that I can see how it will work in my situation?

      I appreciate your help. Thank you very much!

  7. Matt
    Matt June 28, 2018 at 1:39 pm

    Didn’t work for me. :-( Too bad. Maybe it’s not compatible with WP 4.9.6. I’m using a child theme and added the snippet to my child theme functions.php. Tried all the troubleshooting tips, but no go. Thanks anyways.

  8. madhu
    madhu April 12, 2018 at 11:12 am

    Hi, I have tried above code, its working fine in desktop version, but not working in mobiles(ios and android). In mobiles while clicking on the submit(in gravity forms) button, the page is scrolling up, user thinks that form is submitted but not. Any help on this please.

    I am using recaptcha and disabled AJAX

  9. Tony
    Tony April 12, 2018 at 4:20 am

    Hi David,

    Thank you very much for your prompt reply. I did another test going through all fields. All are okay except for the CAPTCHA.

    Do you have an email so that I can send you my details for you to check.

    Thanks Tony

  10. Tony
    Tony April 11, 2018 at 5:13 pm


    It works great. The only issue is when the user does not fill in the CAPTCHA right at the bottom the form scrolls right to the top.

    Is there a way to fix this?

    Thanks Tony

    1. David Smith
      David Smith Staff April 11, 2018 at 9:24 pm

      Hi Tony, I tried to recreate this locally but it worked as expected for me. The form scrolled down to the failed captcha.

  11. Tim
    Tim August 29, 2017 at 12:53 pm

    This is great. Thanks.

    Just wondering if there’s a way to control the page anchor more specifically. On desktop it jumps to below the form itself so might still prove a little confusing.


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.

Download Snippet

Make Your Gravity Forms Validation Errors Mobile-friendly(er)

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