Troubleshooting
Solutions to common problems and issues with Syntaq Falcon.
🔍 Quick Problem Finder
| Problem | Solution |
|---|---|
| Form won't save | Common Issues |
| CSS not applying | Customization Issues |
| Access token not working | Security Issues |
| Slow performance | Performance Tips |
| Browser compatibility | Browser Compatibility |
| Embedded form issues | Embedding Issues |
📋 Troubleshooting Guides
Common Issues (coming soon)
General problems and solutions
Topics covered:
- Login and authentication issues
- Data not saving
- Features not loading
- Page errors
- Network connectivity
- Session timeouts
Error Messages (coming soon)
Understanding and resolving error messages
Topics covered:
- Error message reference
- Common error codes
- Resolution steps
- When to contact support
- Error logging
Performance Tips (coming soon)
Optimize Syntaq Falcon performance
Topics covered:
- Slow form loading
- Large file uploads
- Browser performance
- Network optimization
- Cache management
- System requirements
Browser Compatibility (coming soon)
Browser-specific issues and solutions
Topics covered:
- Supported browsers
- Browser-specific bugs
- Compatibility modes
- Mobile browsers
- Browser settings
- Extensions and plugins
→ View Browser Compatibility Guide
🎯 Troubleshooting by Category
📝 Form Issues
Form won't save
- Check required fields are filled
- Verify field validation
- Check browser console for errors
- Clear browser cache
- Try a different browser
Form fields not displaying correctly
- Check CSS customization
- Verify field configuration
- Test in different browsers
- Check responsive design
- Review error logs
Validation errors
- Verify validation rules
- Check field requirements
- Test with valid data
- Review error messages
- Check date/time formats
🎨 Customization Issues
CSS not applying
- Check selector specificity
- Verify CSS syntax
- Clear browser cache
- Check for conflicts
- Review deployment status
Styles look different on mobile
- Add responsive CSS
- Test on actual devices
- Check viewport meta tag
- Review media queries
- Test different screen sizes
Custom fonts not loading
- Verify font URL
- Check CORS settings
- Use web-safe fallback fonts
- Check font file formats
- Review browser support
🔒 Security Issues
Access token not working
- Check expiration time
- Verify token hasn't been revoked
- Confirm correct token URL
- Check usage limits
- Verify permissions
Authentication failing
- Verify credentials
- Check account status
- Review authentication method
- Check system status
- Clear cookies/cache
Permission denied errors
- Verify user permissions
- Check resource access
- Review role assignments
- Contact administrator
- Check audit logs
🌐 Embedding Issues
Embedded form not displaying
- Verify iFrame code
- Check parent page CSS
- Review security settings
- Test in isolation
- Check browser console
iFrame sizing issues
- Set explicit dimensions
- Use responsive techniques
- Check parent container
- Test different viewports
- Review CSS conflicts
Cross-origin errors
- Check CORS settings
- Verify domain whitelist
- Review security headers
- Contact administrator
- Check browser console
⚡ Performance Issues
Slow loading
- Check network connection
- Clear browser cache
- Optimize images
- Reduce CSS complexity
- Check server status
File upload failing
- Check file size limits
- Verify file format
- Test network speed
- Try smaller files
- Check upload quotas
Timeout errors
- Check session timeout settings
- Verify network stability
- Reduce operation complexity
- Break into smaller tasks
- Contact administrator
🛠️ Diagnostic Tools
Browser Developer Tools
Use browser DevTools to diagnose issues
- Console: Check for errors and warnings
- Network: Monitor requests and responses
- Elements: Inspect HTML/CSS
- Application: Check storage and cookies
- Performance: Analyze loading times
How to Access DevTools
- Chrome/Edge: F12 or Ctrl+Shift+I (Cmd+Option+I on Mac)
- Firefox: F12 or Ctrl+Shift+I (Cmd+Option+I on Mac)
- Safari: Cmd+Option+I (enable Developer menu first)
🔧 Self-Service Solutions
Clear Cache and Cookies
- Open browser settings
- Navigate to Privacy/Clear browsing data
- Select cookies and cached files
- Choose time range (Last hour recommended)
- Clear data and restart browser
Test in Incognito/Private Mode
- Open incognito/private window
- Test the problem feature
- If it works, issue is likely browser-related
- Try clearing cache or disabling extensions
Check Browser Console
- Open developer tools (F12)
- Go to Console tab
- Look for red error messages
- Copy error text for support ticket
- Try suggested fixes
📞 When to Contact Support
Contact your administrator or support team if:
- Critical Issues: System down or data loss
- Security Issues: Potential security breach
- Repeated Problems: Issue persists after troubleshooting
- Complex Errors: Technical errors you don't understand
- Account Issues: Can't access account or data
Information to Include
When contacting support, provide:
- Detailed description of the problem
- Steps to reproduce the issue
- Error messages (exact text or screenshots)
- Browser and version
- Operating system
- Date and time of occurrence
- User account information
📚 Related Resources
FAQs
Quick answers to common questions
→ Browse FAQs
How-To Guides
Task-specific instructions
→ Browse How-To Guides
Features Documentation
Detailed feature information
→ Browse Features
Reference Materials
Technical specifications and quick lookups
→ Browse Reference
💡 Troubleshooting Tips
Systematic Approach
- Identify: Clearly define the problem
- Reproduce: Can you make it happen again?
- Isolate: Narrow down the cause
- Test: Try potential solutions
- Verify: Confirm the fix works
- Document: Note the solution for future
Common Quick Fixes
- Clear browser cache
- Try incognito mode
- Use a different browser
- Check internet connection
- Log out and log back in
- Restart your browser
Prevention
- Keep browsers updated
- Regular cache clearing
- Save work frequently
- Test in development first
- Follow best practices
📖 Additional Help
Still stuck?
- Review Getting Started Guide for basics
- Check FAQs for quick answers
- Contact your system administrator
- Submit a support ticket with details