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

# How form tracking works

> See how Cometly form tracking captures the name, email and phone fields on your site's forms and ties each lead to the ad that produced it.

Cometly form tracking reads the contact details visitors type into the forms on your site. The Cometly pixel (the tracking script you install on your pages) captures key form field data in real time as visitors fill in your forms. Cometly uses the email address as the unique identifier to map events back to the right contact, so every event sent with an email address is attributed to its source.

This is what turns an anonymous visit into a known lead. Once a visitor's email is captured, you can see which ad or channel brought that person in, and later events with the same email (a lead or a sale, for example) are credited to the same source.

* To test form tracking step by step, see [Test form tracking](https://docs.cometly.com/guides/form-tracking/testing.md).
* If form tracking is not working, see [Troubleshoot form tracking](https://docs.cometly.com/support/troubleshooting/form-tracking/troubleshooting-form-tracking.md).

## What form field data Cometly tracks

The Cometly pixel automatically captures these fields from your forms:

* Full name
* First name
* Last name
* Email address
* Phone number

## How Cometly form tracking works

* **Live data capture:** the pixel captures form data in real time as visitors type, even before they submit the form.
* **Event mapping:** the email address links events to the correct contact.
* **Clear attribution:** each lead or conversion is tied to its source, so you can see how your campaigns perform.

## What this means for you

* **Real-time lead capture:** you get lead data as visitors engage with your forms, with no submission required.
* **More visibility:** you can follow each contact's journey and see how your ads drive meaningful interactions.
* **Better attribution:** every event is mapped to its origin, which gives you reliable data to optimize your marketing.

## Cometly Pixel Helper (Chrome extension)

The Cometly Pixel Helper is a Chrome browser extension that helps you check that Cometly is installed correctly on your website.

[Learn how to install and use the Cometly Pixel Helper](https://docs.cometly.com/guides/tracking/pixel-helper.md)

## Third-party embedded forms

If you use third-party embedded forms (for example, you placed a code snippet from a third-party app on your web page), you may need to take extra steps so the Cometly pixel can capture form field data. There is a guide for each supported third-party form. If your form is not listed, contact support.

[View supported third-party forms](https://docs.cometly.com/guides/form-tracking/third-party-forms.md)

## Advanced: form field identifiers

The Cometly pixel automatically captures the first name, last name, full name, email address and phone number on almost all native website forms. In rare cases, a custom form is built in a way the pixel cannot read. If your form is native to your website (not a third-party embed) and the pixel is not capturing its fields, you may need to edit the form field IDs.

[Learn how to fix issues with the pixel capturing form fields](https://docs.cometly.com/support/troubleshooting/form-tracking/troubleshooting-form-tracking.md)

## Frequently asked questions

### How do I know if Cometly is tracking my form?

Test the page that holds the form. Click **Setup** in the sidebar, open step 2, **Install the Cometly pixel**, and scroll to **Test form tracking**. A page where every form is tracking shows **Forms detected**, and each form on it is marked **Tracking correctly**. See [Test form tracking](https://docs.cometly.com/guides/form-tracking/testing.md) for the full steps.

### Does Cometly track Google Forms?

No. Google Forms and Fresha are not supported. Many other third-party form tools are supported, and some need extra setup first: see [Form tracking for third-party embedded forms](https://docs.cometly.com/guides/form-tracking/third-party-forms.md).

### Does Cometly form tracking work on forms inside an iframe?

Yes, as long as the Cometly pixel is installed on the embedded form itself, not only on the page around it. See [Track forms inside iframes](https://docs.cometly.com/support/troubleshooting/form-tracking/track-iframes.md).

## Next steps

* [Test form tracking on a page of your site](https://docs.cometly.com/guides/form-tracking/testing.md)
* [Set up form tracking for third-party embedded forms](https://docs.cometly.com/guides/form-tracking/third-party-forms.md)
* [Install and use the Cometly Pixel Helper](https://docs.cometly.com/guides/tracking/pixel-helper.md)
* [Troubleshoot form tracking](https://docs.cometly.com/support/troubleshooting/form-tracking/troubleshooting-form-tracking.md)
* [Install the Cometly pixel](https://docs.cometly.com/getting-started/install-pixel.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.