Skip to main content
Embedding a Gravity form

Learn how to capture sign-ups directly into Gravity forms from Turtl

Dominic Adams avatar
Written by Dominic Adams
Updated this week

Turtl supports embedding Gravity forms in place of Turtl's native lead capture form. This enables inputs from the embedded Gravity form to be monitored within WordPress.

Note: The leads from the form will NOT be visible in Turtl; they will only be visible in WordPress.


To do this, Turtl needs both a snippet of code to be placed in your form (in order to apply the correct styling) and know which form you wish to use.

Here's how it works:

Create a "thank you" page

This page will be used to confirm the form submission and will only be displayed when a reader completes a form on your Turtl Doc.

  • Go to "WordPress admin" -> "Pages" -> "Add New".

  • Create a simple blank page (without any headers, footers, menus, etc.)

  • Write a thank you message in the body of the page

  • Add the code below anywhere on your page within the "Code editor" (you can switch to code editor by clicking on "Options" / three-dot menu in the top right corner).

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

Create a Gravity form

  • Go to "WP administration" > "Forms" > "New form" to create a form according to your preferences.

  • While still in the editor of your form, go to "Settings" > "Confirmations" and edit the Default confirmation:

  • Select "Page" as Confirmation Type

  • Select the thank you page you made in Step 1 from the dropdown

  • Input id={entry_id} into the "Pass Field Data via Query String" field (you don’t need to input your actual ID number, as the latter will be passed via a query string)

Create a landing page

Create a page that only contains your form. There is no need to add styles or formatting as this will be done by Turtl to keep your form consistent with your content.

  • Go to "WP admin" > "Pages" > "Add New".

  • Create a simple blank page (without any headers, footers, menus, etc.)

  • Add text of your choice in the body, e.g. Subscribe to our newsletter

  • Add the Gravity form you created in step 2.

  • Go to Code editor mode and add the following:

<script data-ttl-form-mode="embed" type="text/javascript" src="https://app-static.turtl.co/forms/turtl.forms.gravity.v1.js"></script> 
  • Save and publish the page

Copy the URL of the landing page

Tell Turtl about your form

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

  • On the "Doc settings" modal, choose the "Forms" tab:

  • Paste in the URL you copied in step 4 above into the desired form URL field.

There are three form URLs you can specify:

  1. Default form URL: This URL will be used for both Content pages and Back cover forms unless the back cover form URL is also set.

  2. Cover form URL: This URL can be used to add a form on the very first Surf page of your content. Readers will not be able to read or navigate past the first page without entering their details.

  3. Back cover form URL: This can be used to set a different form for the back cover. If this is left blank, the form set as Form URL will be used on the back cover.

Note: If this is the first time your company has added a form to Turtl it will not have styling applied. Please contact your CSM or Customer Support once your form has been added to a Doc and we will style it for you.

Did this answer your question?