Skip to main content

Forms Troubleshooting

Use this guide to identify error messages, resolve display issues, and correct setup problems so your Forms function correctly.

Cristina Gruita avatar
Written by Cristina Gruita
Updated this week

Error Message Appears When Viewing a Form

When an error appears on a Form, check the number shown in the bottom-right corner of the screen. This is the error code that indicates the cause.
​

Form Error (1) Example

Error Code (1): IP Address Is Blocked

  1. Wait 10–15 minutes, then reload the Form if the page may have been requested too many times in quick succession.

  2. Go to Forms, then click Security to check whether the requesting IP address is listed as blocked.

  3. Delete the blocked IP address entry to unblock the request.

  4. Add the IP address to the Allowed list in the Security tab to prevent future blocking.

⚠️Important:Permanently blocked IPs must be removed manually before the form can load again.


Error Code (2): Form Cannot Be Found

  1. Check that the Form URL is correct, then retry loading the page.

  2. Open Forms, then check the list to confirm the Form still exists.

  3. Recreate and publish the Form if it has been deleted, then update any pages to use the new Form URL.

πŸ“Œ Note: Deleted Forms cannot be restored, and old URLs no longer work.


Error Code (3): Form Is Not Active

  1. Go to Forms, then click Manage Forms.

  2. Open the Form from the list, then set it to Active.

A Form must be active before it can be viewed online.


For Other Error Messages

Refer to the article:: Form Error Messages.


My Form Does Not Seem to Be Working Properly

  1. Open the affected Form Content element, then click Source.

  2. Review the raw HTML and remove any <form> or </form> tags.

πŸ“ŒNote: These tags are often unintentionally copied from websites and can break form functionality.


Card Details Box Is Not Displaying Correctly

  1. Open the Donation element of the Form, then go to the Display tab.

  2. Tick a default payment option to restore the card details fields.


My Purposes Are Not Displayed on the Form

  1. Go to Settings, then click Configuration.

  2. Select Purposes.

  3. Open the relevant Purpose and toggle Include on Preference Update Form to Yes.

  4. Add a description to make the Purpose visible on Preference Update Forms and Form communication options.


My Form Has Scroll Bars

  1. Open the webpage where the Form is embedded in an iframe.

  2. Increase the height value of the iframe to prevent vertical scrolling.

Example:
Change
​height:1050px;
to something larger such as
​height:1500px;

πŸ“ŒNote: You may need to experiment with different height values.


There Is Too Much White Space at the Bottom of the Form

  1. Edit the height value in your iframe code snippet to reduce unused space.

Example:
Original:
​<iframe style="width: 100%; height:1050px;" ...>
Updated:
​<iframe style="width: 100%; height:850px;" ...>


People Must Scroll Up to See the Submitted Form Message

  1. Copy the script below directly below the iframe line in your webpage’s HTML.

  2. Save and publish your changes.

This script scrolls the page to the top when the form is submitted:

<script type="application/javascript">
var eventMethod = window.addEventListener ? "addEventListener" : "attachEvent";
var eventer = window[eventMethod];
var messageEvent = eventMethod == "attachEvent" ? "onmessage" : "message";
eventer(messageEvent,function(e) {
var key = e.message ? "message" : "data";
var data = e[key];
if (data === 'DonorfyFormCompletedMsg')
{
window.scroll(0,0);
}
},false);
</script>
Did this answer your question?