If your form provider isn’t a CRM, or you can’t find the form type you want to embed on our list, you can use our generic form walk-through to get set up.
Check your form requirements
If you want to use a form provider that Turtl doesn’t currently offer, your form must meet the following requirements:
It can be embedded via iFrame
It can be served over HTTPS
It can redirect to a custom location after a successful submission
It can have a custom JS script applied to it
Add code snippets to your form
Navigate to the form you want to embed and include the following code snippet:
<script src="https://app-static.turtl.co/forms/turtl.forms.generic.v1.js"
data-ttl-form-mode="embed"
data-ttl-form-strip-styles="false"
data-ttl-form-inject-styles="false"
data-ttl-form-provider="provider-name"></script>
On your form’s confirmation page, include the following code snippet:
<script src="https://app-static.turtl.co/forms/turtl.forms.generic.v1.js"
data-ttl-form-mode="complete"
data-ttl-form-strip-styles="false"
data-ttl-form-inject-styles="false"
data-ttl-form-provider="provider-name"></script>
This snippet is the same but with an updated "form-mode" since the form has been completed on the confirmation page. We’ll look at further options for these snippets below.
Alternative code snippets
Apart from data-ttl-form-mode, there are several ways you can update your code snippet to change your form:
data-ttl-form-mode: embed/complete
For this line of code, add “embed” when a script is placed on a landing page - or “complete” when a script is placed on a confirmation/thank-you page
data-ttl-form-strip-styles: true/false
For this line of code, add “true” to remove - or “false” to keep - default form styles.
data-ttl-form-inject-styles: true/false
For this line of code, add “true” to inject Turtl styles from a brand theme
data-ttl-form-provider: name of the form
For this line, add the name of the form provider. This is required to show where sign-ups are coming from and allows a brand theme to assign styles for that form provider.
Getting started
Follow the steps below to start using your custom form with Turtl.
Publish the form and obtain its URL (the form can be hosted on your CRM (if supported), or your company's hosting service).
Enter the form URL in the Turtl Doc Settings by following the instructions in this support article.
Send a link to your Turtl Doc with your custom form to support@turtl.co
The form will be checked against the above requirements.
Custom CSS and a redirect location will be provided.
Add the custom CSS and configure your form to redirect to the correct location after submission.
When complete, we will help you perform testing to ensure data is captured correctly.
Notes:
If you need further support with embedding a form by a provider we currently don't support or would like styling applied to it, please contact the Professional Services team.
Turtl is unable to capture leads from forms by unlisted providers. Readers will be displayed as "unknown" in the known reader section of your Turtl Analytics Dashboard.
Find out more: