Building forms
Forms
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)
- 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
- 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
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
- 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
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 7 hours ago.