Note: This feature is available for personalization customers only. If you’re interested in getting personalization set up on your account, reach out to your CSM or contact email@example.com.
In this article we will go over the following Personalization page aspects:
1. Introduction to personalization form fields
There are two different categories of Form fields you can choose from: Inputs and Layouts.
The Input fields enable you to add content to your personalization (text, images, lists, etc). These fields will have Basic and Advanced settings that you can adjust when needed.
Under the Basic settings you will find:
Token: Token is case sensitive and will be matched to content and page rule %tokens%
Label: Set the main label for the form field
Default: Set the value shown to readers of your Doc if a personalized value has not been provided
Prefill Value: This value will be used to pre-populate the form field for personalizers. It will be submitted as-is unless the user changes the value when filling in the form
Placeholder: Set the placeholder text for the form field
Under the Advanced settings you will find:
Required: Required fields must be completed before a personalization form can be submitted.
Enabled: Disabled fields cannot be edited when filling in a personalization form, but any value they contain will still be submitted.
Visible: Hidden fields are not shown when filling in a personalization form, but any value they contain will still be submitted.
The Layout fields add structure and organization to your personalization form. These are great for managing the different parts of the form and make it easy for personalizers to input information.
The Single line field allows the personalizer to add a short line of text or single word to the personalization:
The Multi line field is best used for adding multiple sentences or longer text into the doc:
The Drop down field allows you to choose one option from a drop down list. This option will populate in the personalization wherever the token is placed.
The Checkboxes field is used for when you want to select more than one option. This field is great to use when choosing which pages or content should be included in a personalization.
Add a File upload field if you would like the ability to add an image to your doc from your computer.
Note: This is not applicable for public personalizations, for more information on personalization types click here.
The Choice field allows the personalizer to choose from one of the choices available to include in the personalization. You can choose to have the layout of this field as either Vertical or Horizontal. You can also choose to make it multiple choice.
Note: The following form fields (Logo, Homepage, Vidyard, and Video) are displayed on the cover of your Doc by default. Please contact your Turtl representative or firstname.lastname@example.org if you'd like to add advanced styles to your theme.
The Logo field allows you to add your customer's logo to your personalization.
To use this field, you will need to enter your customer's website URL or upload the logo manually by uploading a file.
Note: This is not applicable for public personalizations, as this would cause a security risk. For more information on personalization types click here.
The Homepage field enables you to add a screenshot of your customer's website to your personalization. To do this, you will need to paste your customer’s website URL into the form field.
Here is an example of how the homepage can look in your personalization:
In order for the homepage to look pretty, it needs an appropriate image added (e.g. with a computer screen) and some custom code to position the homepage.
Another important thing to mention is the display image has to be perfect shape like a square that is proportioned - not skewed.
Meaning the left image is not okay and the right image is.
Note: If the generated Homepage image has additional pop-up messages blocking the image, we have the option of replacing the image. Please contact your Turtl representative or email@example.com if you'd like to replace it.
The Vidyard field enables you to add a video onto the cover of your personalization. You can choose to record a video when you fill out the personalization or you can upload one from Vidyard.
Note: You must have a paid Vidyard account in order to use this field. Another thing to mention is the Vidyard field has a default placement. If you would like to change the placement, please contact your Turtl representative or firstname.lastname@example.org.
The BombBomb field enables you to add a video onto the cover of your personalization. You can choose to record a video when you fill out the personalization or you can upload one from BombBomb. You’ll need a BombBomb integration set up in order to use this field. See how to set this up in our support article here.
Once you’ve added the BombBomb field to your form, under the ‘Basic’ tab, the Input component should have a token named “bombbomb_config_token” and a “Prefill value”. These will automatically be added for you. The Prefill value is taken directly from your BombBomb Agent API Key that you sent to us.
Under the advanced tab, the input component should be hidden.
Note: BombBomb field has a default placement. If you would like to change the placement, please contact your Turtl representative or email@example.com.
If you don’t have a Vidyard account or BombBomb integration, you can instead use the Video field to record or upload a video to your personalization.
Note: This is not applicable for public personalizations, for more information on personalization types click here. The Video field has a default placement. If you would like to change the placement, please contact your Turtl representative or firstname.lastname@example.org.
The Section field can help break up the form into separate sections. For example you could have a client information section, a content section, etc:
The Step field helps break up the form into separate steps so that the form is easier to manage and easier to fill out for the personalizer.
Drag and drop the Step field in between other form fields:
This is what it will look like when you personalize the doc:
The buttons to navigate between the steps in your form will default to next and back, but you can customize these when editing your form.
Each step acts as a separate page of your form. Here are some key things to note:
The first step in your form will only display a next button and not a back one. The back button will still be editable when building your form but won't be visible when personalizing your Turtl Doc.
The final page of the form will always use the same text for the back button as the page before. You can't edit this separately.
The default text for the buttons (next and back) will get translated if you update the Doc language. However, if you edit the text to something custom then this will not get translated.
The Heading field is another way to organize your form - you can use this to break the form up with headings.
The Text field is best used for providing instructions or further descriptions throughout the form:
Build Content Button
The Build Content button will appear automatically on your personalization form. Click on the button in the form builder to be able to edit the button text in the basic tab on the right-hand side.
Note: The default 'Build Content' button text will get translated if you update the Doc language. However, if you edit the text to something custom then this will not get translated.
To learn more about different aspects of the personalization engine, see our collection of support articles here.
We also offer these training videos as part of our onboarding: