Skip to main content

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

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

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.

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

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.

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.

Next steps

Still have questions or need a hand? We’re happy to help. Reach our team at support@cometly.com.