Form Handlers Overview

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 training materials.

Use these articles to get up and running with Pardot’s form handlers:
Creating Form Handlers
Mapping Fields in Form Handlers
Integrating Form Handlers with Your Forms
Form Handlers: Advanced Topics
Form Handlers Troubleshooting

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, make the field required on your form, otherwise the form submission will fail if a prospect leaves the field blank.
  • If a prospect does not complete a required form field (or if that form field fails validation: for example, by entering text into a “numbers” form field), the prospect will be redirected to the Error Location with some messaging appended as parameters to the Error Location URL. Those parameters can then be read, either by a server side process or by JavaScript, to then be used to display some error messaging to the prospect. We suggest editing your form fields’ error messages to include details that will identify the field(s) producing 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 will not work because the “http://” is missing. Also, posting to will not work because the URL isn’t encoded properly. Posting to would work.