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

# Test form tracking

> Test form tracking in Cometly to confirm the pixel detects every form on a page and captures the email field that ties each lead to its ad.

The Cometly pixel (the tracking script you install on your site) picks up the **Email**, **Name** and **Phone** fields when someone fills out a form on your site. When you test form tracking in Cometly, you open one of your pages, type into its forms, and Cometly reports which forms and fields the pixel can see.

Email is the most important field: Cometly uses it to connect that person to events (the leads, sales and other actions Cometly records) from your integrations, such as a purchase in Stripe or a new lead in HubSpot. If a form's email field is not detected, leads from that form cannot be tied back to the ad that produced them, so test each page before you rely on its numbers.

* New to form tracking? Read [How form tracking works](https://docs.cometly.com/getting-started/form-tracking.md).
* Using a third-party embedded form or an iframe? Some of these need extra setup. See [Form tracking for third-party embedded forms](https://docs.cometly.com/guides/form-tracking/third-party-forms.md).

## Before you start

* The Cometly pixel is installed on the page you want to test. See [Install the Cometly pixel](https://docs.cometly.com/getting-started/install-pixel.md).
* The page's domain is added under **Add domains** in the same setup step. If no domain is listed, the test shows "Add a domain in step 1 to test form tracking".
* Your browser allows pop-ups from Cometly. The test opens your page in a pop-up window.

## Test a page

**1. Open the form tracking test**

Click **Setup** in the sidebar, open step 2, **Install the Cometly pixel**, and scroll to **Test form tracking**.

**2. Choose the page**

Under **Test a page**, pick the domain from the dropdown and enter the page path, the part of the URL after the domain (for example `demo`). Then click **Test**.

**3. Start the test**

A **Test form tracking** dialog explains what happens next. Click **Open Page & Start Test**. Your page opens in a pop-up window.

**4. Fill in the form, without submitting it**

In the pop-up:

1. Find your form on the page.
2. Type something into every field (name, email, phone and so on). If the page has several forms, fill out all of them.
3. Do not submit the form.
4. Click **Finish test** when you are done.

**5. Review the results**

The page you tested appears under **Tested pages** with one of two statuses:

* **Forms detected** (green): every form found on the page is tracking correctly.
* **Needs attention** (amber): the pixel or a form was not found, or at least one form has no email field.

Click the page to see the details. Each form on the page gets its own result, **Tracking correctly** or **Missing email field**, with the **Detected fields** listed below it. Make sure every form shows **Tracking correctly**.

After you fix a problem, click **Retest** on that page. Click the trash icon to remove a page from the list.

## Check it worked

The page you tested is listed under **Tested pages** with the green **Forms detected** status. When you click the page, every form on it shows **Tracking correctly**, and its email field appears under **Detected fields**.

## What the results mean

### Pixel not found on this page

The Cometly pixel is not installed on the page, so forms cannot be tracked. [Install the Cometly pixel](https://docs.cometly.com/getting-started/install-pixel.md) on the page and test again.

### No forms found

The pixel is on the page but Cometly found no form. This often means the form is a third-party embed that needs extra setup. Check the [third-party embedded forms](https://docs.cometly.com/guides/form-tracking/third-party-forms.md) page and the [form tracking troubleshooting guide](https://docs.cometly.com/support/troubleshooting/form-tracking/troubleshooting-form-tracking.md).

### Missing email field

Cometly found a form but could not detect an **Email** field. Cometly needs an email field to connect a form submission to the right person. See the [form tracking troubleshooting guide](https://docs.cometly.com/support/troubleshooting/form-tracking/troubleshooting-form-tracking.md).

### A form is missing from the results

If the page has a form that does not show up in the results at all, see the [form tracking troubleshooting guide](https://docs.cometly.com/support/troubleshooting/form-tracking/troubleshooting-form-tracking.md).

## HubSpot legacy forms

The same **Test form tracking** section has a HubSpot tool. HubSpot has legacy and new forms, and a legacy form's embed code must be converted before Cometly can track it. Paste the legacy embed code, convert it, and replace the old code on your site with the result.

## Frequently asked questions

### Do I need to submit the form to test Cometly form tracking?

No. The test detects each field as you type into it, so typing something into every field is enough. Leave the form unsubmitted and click **Finish test** when you are done.

### Which form fields does Cometly capture?

The Cometly pixel captures full name, first name, last name, email address and phone number. Email is the one the test checks for, because Cometly uses it to match a form submission to the right person.

### What should I do if the test says "No forms detected yet"?

That message appears when the pixel has not reported any form fields from the pop-up so far. Type into the fields on your form, and click **Keep waiting** if the page is still loading. If nothing is detected, click **Cancel**: the page is saved under **Tested pages** as **Needs attention**, and its details show whether the pixel or the form was not found.

## Next steps

* [Troubleshoot form tracking when a form or field is not detected](https://docs.cometly.com/support/troubleshooting/form-tracking/troubleshooting-form-tracking.md)
* [Set up form tracking for third-party embedded forms](https://docs.cometly.com/guides/form-tracking/third-party-forms.md)
* [Track forms inside iframes](https://docs.cometly.com/support/troubleshooting/form-tracking/track-iframes.md)
* [Learn how form tracking works](https://docs.cometly.com/getting-started/form-tracking.md)
* [Check your pixel with the Cometly Pixel Helper](https://docs.cometly.com/guides/tracking/pixel-helper.md)

Still have questions or need a hand? We're happy to help. Reach our team at [support@cometly.com](mailto:support@cometly.com).


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