Troubleshooting
Diagnose the common setup issues that stop analytics, form collection, or hosted forms from appearing in Rooster.
Website Stays Pending
Check that the analytics script is on the public website and that the public key matches the website row in Rooster.
Then open the public page in a normal browser tab. The status updates after Rooster receives a page view from the installed script.
If the site only uses the form collector, open the page with the form collector instead. The collector detect request can also activate the website and form group when the origin matches the website URL.
Website Shows Invalid
Invalid usually means Rooster received a script request from a different origin than the website URL saved in the dashboard.
Check:
- The website URL in Rooster exactly matches the public domain where the script runs.
- You are not testing from a preview domain, staging domain, or builder preview URL.
- The form group key exists when the script uses a non-default
data-rooster-formvalue.
Website or Form Group Shows Disconnected
Disconnected means Rooster previously saw the script, but the last known form page no longer appears reachable during status checks.
Check:
- The page still returns a successful public response.
- The form page was not moved to a new URL.
- The form collector script is still present after the latest deploy.
- The page is not blocked by auth, preview mode, or maintenance mode.
No Submissions
Confirm the form collector script is on the same page as the form.
Also check:
- The form has inputs with
nameattributes. - The form is not inside a page where collection should be disabled.
- The
data-rooster-formvalue on the script matches the form group you expect. - The collected form has the same
data-rooster-formvalue when the script is group-filtered. - A bot-protection challenge was not left incomplete.
Form Group Does Not Activate
Open Websites, expand the website row, and confirm the form group key. A group activates after Rooster detects that group on a page or receives a submission for it.
For a non-default group, use both values:
If you want one script to scan every form on the page, remove data-rooster-form from the script and keep the group key on each form.
Analytics Works but Forms Do Not
Analytics and form collection use different scripts.
- Analytics can be global in the layout.
- Form collection must be on the page that contains the form.
- The analytics script does not submit form field values.
Form Works but Analytics Does Not
The form collector can report form-page activity, but full page analytics needs the analytics script.
Install analytics globally if you want page views, referrers, devices, locations, route changes, and page-level bot protection.
CAPTCHA Does Not Pass
If the challenge appears but verification fails:
- Refresh the page and try again.
- Confirm cookies and local storage are not blocked.
- Confirm the website public key in the script still exists in Rooster.
- Check whether the visitor is behind a proxy, VPN, or blocked network.
Hosted Form Domain Looks Disconnected
For a Rooster subdomain, make sure the hosted form is published. For a custom domain, confirm the DNS target and verification record match the dashboard.
After DNS changes, wait for propagation, then use the dashboard verification action again.
Quick Debug Checklist
- Open the public website, not a preview URL.
- Confirm both scripts return
200in the Network tab. - Confirm the public key matches the website row.
- Submit one test form with a unique email address.
- Check the dashboard analytics and submissions pages.
