All Collections
Embedding a HubSpot form
Embedding a HubSpot form
Learn how to capture sign-ups directly into HubSpot from Turtl
Kristi Eddy avatar
Written by Kristi Eddy
Updated this week

Turtl supports embedding Hubspot forms in place of the default Turtl native form. All Turtl needs is a little bit of information about your form, and this article will show you how this is done.

Embed your Hubspot form

1. Create your form and find the embed code

Create your form as usual then click the "Actions" menu in the top right-hand corner and select "Embed code"

In the popup that appears, use the "Copy" button to copy the embed code to your clipboard.

2. Find your Form ID and Portal ID

Your embed code will look something like this:

<!--[if lte IE 8]>
<script charset="utf-8" type="text/javascript" src="//"></script>
<script charset="utf-8" type="text/javascript" src="//"></script>
portalId: "1707745",
formId: "2dd13f18-f77e-43cf-9022-7359e3555f5a",
css: ""

Look for the lines that say portalId  and formId  and copy these Ids. In the example above these are:

portalId: 1707745
formId: 2dd13f18-f77e-43cf-9022-7359e3555f5a

3. Tell Turtl about your form

Navigate to the main Turtl Docs listing page and choose "Settings" for the Turtl Doc you wish to add your form to:

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

Now paste the following URL into the "Form URL" field, replacing portalId and formId with the values you found in the previous step:


For example, with our example embed code above this would be:


The form will now display in your Turtl Doc as both the immerse 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.

Please note that styling will be applied automatically to your Hubspot forms, except for free Hubspot accounts. If you notice any styling issues, please contact or your customer success manager.

Optional Steps

1. 'Thank you' message

The "thank you" message will be displayed when a reader has submitted the form on the back cover of your doc. By default it will just say "Thank you", but this can be changed to whatever you want. At the end of the URL you just created add the following code:


After the code, type the message that you would like to be displayed, without any quotes and with spaces between words.

A message in English would look like this:

&hbsptCompleteMsg=Thank you for your interest in our company. A member of our team will be in touch with you shortly.

Thanks for signing up in Mandarin "感谢你注册!" would look like this:


2. Hidden Fields

  1. In the properties of your form select “Create New”

  2. On the Form Fields page, select "single-line text”

  3. In the Basic Info section, select Object type as “Contact”, your desired Group, and add one of the following options to the label field:


ttl_story_id (This label will pull the Turtl Doc ID)

ttl_story_link (This label will pull the Turtl Doc URL)

ttl_story_title (This label will pull the Turtl Doc Title)

(These options are detailed further in the support article Adding hidden fields to your forms.)

4. Once the property is created, click on the new field in the form to edit and toggled on the “Make this field hidden” option.

5. Save your new field and update your form!


With your Hubspot Integration complete, you will not only see leads from your embedded Hubspot form in Hubspot CRM, but also in your Turtl analytics dashboard. These leads will appear in the Known Readers section or in your analytics csv.

Without a Hubspot Integration, your identified leads will only be located in Hubspot. Turtl will still collect leads through your Hubspot form, but they will be unidentified. You can read more about Individual Reader Analytics here.

If you have a free HubSpot account, known readers cannot be captured in your analytics and styling cannot be applied to your forms.

Please reach out to your Customer Success Manager if you would like to add this integration, as this may come at an additional cost.

Did this answer your question?