Start Here 👋
This article will guide you through troubleshooting form tracking issues within Cometly. If you're testing forms on your site and experiencing errors, this guide will help you identify and resolve the problem.
If you have not yet tested your forms, view our article with step-by-step instructions for Testing Form Tracking.
When testing a page URL with forms, you may encounter two status types for form tracking:
Tracking (Green): All forms on the page are tracking properly.
Tracking Errors (Yellow): An error has been detected on one or more forms on the page.
If the page has multiple forms, Cometly will list each form detected. Note that Cometly tracks the following fields: First Name, Last Name, Email, Phone, and Full Name. Among these, Email is the most critical field for tracking attribution. If the email field is not properly tracked, attribution will not function.
If other fields such as First Name, Last Name, or Phone are not tracking, please refer to the section of this article that will help you understand how the Cometly Pixel captures form field data.
Cometly may also detect additional fields on your form, but only the specified fields are tracked. If you see fields that should be tracked but aren’t, you’ll need to confirm they meet the required naming conventions outlined in the native forms article above.
Missing Form (Error - No Form Detected)
If no form is detected on the page, it’s typically due to one of the following reasons:
The Page URL Does Not Contain a Form
Ensure the URL you entered for testing includes a page with a form.
Using a Third-Party Embedded Form
If you're using an embedded third-party form, Cometly may not automatically detect it. Cometly supports a list of third-party forms—check our guide to see if your form is supported: Third-Party Embedded Forms Tracking.
Note: If your form is not listed, contact Cometly Support.
Important: Make sure the Cometly Pixel is installed on the embedded form itself for tracking to work.
Email Field Issues (Error - No Email Field Detected)
This error indicates that while Cometly detected a form on the page, it did not detect an email field. The email field is essential for tracking attribution. Without it, the Cometly Pixel cannot function properly.
Steps to Fix:
Ensure that your form includes an Email field.
If the form already includes an email field but it’s not being tracked, check the field’s name and ID to ensure they meet Cometly’s requirements. Refer to this section: Learn how the Cometly Pixel captures form field data.
No Tracked Fields (Error - No Form Fields Tracked)
This error indicates that while the pixel detected a form, it could not identify any fields for tracking. This is often due to incorrect naming conventions for the form fields.
Steps to Fix:
Verify that the form fields are configured correctly. Learn how the Cometly Pixel captures form field data.
Double-check the form’s structure and ensure the required fields (Email, First Name, Last Name, Phone, or Full Name) are named properly.
Understand How The Cometly Pixel Captures Form Field Data
This is an advanced help article, and you may need assistance from your website developer. Below, we’ll outline the form fields that the Cometly Pixel is designed to automatically capture. Additionally, we’ll provide the specific form field IDs, types, or names you may need to update if the Cometly Pixel is not capturing form data correctly for your native website forms.
When you inspect the page and look at your form field element, you will see see the comet-listener="true" if the Cometly Pixel is listening to capture the form field data when there is an input.
In the email form field example below, you can see type="email" and name="email". You can also see the the comet-listener="true". The Cometly Pixel will automatically capture the email address inputed on this form.
<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 in the input field has to be set to one of the following for the Cometly Pixel to automatically capture:
email
Email
Work-Email
First Name
In the first name form field example below, you can see the name and id are set to First-Name. You can also see the the comet-listener="true". The Cometly Pixel will automatically capture the first name inputed on this form.
<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 in the input field has to be set to one of the following for the Cometly Pixel to automatically capture:
first-name
firstname
Firstname
First-Name
Last Name
In the last name form field example below, you can see the name and id are set to Last-Name. You can also see the the comet-listener="true". The Cometly Pixel will automatically capture the last name inputed on this form.
<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 in the input field has to be set to one of the following for the Cometly Pixel to automatically capture:
last-name
lastname
Lastname
Last-Name
Full Name
In the full name form field example below, you can see the name and id are set to Full-Name. You can also see the the comet-listener="true". The Cometly Pixel will automatically capture the full name inputed on this form.
<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 in the input field has to be set to one of the following for the Cometly Pixel to automatically capture:
full-name
fullname
Fullname
Full-Name
Phone
In the phone form field example below, you can see the type is set to tel and id is set to Phone-Number. You can also see the the comet-listener="true". The Cometly Pixel will automatically capture the phone number inputed on this form.
<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 in the input field has to be set to one of the following for the Cometly Pixel to automatically capture:
tel
phone
Phone-Number
phone-number
If you encounter issues with form tracking, the first step is to identify the error type and refer to the solutions outlined in this article. For unresolved issues, feel free to reach out to our support team for further assistance.