> ## Documentation Index
> Fetch the complete documentation index at: https://docs.conversion.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Conversion Forms

> Build a form in Conversion, then embed it on your site or submit your own form's values with the Forms SDK

A Conversion form is a form you build in Conversion. You define its fields, validation, and field mappings once in the [form builder](https://docs.conversion.ai/product-docs/forms/dashboard/form-builder.md), 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](https://docs.conversion.ai/product-docs/forms/overview.md#choose-a-form-type).

## 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**.

| | Embed the form as an iframe | Submit the form programmatically |
| - | - | - |
| **Who draws the form** | Conversion, inside an iframe on your page | Your website, with its own HTML and styles |
| **How it looks** | Your **Form theme** in the form builder | Your website's design |
| **What you add to your site** | The embed snippet | The Forms SDK script and JavaScript that calls `ConversionFormsV1.submit()` |
| [Conditional fields](https://docs.conversion.ai/product-docs/forms/conditional-fields.md) | Shown and hidden as the visitor types | Enforced when you submit: hidden fields aren't required and their values are discarded |
| **Validation errors** | Shown to the visitor in the form | `submit()` returns `false`, and your page decides what to show |
| **Redirect URL** and **reCAPTCHA** | Available | Not available |
| **Hidden fields** | Filled with a [`set-values` message](https://docs.conversion.ai/product-docs/forms/forms-sdk#setting-field-values) | Passed in `submit()` like any other field |
| **Best for** | New forms, and the fastest setup | Keeping a form your team already designed and coded |

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](https://docs.conversion.ai/product-docs/forms/track-existing-forms.md) instead.

On a [Conversion landing page](https://docs.conversion.ai/product-docs/landing-pages/overview.md), 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](https://docs.conversion.ai/product-docs/tracking/tracking-script.md#set-up-the-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](https://docs.conversion.ai/product-docs/forms/dashboard/settings/general.md).

**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](https://docs.conversion.ai/product-docs/forms/dashboard/form-builder.md), 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**

> [tab] Embed the form as an iframe
>
> Add the snippet from **Settings** → **General** to your page where the form should appear:
>
> ```html theme={null}
> <!-- Add the Conversion Forms SDK script to your website -->
> <script src="https://forms.conversion.ai/script.js"></script>
>
> <iframe
>   id="<YOUR_FORM_ID>"
>   src="https://forms.conversion.ai/<YOUR_FORM_ID>"
> ></iframe>
> ```
>
> > [!TIP]
> >
> > Replace `<YOUR_FORM_ID>` with your form ID.

> [tab] Submit the form programmatically
>
> Add the Forms SDK script to your page, then call `ConversionFormsV1.submit()` when your own form is submitted. Follow [Submitting a custom form](https://docs.conversion.ai/product-docs/forms/forms-sdk.md#submitting-a-custom-form).
>
> Using Framer or Webflow? See the [Framer](https://docs.conversion.ai/product-docs/forms/installation/framer.md) or [Webflow](https://docs.conversion.ai/product-docs/forms/installation/webflow.md) guide.

**5. Send a test submission**

Submit the form on your website, then check the form's [**Submissions**](https://docs.conversion.ai/product-docs/forms/dashboard/submissions.md) tab.

## Troubleshooting

> [accordion] Why are my form submissions not going through?
>
> 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](https://docs.conversion.ai/product-docs/forms/dashboard/settings/general.md).
> 3. With the Forms SDK, a submission that fails validation is rejected. See [debugging failed submissions](https://docs.conversion.ai/product-docs/forms/forms-sdk.md#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](https://docs.conversion.ai/product-docs/tracking/content-security-policy.md#forms-submitted-with-the-forms-sdk).

> [accordion] Why isn't my embedded Conversion form displaying on my website?
>
> 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](https://docs.conversion.ai/product-docs/forms/dashboard/settings/general.md).
>
> If your site has a Content Security Policy, it must allow the form's iframe. See [Content Security Policy](https://docs.conversion.ai/product-docs/tracking/content-security-policy.md#embedded-conversion-forms).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.