Form handlers allow you to manage forms yourself and post the data to Pardot. This allows you to completely customize your form’s look and feel and still use Pardot to track the form submissions. If you’re brand-new to form handlers, or just want to brush up on your skills, check out our Forms and Form Handlers eLearning course here.
Important Notes About Form Handlers
- As a best practice, the email address field should always be set to required.
- When using a Pardot form handler you can do a browser-side post (the usual posting method and way to cookie prospects upon the submission) or through a server side post. When doing a server side post you must enable the Kiosk/Data Entry Mode option on the form handler. This will prevent Pardot from tracking your server as the prospect because no tracking cookie is set when Kiosk/Data Entry Mode is enabled. Please note that server side posts with Kiosk/Data Entry mode will record the form handler submission activity on the prospect’s record but will not be tracked by a Pardot cookie.
- If a field is set as required in your form handler, be sure to make sure prospects always enter it, otherwise the form submission will fail.
- If a prospect does not complete a required form field (or if that form field fails validation: e.g., by entering text into a “numbers” form field), the form handler will display the error message specified at the form field level in a separate lightbox. We therefore suggest editing your form field‘s error message to include details about the error.
- Pardot can auto-fill Country and State on a prospect record based on GeoIP information. The added data is filled in after a form, landing page, or form handler completion by a prospect.
- Pardot form handlers can only be integrated with forms using an empty enctype attribute or an enctype of application/x-www-form-urlencoded. We cannot accept an enctype of multipart/form-data.
- If a form handler is deleted (sent to the Recycle Bin) and a prospect attempts to submit a form integrated with it, they will see the following message: “This form has been deactivated and is no longer accepting submissions. Please contact the website administrator if you believe this to be an error.” If you are deleting form handlers in Pardot, you will also want to delete or update the forms on your site so they are no longer integrated with the handlers.
- If there is a typo in the form handler URL used for your form’s post location and a prospect attempts to submit the form, they will see the following message: “This link is mis-configured. Please contact your site administrator to have it fixed.”
- Form handlers will also accept “success_location” and “error_location” as URL parameters on POST, which will override any of the form handler’s stored success or error location settings. This does not overwrite values already recorded in Pardot, they are temporary parameters that only apply to that specific post request. The parameters must be completely encoded and valid URLs, otherwise the form handler will default to the selected “Success” and “Error” locations in your Pardot form handler’s set up. For example: posting to http://go.pardot.com/l/1/
2007-06-27/101?success_ location=www.google.com will not work because the “http://” is missing. Also, posting to http://go.pardot.com/l/1/2007- 06-27/101?success_location= http://www.google.com will not work because the URL isn’t encoded properly. Posting to http://go.pardot.com/l/1/ 2007-06-27/101?success_ location=http%3A%2F%2Fwww. google.com would work.