RoosterDocs
Rooster Docs
Installation
Integrations
Examples
Troubleshooting
Website stays pendingNo submissionsCAPTCHA does not pass
HomeApp
Rooster Docs
RoosterDocs
Rooster Docs
Installation
Integrations
Examples
Troubleshooting
Website stays pendingNo submissionsCAPTCHA does not pass
HomeApp
Docs/Troubleshooting

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.

<script src="https://api.rooster.host/analytics/YOUR_PUBLIC_KEY.js" defer></script>

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

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.

<script src="https://rooster.ink/embed/YOUR_PUBLIC_KEY.js" data-rooster-form="default" defer></script>

Also check:

  • The form has inputs with name attributes.
  • The form is not inside a page where collection should be disabled.
  • The data-rooster-form value on the script matches the form group you expect.
  • The collected form has the same data-rooster-form value 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:

<script src="https://rooster.ink/embed/YOUR_PUBLIC_KEY.js" data-rooster-form="sales" defer></script>
 
<form data-rooster-form="sales">
  <input name="work_email" type="email" />
  <button type="submit">Send</button>
</form>

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:

  1. Refresh the page and try again.
  2. Confirm cookies and local storage are not blocked.
  3. Confirm the website public key in the script still exists in Rooster.
  4. 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

  1. Open the public website, not a preview URL.
  2. Confirm both scripts return 200 in the Network tab.
  3. Confirm the public key matches the website row.
  4. Submit one test form with a unique email address.
  5. Check the dashboard analytics and submissions pages.
PreviousSquarespace

On this page

Website Stays PendingWebsite Shows InvalidWebsite or Form Group Shows DisconnectedNo SubmissionsForm Group Does Not ActivateAnalytics Works but Forms Do NotForm Works but Analytics Does NotCAPTCHA Does Not PassHosted Form Domain Looks DisconnectedQuick Debug Checklist