Skip to main content

Embedding a Formsite form

Learn how to capture sign-ups directly into Formsite from Turtl

Note: Turtl is unable to identify contacts using Formsite forms. Leads will be sent to Formsite, but will be displayed as "unknown" in the "Contacts" section of your Turtl Analytics Dashboard.

Turtl supports embedding Formsite forms in place of the native Turtl lead capture form. For this to work correctly, the Formsite forms themselves need to be configured to ensure they will render and behave correctly in Turtl. This document walks you through that process.

1. Add the Turtl script to your form

First, you'll need to add a script tag to your form. This allows Turtl to control the form and how it renders.

To do this, go to edit your form and choose the "Style" tab from the menubar on the left side and then select the "Advanced" option from the list below.

Now paste the following text into the field called "HTML head":

<script data-ttl-form-mode="embed" type="text/javascript" src="https://app-static.turtl.co/forms/turtl.forms.formsite.v1.js"></script>  


2. Customise your Success page

Finally, we need to add a script to the Success page for your form. This allows Turtl to know when the form has been completed.

To do this, go to "Form settings" and choose "Success Pages" from the menu on the left side. Give your form a name, choose the "Custom Success Page" option, and untick the "Enable text editor" option.

Now paste the following text into the text box:

<h1>Thank you</h1>
<script data-ttl-form-mode="complete" type="text/javascript" src="https://app-static.turtl.co/forms/turtl.forms.formsite.v1.js"></script>

You can customize the "Thank you" portion of this script with a different message, or add additional elements using HTML as you wish.


3. Tell Turtl about your form

Navigate to the main Doc listing page and choose "Settings" for the Doc you wish to use the form on:

On the Settings page, choose the "Forms" tab:

Paste in the URL of your form. The form will now display in your Doc as both the Content page form and the Back cover form. If you want to display a different form for the back cover, you can specify a different URL in the "Back cover form URL" field.


4. Style options

By default, Turtl strips your form's original styles and injects Turtl brand styles. If this is the first time you're adding a form to Turtl, it will need to be styled by our team to match the rest of your content. Once you've added your form, please contact Customer Support and we'll get it styled for you.

If you want to keep your form's original styles instead, return to the script code snippet added in Step 1 and include the attributes below set to false in the opening <script> tag:

data-ttl-form-strip-styles="false” keeps your form's original styles

data-ttl-form-inject-styles="false" prevents Turtl from applying brand styles

Updated code snippet:

<script data-ttl-form-mode="embed" data-ttl-form-strip-styles="false" data-ttl-form-inject-styles="false" type="text/javascript" src="https://app-static.turtl.co/forms/turtl.forms.formsite.v1.js"></script>
Did this answer your question?