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

# Track an Existing Form

> Capture submissions from a form already on your website, without changing its code

A tracked form is a form that already exists on your website, such as an HTML form or an embedded HubSpot form. Conversion listens for its submissions in the browser and records them, so you don't have to rebuild the form or change its code.

Use a tracked form when you can't change how the form is built. If you can, use a [Conversion form](https://docs.conversion.ai/product-docs/forms/conversion-forms.md) instead: Conversion validates its submissions, and it supports [conditional fields](https://docs.conversion.ai/product-docs/forms/conditional-fields.md), redirects, and reCAPTCHA.

> [!WARNING]
>
> We usually recommend against relying on external forms if accuracy is paramount, as external forms can behave in unexpected ways that can lead to double submissions and missed captures.

## How tracking works

1. **Conversion discovers the form.** When the [Forms SDK script](https://docs.conversion.ai/product-docs/forms/forms-sdk.md#installation) is on the page, Conversion records each submission from a form it doesn't know yet. The form starts out untracked.
2. **You track it.** You pick one of its submissions and confirm. The form joins your Forms list.
3. **New submissions count.** From then on, each submission is matched to a contact and recorded on the form, like any other form.

Submissions received while a form is untracked are only kept so you can choose the form. They don't create contacts, and they don't move to the form when you track it.

### Which forms can be tracked

These external forms must be JavaScript forms (`<form>`), use input fields (`<input>`), and call the submit event.

The form is identified via the `id`, falling back to `name` if it doesn't exist. The field names that appear in the tracked form submissions are the names of the `<input>` elements.

> [!NOTE]
>
> If an email address is not passed through a form, it will not be mapped to or create a contact.

## Set up a tracked form

**Before you begin**

* Permission to create forms in your workspace.
* Access to add a script to the pages where the form appears.
* The [Conversion tracking script](https://docs.conversion.ai/product-docs/tracking/tracking-script.md#set-up-the-tracking-script) on those pages, so submissions are linked to tracked visitors.

**1. Add the Forms SDK script**

Add the script to every page where the form appears:

```html theme={null}
<!-- Add the Conversion Forms SDK script to your website -->
<script src="https://forms.conversion.ai/script.js"></script>
```

**2. Open the tracking dialog**

On the Forms page, click **New** → **Track an existing form**. The dialog shows **Listening for submissions...**.

**3. Submit the form on your website**

With the dialog open, submit the form on your website using a test email address. The submission appears in the dialog with its page URL and field values.

The dialog only lists submissions received after you opened it. Click **Clear submissions** to start listening again.

**4. Select the submission**

Click **Select** on the submission from the form you want to track.

**5. Choose a location**

Under **Location**, choose the folder the form goes in.

**6. Track the form**

Click **Confirm and track**. The form opens.

**7. Submit the form again**

Submit the form on your website once more. The form's settings list the inputs from submissions received after you tracked it, so they're empty until this one arrives.

**8. Map the email field**

Open the form's **Settings**. Under **Email field**, select the input that holds the contact's email address. Conversion uses it to match each submission to a contact.

**9. Map other fields**

Under **Additional fields**, map other inputs to contact or company fields.

![Screenshot 2026 02 19 At 11 47 14 PM](https://mintcdn.com/conversion/CHemlaZxARUi4qw2/images/Screenshot2026-02-19at11.47.14PM.png?fit=max\&auto=format\&n=CHemlaZxARUi4qw2\&q=85\&s=f077c9dd491cd736ff77885fa21a65ae)

## Managing a tracked form

A tracked form has **Overview**, **Submissions**, and **Settings** tabs. It has no **Design** tab and nothing to publish, because the form itself stays on your website.

Its **Settings** page has two sections:

* **Contacts:** **Create new contacts for new email addresses**, **Automatically subscribe contacts**, and **Sync contacts**. They start from your [defaults for new forms](https://docs.conversion.ai/product-docs/forms/overview.md#defaults-for-new-forms).
* **Fields:** the **Email field** and **Additional fields** mappings.

## Troubleshooting

> [accordion] Why is the Email field list empty?
>
> The list shows inputs from submissions received after you tracked the form. Submit the form on your website, then reload the form's **Settings**.

> [accordion] Why doesn't my form appear in the tracking dialog?
>
> Confirm the Forms SDK script loads on the page, then submit the form again while the dialog is open. The dialog doesn't show submissions from before you opened it.
>
> 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#tracked-forms).

> [accordion] Why are two external forms on different pages being routed to one Conversion form?
>
> Conversion identifies external forms via the HTML form element `id`, falling back to `name` if it doesn't exist. Thus, if a form with the same `id` exists on two different pages, their submissions will be routed to one Conversion form.

> [accordion] Why aren't submissions creating contacts?
>
> Check that the form's **Email field** is mapped in **Settings**. Submissions received before the email field was mapped, or before you tracked the form, don't create contacts.


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