Legacy Smart Forms: Prefill Fields with Contact Data
Applies to: ONTRAPORT Pro and above.
With ONTRAPORT, you have the ability to send your Contacts to a legacy Smart Form that’s pre-populated with their contact data. By pre-populating a legacy Smart Form, you reduce the number of steps a Contact needs to take, making it even easier for them to opt in and making them more likely to do so! This is done by sending your existing contacts an email containing a PURL that sends them to an ONTRAPORT Legacy Landing Page containing the pre-populated form. Because a PURL is required, your contacts must have a First Name in their contact record.
Note: This knowledge base article is for the older legacy Smart Forms and Legacy Landing Pages. Our new ONTRApages and ONTRAforms use a different method to prefill fields with cookie data rather than this legacy system.
How to Set This Up
- Create a new Smart Form
- Select the field you’d like to pre-populate.
- Fill the Prefill field with the corresponding Merge Field
- For example, in the ‘First Name’ Field you’d enter [First Name]
- To gain access to the proper syntax for your Merge Fields, we suggest using the ONTRAPORT Email Builder and inserting Merge Fields into the body of a throwaway email, then copying and pasting those Merge Fields over to the proper pre-fill box in your Smart Form.
- Grab the HTML form code
- Save the form
- Click the Publish Form button
- Select the HTML Version of the code and copy the text to your clipboard
The HTML Version tab may not be present in your account. It can be added by disabling a security setting as explained in this section:
Form Security Option: Disable Custom HTML Forms
In response to spammers, list bombers, and bot submissions, ONTRAPORT employs a number of secret protection measures to stop the bad guys in their tracks. When a potential opt in is identified as bad the data is not added to the Contacts database at all, and no indication is given to the spammer that they have failed in their attempt. This prevents them from submitting the form millions of times trying to find the right combination of values. This enhanced security is enabled on all new accounts and available to all existing accounts.
Why don't we force it to be enabled on all accounts? Enabling this option may break:
Because the form submission does not return an error page to the spammer, list bomber or bot, a valid prospect will not know that their opt in has failed. You will have no record in your account that the attempt was made. If you decide to turn this option on, please re-test your existing forms to make sure a valid Contact Record is made.
Turning this feature On will have two immediate results:
- Legacy Smart Forms will no longer have the HTML Version form code available on the Publish screen.
- The enhanced form security processes will be enabled for all future submissions to your account from all existing and future Smart Forms, ONTRAforms and Smart Form blocks in ONTRApages.
Turning this feature Off will make the HTML Version code available in Legacy Smart Forms and the enhanced form security processes will not be active. Spammers, list bombers and bots will still be able to get past our regular protection measures and submit bad contact information you will have to prune manually.
How to Enable Form Security:
- Click the profile icon in the top right of your account and select Administration
- Click the Security tab
- Slide the toggle under Disable Custom HTML Forms to On
Add the form code to a Landing Page
- Open a new or existing "Legacy Pages" Landing Page
- Add an HTML Layer
- Double click the layer and paste the HTML code into the HTML layer
- Save the Landing Page
Send contacts to the PURL of this landing page
- Open the Email message you want to add the PURL or hyperlink to
- Set your cursor where you’d like to insert the link and open the dropdown menu just below the content box titled Merge Fields
- From the dropdown menu find the PURLS section. The page you just saved will be listed there, select it to insert it into your message.
- Be sure to copy from HTML so that your message gets optimal delivery/reads and save.
How to Test your Smart Form
- Add yourself as a contact in your database with a valid email address
- Send yourself the email message you created
- Note that using the “Send Test Email” function won’t populate your personal information - it will just display your default merge values.
- Check to see if your contact data is pre-populated on the Smart Form
- Keep in mind that the Smart Form will only pre-populate a field if you have data stored in the Contact Record of a contact for that particular field
Other Important Facts
- The process above only works if you use the HTML version of the Smart Form code.
- If you send a contact to a pre-filled Smart Form that contains fields that aren't already filled out in their Contact Record, the Field on the Smart Form will populate with what you have set for that field in DEFAULT MERGE FIELDS in Contacts > Settings.
- This feature does not work on secure Landing Pages (https), only on non-secure Landing Pages (http)
- This method requires a valid PURL; only contact records with the First Name field populated will receive a properly formatted PURL. This method will not work if the First Name field is blank.
- An alternate method is used to prefill Smart Forms in integrated WordPress sites: How to Prefill ONTRAPORT Smart Forms in WordPress