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

# Troubleshoot form tracking

> Troubleshoot form tracking in Cometly: fix a tested page that shows Needs attention, a missing pixel, no forms found or a missing email field.

## Start here

You tested a page of your site and the result shows **Needs attention**, or leads from a form are not being tied to a person. Use this article to troubleshoot form tracking in Cometly: find the message your test shows, then follow the matching section.

The usual cause is that the Cometly pixel (the tracking script you install on your site) is not on the page, cannot see the form, or does not recognize the form's email field.

You test a page in Cometly under **Setup**, step 2 **Install the Cometly pixel**, in the part **Test form tracking**. If you have not tested your forms yet, follow [Test form tracking](https://docs.cometly.com/guides/form-tracking/testing.md) first.

Each page you test is listed under **Tested pages** with one of two statuses:

1. **Forms detected** (green check): every form found on the page has an email field that Cometly detected.
2. **Needs attention** (amber warning): the pixel or a form was not found on the page, or at least one form has no detected email field.

Expand a tested page to see the details. If the page has several forms, Cometly lists each one, marked **Tracking correctly** or **Missing email field**.

Cometly tracks the following fields: **First Name, Last Name, Full Name, Email and Phone**. The ones it recognized are listed under **Detected fields**. Among these, **Email** is the most critical field for attribution. If the email field is not tracked, attribution will not work.

If other fields such as First Name, Last Name or Phone are not tracking, see [How the Cometly pixel captures form field data](#how-the-cometly-pixel-captures-form-field-data).

Cometly may also find additional fields on your form. They sit in a collapsed list labelled with their count (for example **2 other fields**) and are not tracked. If a field that should be tracked shows up there, check that it meets the naming conventions in [How the Cometly pixel captures form field data](#how-the-cometly-pixel-captures-form-field-data).

## Pixel not found on this page

Cometly could not find the pixel on the page you tested. The pixel has to be installed on the page before forms can be tracked.

To fix it:

1. Install the pixel on the page. See [Install the Cometly pixel](https://docs.cometly.com/getting-started/install-pixel.md).
2. Click **Retest**.

## No forms found

Cometly found the pixel on the page but no form. This is typically due to one of the following reasons:

1. **The page URL does not contain a form**

   Make sure the URL you entered for the test is a page with a form.

2. **The form is a third-party embedded form**

   Cometly may not automatically detect an embedded third-party form. Cometly supports a list of third-party forms. Check whether yours is supported: [Form tracking for third-party embedded forms](https://docs.cometly.com/guides/form-tracking/third-party-forms.md).

   * If your form is not listed, [contact Cometly support](https://docs.cometly.com/support/contact.md).
   * Make sure the Cometly pixel is installed on the embedded form itself for tracking to work. See [Track forms inside iframes](https://docs.cometly.com/support/troubleshooting/form-tracking/track-iframes.md).

## Missing email field

Cometly detected a form on the page but did not detect an email field in it. The email field is essential: Cometly needs it to connect form submissions to the right person.

To fix it:

1. Make sure your form includes an **Email** field.
2. If the form already has an email field but it is not tracked, check that the field's type, name or ID meets Cometly's requirements. See [How the Cometly pixel captures form field data](#how-the-cometly-pixel-captures-form-field-data).

## No fields under Detected fields

If the pixel detected a form but could not identify any of its fields for tracking, the form shows **Missing email field** and its fields appear only in the **other fields** list. This is often due to the naming of the form fields.

To fix it:

1. Check that the form fields are configured correctly. See [How the Cometly pixel captures form field data](#how-the-cometly-pixel-captures-form-field-data).
2. Double-check the form's structure and make sure the fields you want tracked (Email, First Name, Last Name, Phone or Full Name) are named properly.

## How the Cometly pixel captures form field data

This section is advanced, and you may need help from your website developer. It lists the form fields that the Cometly pixel captures automatically, and the field IDs, types or names you may need to update if the pixel is not capturing form data correctly on your native website forms.

When you inspect the page and look at a form field element, you see `comet-listener="true"` on it if the Cometly pixel is listening to capture the field's data when there is an input.

### Email

In the email field example below, you can see `type="email"` and `name="email"`. You can also see `comet-listener="true"`. The Cometly pixel automatically captures the **email address** entered in this form.

```html theme={null}
<input class="elFormItem elInput inputHolder required1 garlic-auto-save" value="" type="email" name="email" pattern="" autocomplete="" inputtype="" data-prevent-submit="" data-prevent-garlic="" placeholder="Email Address" maxlength="" comet-listener="true">
```

The `type`, `id` or `name` of the input field has to be set to one of the following for the Cometly pixel to capture it automatically:

* email
* Email
* Work-Email

### First name

In the first name field example below, the `name` and `id` are set to **First-Name**. You can also see `comet-listener="true"`. The Cometly pixel automatically captures the **first name** entered in this form.

```html theme={null}
<input class="text-field-sales-form email demo-lander w-input" maxlength="256" name="First-Name" data-name="First Name" placeholder="Enter your first name" type="text" id="First-Name" required="" comet-listener="true">
```

The `type`, `id` or `name` of the input field has to be set to one of the following for the Cometly pixel to capture it automatically:

* first-name
* firstname
* Firstname
* First-Name

### Last name

In the last name field example below, the `name` and `id` are set to **Last-Name**. You can also see `comet-listener="true"`. The Cometly pixel automatically captures the **last name** entered in this form.

```html theme={null}
<input class="text-field-sales-form email demo-lander w-input" maxlength="256" name="Last-Name" data-name="Last Name" placeholder="Enter your last name" type="text" id="Last-Name" required="" comet-listener="true">
```

The `type`, `id` or `name` of the input field has to be set to one of the following for the Cometly pixel to capture it automatically:

* last-name
* lastname
* Lastname
* Last-Name

### Full name

In the full name field example below, the `id` is set to **Full-Name**. You can also see `comet-listener="true"`. The Cometly pixel automatically captures the **full name** entered in this form.

```html theme={null}
<input class="text-field-sales-form email demo-lander w-input" maxlength="256" name="Last-Name" data-name="Full Name" placeholder="Enter your full name" type="text" id="Full-Name" required="" comet-listener="true">
```

The `type`, `id` or `name` of the input field has to be set to one of the following for the Cometly pixel to capture it automatically:

* full-name
* fullname
* Fullname
* Full-Name

### Phone

In the phone field example below, the `type` is set to **tel** and the `id` is set to **Phone-Number**. You can also see `comet-listener="true"`. The Cometly pixel automatically captures the **phone number** entered in this form.

```html theme={null}
<input class="text-field-sales-form email demo-lander w-input" maxlength="256" name="Phone-Number" data-name="Phone Number" placeholder="Enter your phone number" type="tel" id="Phone-Number" required="" comet-listener="true">
```

The `type`, `id` or `name` of the input field has to be set to one of the following for the Cometly pixel to capture it automatically:

* tel
* phone
* Phone-Number
* phone-number

## Confirm form tracking is fixed

After each fix, click **Retest** on the page under **Tested pages**. The problem is resolved when the page shows the green **Forms detected** status, every form on it shows **Tracking correctly**, and **Email** appears under **Detected fields**.

## Frequently asked questions

### Why is Cometly not tracking my iframe form?

A form that loads inside an iframe is only tracked when the Cometly pixel is installed in the iframe's own code, not just on the page around it. If the form service does not let you add custom code, the pixel cannot capture that form automatically. See [Track forms inside iframes](https://docs.cometly.com/support/troubleshooting/form-tracking/track-iframes.md).

### Can I track a form if I cannot install the Cometly pixel on the form page?

Yes, if your funnel platform can pass the submitted email to the next page. When a page with the Cometly pixel has the email as a parameter in its URL, Cometly updates or creates the matching contact. See [Pass the email as a URL parameter to your thank-you page](https://docs.cometly.com/support/troubleshooting/form-tracking/pass-email-to-thank-you-page.md).

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

No. During the test you type something into every field of the form, do not submit it, and click **Finish test**. See [Test form tracking](https://docs.cometly.com/guides/form-tracking/testing.md).

## Next steps

* [Test form tracking on a page](https://docs.cometly.com/guides/form-tracking/testing.md)
* [Check the supported 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)
* [Pass the email to your thank-you page](https://docs.cometly.com/support/troubleshooting/form-tracking/pass-email-to-thank-you-page.md)
* [Contact Cometly support](https://docs.cometly.com/support/contact.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.