> ## Documentation Index
> Fetch the complete documentation index at: https://help.hoopai.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Funnel and website troubleshooting
> Common funnel and website problems in HoopAI — page not loading, domain errors, SSL issues, tracking, forms, and mobile display.
This guide covers the most common funnel and website issues in HoopAI with solutions for each.
***
## Page not loading
| Cause | Fix |
| ----------------------- | -------------------------------------------------------------------------------- |
| Page not published | Go to the funnel/website builder and click **Publish** |
| Domain not connected | Verify domain setup in Settings → Domains |
| DNS not propagated | Wait 24–48 hours after DNS changes. Check with a tool like whatsmydns.net |
| Page builder error | Clear browser cache, try a different browser, or rebuild the problematic section |
| Script or code conflict | Disable custom code temporarily to isolate the issue |
***
## Domain not connecting
Go to **Settings → Domains** and check that the required A record or CNAME is correctly configured in your DNS provider.
Remove any conflicting A, AAAA, or CNAME records for the same subdomain.
DNS changes take 15 minutes to 48 hours. Use whatsmydns.net to check propagation status.
Ensure the domain is not locked or restricted by your registrar.
***
## SSL certificate errors
| Error | Fix |
| --------------------- | -------------------------------------------------------------------------------------- |
| "Not secure" warning | SSL certificate has not been provisioned yet. Wait 24 hours after domain connection |
| Certificate expired | Usually auto-renews. If not, disconnect and reconnect the domain in Settings → Domains |
| Mixed content warning | Your page loads resources (images, scripts) over HTTP. Update all URLs to HTTPS |
| SSL not provisioning | Verify DNS records are correct. Remove any CAA records that block certificate issuance |
***
## Tracking code not firing
| Issue | Fix |
| ------------------------------ | ------------------------------------------------------------------------------------------------------- |
| Facebook Pixel not tracking | Verify the pixel ID in Settings → External Tracking. Check for ad blockers |
| Google Analytics not recording | Confirm the GA4 measurement ID is correct. Check browser extensions blocking tracking |
| Custom scripts not executing | Ensure scripts are in the correct placement (head vs body). Check browser console for JavaScript errors |
| Conversion tracking missing | Verify the tracking code is on the thank-you/confirmation page, not the form page |
***
## Form not submitting
| Cause | Fix |
| ------------------------------ | ------------------------------------------------------------------------------------------------- |
| Required fields not filled | Check which fields are marked required — users may be missing one |
| CAPTCHA blocking submissions | Test without CAPTCHA to isolate. If spam protection is too aggressive, switch to a lighter option |
| Custom code conflict | Disable any custom JavaScript on the page |
| Form action URL broken | Re-embed the form or check the form's integration settings |
| Browser extensions interfering | Test in incognito mode |
***
## Slow page speed
Compress images before uploading. Use WebP format. Target under 200KB per image. Avoid images wider than 1920px.
Simplify page design. Remove unused sections. Each element adds to load time.
Third-party scripts (chat widgets, analytics, pixels) add load time. Load non-critical scripts asynchronously or defer them.
Auto-playing videos significantly increase load time. Use a thumbnail with a play button instead.
Limit custom fonts to 2 families maximum. Each font adds a network request.
***
## Mobile display issues
| Issue | Fix |
| ------------------------ | -------------------------------------------------------------------------------------------------------- |
| Text too small on mobile | Use the mobile preview in the builder and increase font sizes for mobile |
| Elements overlapping | Check responsive settings. Some elements need separate mobile positioning |
| Horizontal scrolling | An element is wider than the screen. Check for fixed-width elements and set them to 100% width on mobile |
| Buttons too small to tap | Make buttons at least 44px tall on mobile |
| Images not scaling | Set image width to 100% on mobile in element settings |
Always preview your pages in the builder's mobile view before publishing. Test on an actual phone for the most accurate experience.
***
## 404 errors
| Cause | Fix |
| --------------------- | ------------------------------------------------------------------------------------------------- |
| Page URL changed | Update links pointing to the old URL. Set up a URL redirect in Settings → Domains → URL Redirects |
| Page deleted | Restore from the funnel builder if available, or rebuild |
| Wrong URL structure | HoopAI page URLs follow the format `yourdomain.com/funnel-path/page-path`. Verify the full URL |
| Subdirectory mismatch | Ensure the domain is connected to the correct funnel or website |
***
## Custom code conflicts
If your page breaks after adding custom code:
1. **Isolate the issue** — remove the custom code and verify the page works
2. **Check the browser console** — open Developer Tools (F12) and look for JavaScript errors
3. **Avoid jQuery conflicts** — HoopAI uses its own scripts. If you load jQuery, wrap your code in a no-conflict wrapper
4. **Use the correct placement** — tracking scripts go in the head; interactive scripts go in the body
5. **Test in incognito** — browser extensions can interfere with custom scripts