Forms troubleshooting

Forms

There are two types of forms: static and modal.
Static acts as a fallback for when JS is disabled or fails. After submission it should redirect to a static thank you page.
Modal forms remain on the same page and trigger a success banner with the copy “Thank you for contacting our team. We will be in touch shortly.”

Testing forms

It is important that after building a form you check it is being submitted correctly and received in Marketo. Once you think the form is ready:

  • Open dev-tools in browser and go to the network tab
  • Fill in the form with test data and submit. You should see the submission in the network tab (it is usually the longest one)

building-forms1

  • Open the request and navigate to the ‘payload’, here you will see the data that is being sent and where to. Check it matches that of the form and that the form ID is correct

building-forms2

  • Go to Marketo (you can request an account from László Kajtár, if you dont have one already), and find the appropriate form. In the following example we are looking at form ‘5917’. You can update the form ID in the URL to look at others: https://engage-sj.marketo.com/?munchkinId=066-EOV-335#/mktform/5917/overview/details
  • In the side-navigation there is usually a folder called ‘list’ and within that a file called ‘filled out form’, open this and navigation to the ‘people’ tab. This is where the filled out forms live

building-forms3

If for some reason the form is not appearing (as in the image above) you can:

  • Check the payload Marketo expects and see if your form matches that. This can be see by clicking the ‘preview’ button on the contact forms main page

building-forms4

  • Check if the form is throwing an error in sentry. Go to OpenID Authentication Required, choose the appropriate project and search for the associated form ID

building-forms5

Common pitfalls/errors

Submission not appearing in Marketo:

  • Check the form preview on Marketo and that the field you are submitting match and if the required fields are being sent (and required) from the web form.
  • There was once an error where using a fake email eg. test@test.com wasn’t getting submitted.
  • Submitting too many fields. If a field is ‘custom’ and is processed into ‘_Comments_for_lead’, make sure it doesn’t have a ‘name’ attribute. Or it will be submitted with the payload and could cause the submission to fail.
  • Missing hidden fields. We need certain fields in submissions like request_url, acuisition_url, and utm data fields or it could cause errors.
  • Incorrect action url. We have forms on pretty much all of our repos, but the submission url should remain the same https://ubuntu.com/marketo/submit
  • Incorrect implementation of intl-tel-input library which we use to generate dynamic phone fields. When rolling it out to additional repos please remember to remove the phoneInput name in the setupIntlTelInput function after the intlTelInput submission, example here

Last updated 22 days ago.

Help improve this document in the forum.