Troubleshooting Common Issues
Quick solutions to common problems you might encounter while using HeyBoss. Find answers, fix errors, and get back to building fast.
Can't find your issue? Contact HeyBoss Support for personalized help.
Preview and Publishing Issues
Preview Not Loading
Problem: Preview shows loading spinner forever or displays a blank screen.
Solutions:
Check your internet connection - Ensure stable connectivity
Clear browser cache - Ctrl+Shift+Delete (Chrome/Edge) or Cmd+Shift+Delete (Mac)
Try incognito/private mode - Rules out extension conflicts
Disable browser extensions - Ad blockers can interfere
Wait a moment - Complex projects may take 10-30 seconds to load
Check for build errors - Look for error messages in chat or notifications
If preview still doesn't load after 60 seconds, try regenerating the project or contact support.
Published Site Shows 404 Error
Problem: Your published site shows \"404 Not Found\" or \"Page doesn't exist\".
Solutions:
Wait 1-2 minutes - Publishing takes time to propagate
Check the URL - Ensure you're using the correct published URL
Verify project is published - Check project status shows \"Published\"
Try re-publishing - Click Publish button again
Clear DNS cache - Run \"ipconfig /flushdns\" (Windows) or \"sudo dscacheutil -flushcache\" (Mac)
Custom Domain Not Working
Problem: Your custom domain shows errors or doesn't connect.
Solutions:
Check DNS settings - Verify you added the correct CNAME or A record
Wait for DNS propagation - Can take 24-48 hours (usually 1-2 hours)
Verify domain ownership - Ensure you completed verification
Check SSL certificate - May take up to 24 hours to provision
Test with DNS checker - Use whatsmydns.net to check propagation
See our Custom Domains guide for detailed setup instructions.
Building and Editing Issues
AI Keeps Generating Wrong Results
Problem: AI doesn't understand your requests or produces incorrect output.
Solutions:
Be more specific - Instead of \"make it better\", say \"increase font size to 18px, use blue color #3B82F6\"
Provide examples - Include URLs of designs you like
Break down complex requests - Ask for one thing at a time
Use reference images - Upload screenshots or mockups
Rephrase your prompt - Try explaining differently
Provide context - Explain what you're trying to achieve and why
Quick Edit Button Not Working
Problem: Can't click elements in Quick Edit mode or changes don't save.
Solutions:
Refresh the page - Ctrl+R or Cmd+R
Exit and re-enter Quick Edit - Toggle Quick Edit mode off and on
Try different browser - Test in Chrome, Firefox, or Safari
Check if element is editable - Some complex components require AI Edit
Clear browser cache - Cached files may interfere
Changes Not Appearing
Problem: You made changes but they don't show in preview.
Solutions:
Wait for processing - AI changes take 5-30 seconds
Check for errors - Look for error messages in chat
Refresh preview - Click refresh icon in preview window
Force reload - Ctrl+Shift+R (Windows) or Cmd+Shift+R (Mac)
Verify changes were submitted - Check chat history confirms your request
Can't Undo Changes
Problem: Undo button doesn't work or isn't available.
Solutions:
Use Version History - Revert to any previous version from project history
Request AI to undo - Say \"undo the last change\" in chat
Manually reverse - Use Quick Edit to change back manually
Restore from backup - If you saved a version, restore it
Pro tip: Save important versions before making major changes. Go to History → Note current version number.
Credit and Billing Issues
Credits Not Deducting
Problem: Used features but credits didn't decrease.
Explanation:
Quick Edit is FREE - Never uses credits
Preview is FREE - Viewing projects doesn't consume credits
Chat without changes is FREE - Only actual code generation uses credits
Credits may update delayed - Refresh page to see current balance
Ran Out of Credits Mid-Project
Problem: Credits ran out while building.
Solutions:
Purchase more credits - Go to Billing → Buy Credits
Enable auto-recharge - Set up automatic credit purchasing
Use Quick Edit - Free editing doesn't require credits
Upgrade plan - Higher plans include more monthly credits
Payment Failed
Problem: Credit card declined or payment error.
Solutions:
Check card details - Verify number, expiration, CVV correct
Contact your bank - Some banks block online payments
Try different card - Use another payment method
Check billing address - Must match card's billing address
Use PayPal - Alternative payment option if available
Performance Issues
Site Loading Slowly
Problem: Your published site takes too long to load.
Solutions:
Optimize images - Compress images before uploading (use TinyPNG, Squoosh)
Remove unused features - Disable plugins or features you don't use
Simplify animations - Complex animations slow mobile performance
Reduce large libraries - Avoid adding heavy JavaScript libraries if not needed
Use lazy loading - Load images only when visible
Good image size: Under 200KB for photos, under 50KB for icons/logos. Aim for total page size under 3MB.
Editor Lagging or Slow
Problem: HeyBoss editor responds slowly or freezes.
Solutions:
Close other tabs - Free up browser memory
Restart browser - Clear temporary data
Check internet speed - Minimum 5 Mbps recommended
Disable browser extensions - Extensions can slow performance
Update browser - Use latest Chrome, Firefox, or Safari
Try different time - May be temporary server load
Integration and Plugin Issues
Plugin Not Installing
Problem: Plugin installation fails or doesn't appear.
Solutions:
Check compatibility - Verify plugin works with your project type
Refresh page - Reload to see installed plugins
Try installing again - May be temporary issue
Check for conflicts - Some plugins don't work together
Contact plugin developer - Report issue to plugin creator
Stripe Payment Not Working
Problem: Stripe checkout fails or doesn't process payments.
Solutions:
Verify Stripe keys - Check publishable and secret keys are correct
Test mode vs Live mode - Ensure using correct keys for environment
Check Stripe dashboard - Look for error messages in Stripe logs
Verify webhook URL - Must point to correct callback endpoint
Test with test card - Use Stripe test card 4242 4242 4242 4242
Email Forms Not Sending
Problem: Contact forms submitted but emails not received.
Solutions:
Check spam folder - Emails may be filtered
Verify email address - Ensure correct destination email configured
Check form settings - Confirm email notifications enabled
Test with different email - Try another email address
Check email service limits - May have daily sending limits
Verify SMTP settings - If using custom email server
Google Analytics Not Tracking
Problem: Analytics not showing data or visitors.
Solutions:
Check tracking code - Verify GA tracking ID is correct (format: G-XXXXXXXXXX or UA-XXXXXXXXX)
Wait for data - Can take 24-48 hours for first data
Test with real-time - Visit your site and check GA Real-time reports
Disable ad blockers - Your ad blocker may prevent tracking
Check domain matches - GA property should include your domain
Database and Data Issues
Database Connection Failed
Problem: Can't connect to or access database.
Solutions:
Check database settings - Verify connection string is correct
Verify database exists - Ensure database/table was created
Check permissions - Database user needs read/write access
Test connection - Use database testing tool
Check firewall - Database host may block connections
Data Not Saving
Problem: Form submissions or data entries not saving to database.
Solutions:
Check form validation - Required fields must be filled
Verify database schema - Columns must match form fields
Check error messages - Look for validation or database errors
Test with simple data - Try minimal test entry
Check database limits - May have storage or row limits
Account and Access Issues
Can't Log In
Problem: Login fails or \"invalid credentials\" error.
Solutions:
Reset password - Use \"Forgot Password\" link
Check email spelling - Verify exact email address used at signup
Clear browser cache - Cookies may be corrupted
Try incognito mode - Rules out cache/cookie issues
Check caps lock - Passwords are case-sensitive
Use correct login method - Google SSO vs email/password
Project Not Found
Problem: Can't find your project in dashboard.
Solutions:
Check all pages - Scroll through entire project list
Use search - Search by project name
Check archive - Project may be archived
Verify account - Ensure logged into correct account
Check workspace - May be in different workspace
Collaborators Can't Access Project
Problem: Team members can't see or edit shared project.
Solutions:
Verify invitation sent - Check collaborator email received invite
Check permissions - Ensure correct access level granted (view/edit)
Resend invitation - Try inviting again
Check email spam - Invitation may be in spam folder
Verify plan supports collaboration - Some plans have limits
Mobile and Browser Issues
Site Not Responsive on Mobile
Problem: Site looks broken or doesn't adapt to mobile screens.
Solutions:
Request mobile optimization - Ask AI to \"make this mobile-responsive\"
Use responsive templates - Start with mobile-ready templates
Test different devices - Check various screen sizes
Fix fixed widths - Replace px with % or rem for flexible sizing
Adjust breakpoints - Request specific mobile breakpoint adjustments
Feature Works on Desktop But Not Mobile
Problem: Specific feature fails on mobile devices.
Solutions:
Ask AI to \"fix this feature for mobile\"
Simplify the feature for mobile
Use mobile-specific alternatives
Check for touch vs click interactions
Test on real device (not just preview)
Browser Compatibility Issues
Problem: Site works in Chrome but not Safari/Firefox/Edge.
Solutions:
Use modern CSS - Avoid experimental CSS features
Test in all browsers - Check Chrome, Safari, Firefox, Edge
Request cross-browser fix - Tell AI which browser has issues
Update browser - Use latest version
Avoid browser-specific code - Ask AI to use standard web APIs
Common Error Messages
\"Build Failed\"
What it means: Project couldn't compile or has syntax errors.
Solutions:
Read error message carefully - often indicates what's wrong
Revert to last working version
Ask AI to \"fix build errors\"
Check for missing imports or dependencies
Contact support with full error message
\"Rate Limited\"
What it means: Too many requests sent too quickly.
Solutions:
Wait 1-5 minutes - Rate limit will reset
Batch requests - Combine multiple changes into one prompt
Slow down - Give AI time to process before next request
Upgrade plan - Higher plans have higher rate limits
\"Insufficient Credits\"
What it means: Not enough credits to complete action.
Solutions:
Purchase more credits
Use Quick Edit (free) for simple changes
Enable auto-recharge
Upgrade to plan with more credits
\"Server Error 500\"
What it means: Temporary server issue on HeyBoss's end.
Solutions:
Wait and retry - Usually temporary
Refresh page - May resolve issue
Check status page - Verify no platform-wide issues
Contact support - If persists more than 5 minutes
Getting Additional Help
Before Contacting Support
To get fastest resolution, gather this information:
Project name or URL
Exact error message (screenshot is best)
Steps to reproduce (what you did before error occurred)
Browser and OS (Chrome on Windows 11, Safari on Mac, etc.)
What you expected vs what happened
How to Contact Support
Email: [email protected]
In-app chat: Click \"?\" icon in HeyBoss
Help Center: help.heyboss.ai
Discord: Join community for peer help (if available)
Response time: Most issues answered within 24 hours. Urgent/critical issues prioritized and typically answered within 4 hours.
Emergency Issues
For critical issues affecting live sites:
Mark support ticket as \"Urgent\"
Include \"PRODUCTION ISSUE\" in subject line
Provide live site URL
Explain business impact
Include contact phone number for emergency callback
Preventive Best Practices
To Avoid Issues:
Save version before major changes - Easy rollback if something breaks
Test in preview before publishing - Catch errors early
Use Quick Edit for simple changes - Less can go wrong
Be specific in prompts - Reduces misunderstandings
Keep backups - Export code or save project versions
Update browser regularly - Latest browsers work best
Monitor credit balance - Enable auto-recharge
Read error messages - Usually tell you exactly what's wrong
Common Questions
Why is my issue not listed here?
This guide covers the most common issues. For problems not listed, please contact support with detailed information about your issue.
How do I report a bug?
Contact support with: 1) Description of the bug, 2) Steps to reproduce, 3) Expected vs actual behavior, 4) Screenshots if applicable. Bugs are prioritized and usually fixed within 1-2 weeks.
Can I get a refund if something doesn't work?
If you experience technical issues preventing you from using HeyBoss, contact support first. We'll work to resolve the issue. Refunds are handled case-by-case for unresolved critical issues.
Where can I see HeyBoss system status?
Check for platform-wide issues and maintenance windows at status.heyboss.ai (if available) or follow HeyBoss on Twitter for real-time updates.
Summary
Most issues have simple solutions:
Try basics first - Refresh, clear cache, try different browser
Read error messages - They usually explain the problem
Use documentation - Search Help Center for specific topics
Contact support - We're here to help when needed
Happy building! If you encounter issues not covered here, don't hesitate to reach out. 🚀
See also: Best Practices | Custom Domains | Version History
Need help? Contact Support anytime!