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
Verify DNS records
Go to Settings → Domains and check that the required A record or CNAME is correctly configured in your DNS provider.
Check for conflicting records
Remove any conflicting A, AAAA, or CNAME records for the same subdomain.
Wait for propagation
DNS changes take 15 minutes to 48 hours. Use whatsmydns.net to check propagation status.
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
Large images
Large images
Compress images before uploading. Use WebP format. Target under 200KB per image. Avoid images wider than 1920px.
Too many sections or elements
Too many sections or elements
Simplify page design. Remove unused sections. Each element adds to load time.
External scripts
External scripts
Third-party scripts (chat widgets, analytics, pixels) add load time. Load non-critical scripts asynchronously or defer them.
Video auto-play
Video auto-play
Auto-playing videos significantly increase load time. Use a thumbnail with a play button instead.
Custom fonts
Custom fonts
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 |
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:- Isolate the issue — remove the custom code and verify the page works
- Check the browser console — open Developer Tools (F12) and look for JavaScript errors
- Avoid jQuery conflicts — HoopAI uses its own scripts. If you load jQuery, wrap your code in a no-conflict wrapper
- Use the correct placement — tracking scripts go in the head; interactive scripts go in the body
- Test in incognito — browser extensions can interfere with custom scripts