Troubleshooting
Quick solutions to common problems.
Preview Issues
Preview not loading
- Check if your site is accessible
- Verify project URL is correct
- Ensure embed script is installed
- Check browser console for errors
Preview shows old content
- Clear browser cache (Cmd+Shift+R)
- Check CDN cache settings
- Verify deployment completed
- Force refresh in Inpera
White screen in preview
- Check for JavaScript errors
- Verify CSP headers allow Inpera
- Test in incognito mode
Embed Script Issues
Script not loading
# Verify script is reachable
curl -I https://cdn.inpera.app/overlay.js
Check:
- Correct
data-project-id - Network connectivity
- Ad blocker interference
Overlay not appearing
- Confirm you're in preview mode
- Check browser console
- Verify project settings
Authentication Issues
Can't log in
- Check email/password
- Try password reset
- Disable browser extensions
- Clear cookies
SSO not working
- Verify IdP configuration
- Check SAML metadata
- Contact your IT admin
Performance Issues
Slow snapshots
- Reduce page complexity
- Check server response time
- Use smaller viewports
Comments taking long to load
- Check internet connection
- Try refreshing the page
- Contact support if persists
API Issues
401 Unauthorized
- Verify API key is valid
- Check key has required scopes
- Ensure key isn't expired
429 Rate Limited
- Reduce request frequency
- Implement backoff strategy
- Upgrade plan if needed
Common Error Messages
| Error | Solution |
|---|---|
| "Project not found" | Check project ID |
| "Access denied" | Verify permissions |
| "Connection lost" | Refresh page |
| "Snapshot failed" | Check target URL |
Still Need Help?
- Docs: Search our documentation
- Community: Join our Discord
- Support: [email protected]