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:- Forms detected (green check): every form found on the page has an email field that Cometly detected.
- 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.
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:- Install the pixel on the page. See Install the Cometly pixel.
- 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:- The page URL does not contain a form Make sure the URL you entered for the test is a page with a form.
-
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.
- If your form is not listed, contact Cometly support.
- Make sure the Cometly pixel is installed on the embedded form itself for tracking to work. See Track forms inside iframes.
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:- Make sure your form includes an Email field.
- 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:- Check that the form fields are configured correctly. See How the Cometly pixel captures form field data.
- 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 seecomet-listener="true" on it if the Cometly pixel is listening to capture the field’s data when there is an input.
type="email" and name="email". You can also see comet-listener="true". The Cometly pixel automatically captures the email address entered in this form.
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:
- Work-Email
First name
In the first name field example below, thename 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.
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, thename 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.
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, theid is set to Full-Name. You can also see comet-listener="true". The Cometly pixel automatically captures the full name entered in this form.
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, thetype 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.
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
- Test form tracking on a page
- Check the supported third-party embedded forms
- Track forms inside iframes
- Pass the email to your thank-you page
- Contact Cometly support