Skip to main content
A Conversion form is a form you build in Conversion. You define its fields, validation, and field mappings once in the form builder, and Conversion checks every submission against them. Then you choose how the form reaches your website. For other kinds of forms, see the forms overview.

Embed or use the Forms SDK

The same Conversion form can collect submissions in two ways. Both show up in the form’s Settings → General, under Accept submissions. Embedding is the simplest choice: Conversion owns the form’s look, validation, and behavior. Use the Forms SDK when the form must match your website exactly, or when it’s already built and you only need its values in Conversion. If you can’t change the form’s code at all, track it instead. On a Conversion landing page, add the form with a form block instead. You don’t need either snippet.

Set up a Conversion form

Before you begin
  • The Conversion tracking script on your website, so submissions are linked to tracked visitors.
  • The page with the form is on your business’s registered base domain. To test on another domain, turn on Allow any origin for testing in the form’s General settings.
1

Create the form

On the Forms page, click New → Start from scratch, then enter a form name.
2

Design the form

Drag input elements into the form in the form builder, and map each input to a contact or company field. Every form has an Email input, which can’t be removed.
3

Publish the form

Click Publish. A form must be published before it accepts submissions.
4

Add the form to your website

Add the snippet from Settings → General to your page where the form should appear:
Replace <YOUR_FORM_ID> with your form ID.
5

Send a test submission

Submit the form on your website, then check the form’s Submissions tab.

Troubleshooting

Here are common reasons your form submissions may not be going through:
  1. The form must first be Published before it can collect form submissions.
  2. Conversion only collects submissions from forms located on website pages with your business’s registered base domain.
    1. To test submissions on another domain, toggle the Allow any origin for testing setting under the form’s General Settings.
  3. With the Forms SDK, a submission that fails validation is rejected. See debugging failed submissions.
  4. If your site has a Content Security Policy, it must allow the Forms SDK to send submissions. See Content Security Policy.
Conversion embedded forms only display on website pages hosted on your business’s registered base domain.To allow the form to be viewed and submitted on other domains for testing, toggle the Allow any origin for testing setting under the form’s General Settings.If your site has a Content Security Policy, it must allow the form’s iframe. See Content Security Policy.