Common issues

Find solutions to common technical issues and problems you might encounter while using Voxifly. This guide covers the most frequent issues and their resolutions.

Board access issues

Board not loading

Problem: Public board shows error or doesn't load Possible causes:

• Board is not published or active
• Domain configuration issues
• Browser cache problems
• Network connectivity issues

Solutions:

1. Check if board is published and active
2. Verify domain configuration if using custom domain
3. Clear browser cache and cookies
4. Check if project has proper permissions set
5. Try accessing from different browser or device

Issues not appearing

Problem: Created issues don't show up on public board Possible causes:

• Issue status not set to show on public board
• Category or status visibility settings
• Issue in draft mode
• User permission issues

Solutions:

1. Verify issue status is set to show on public board
2. Check category and status visibility settings
3. Ensure issue is not in draft mode
4. Confirm user has permission to view issues
5. Check if issue needs approval before appearing

Authentication issues

Login problems

Problem: Unable to log in to account Possible causes:

• Incorrect email or password
• Account not activated
• Two-factor authentication issues
• Browser compatibility problems

Solutions:

1. Verify email and password are correct
2. Check if account is activated
3. Check two-factor authentication setup
4. Try different browser or incognito mode
5. Use password reset if needed

Session issues

Problem: Getting logged out frequently Possible causes:

• Session timeout settings
• Browser cookie issues
• Multiple device logins
• Security settings

Solutions:

1. Check session timeout settings
2. Clear browser cookies
3. Avoid multiple device logins
4. Review security settings
5. Contact support if issue persists

Billing and subscription issues

Payment failures

Problem: Payment method fails or subscription issues Possible causes:

• Expired payment method
• Insufficient funds
• Billing provider issues
• Account limits reached

Solutions:

1. Update payment method
2. Check account balance
3. Contact billing provider
4. Review account limits
5. Contact support for assistance

Subscription not active

Problem: Subscription shows as inactive Possible causes:

• Payment failure
• Grace period expired
• Account suspension
• Billing configuration issues

Solutions:

1. Check payment status
2. Update payment method
3. Contact billing support
4. Review account status
5. Resolve billing issues

Domain and DNS issues

Custom domain not working

Problem: Custom domain not resolving or loading Possible causes:

• DNS configuration issues
• SSL certificate problems
• Domain verification issues
• Propagation delays

Solutions:

1. Verify DNS CNAME record is correct
2. Wait up to 24 hours for DNS propagation
3. Check SSL certificate status
4. Ensure domain is verified in Voxifly settings
5. Contact domain registrar if needed

SSL certificate issues

Problem: SSL certificate errors or warnings Possible causes:

• Certificate expiration
• Certificate configuration issues
• Mixed content problems
• Browser compatibility issues

Solutions:

1. Check certificate expiration date
2. Verify certificate configuration
3. Fix mixed content issues
4. Update browser if needed
5. Contact support for certificate issues

Performance issues

Slow loading

Problem: Board or dashboard loads slowly Possible causes:

• Large number of issues
• Network connectivity issues
• Browser performance problems
• Server-side issues

Solutions:

1. Check network connection
2. Clear browser cache
3. Close unnecessary browser tabs
4. Try different browser
5. Contact support if issue persists

Timeout errors

Problem: Requests timing out or failing Possible causes:

• Network connectivity issues
• Server overload
• Large data requests
• Browser timeout settings

Solutions:

1. Check network connection
2. Retry the request
3. Reduce data request size
4. Check browser timeout settings
5. Contact support if issue persists

Data and content issues

Data not saving

Problem: Changes not being saved Possible causes:

• Permission issues
• Browser compatibility problems
• Network connectivity issues
• Session timeout

Solutions:

1. Check user permissions
2. Try different browser
3. Check network connection
4. Refresh page and retry
5. Contact support if issue persists

Content not displaying

Problem: Content not showing correctly Possible causes:

• Content formatting issues
• Browser compatibility problems
• Cache issues
• Permission problems

Solutions:

1. Check content formatting
2. Clear browser cache
3. Try different browser
4. Check user permissions
5. Contact support if needed

Integration issues

Third-party integrations

Problem: Integrations not working Possible causes:

• API key issues
• Service configuration problems
• Network connectivity issues
• Service outages

Solutions:

1. Verify API keys and configuration
2. Check service status
3. Test network connectivity
4. Review integration settings
5. Contact integration provider

Webhook issues

Problem: Webhooks not firing or receiving data Possible causes:

• Webhook URL issues
• Authentication problems
• Network connectivity issues
• Service configuration problems

Solutions:

1. Verify webhook URL is correct
2. Check authentication settings
3. Test webhook endpoint
4. Review webhook configuration
5. Contact support if needed

Troubleshooting steps

General troubleshooting

1. Identify the problem: Clearly define the issue
2. Check basic settings: Verify basic configuration
3. Test in different environment: Try different browser/device
4. Clear cache and cookies: Clear browser data
5. Check network connection: Verify internet connectivity
6. Contact support: Get help if issue persists

Data collection

When contacting support, provide:

• Problem description: Clear description of the issue
• Steps to reproduce: Steps that led to the problem
• Expected behavior: What should happen
• Actual behavior: What actually happens
• Browser and device: Browser version and device type
• Screenshots: Visual evidence of the problem

Prevention tips

Regular maintenance

• Keep browsers updated: Use latest browser versions
• Clear cache regularly: Clear browser cache
• Monitor account status: Check account status regularly
• Update payment methods: Keep payment methods current

Best practices

• Use supported browsers: Use recommended browsers
• Stable internet connection: Ensure stable connectivity
• Regular backups: Backup important data
• Monitor usage: Monitor account usage and limits

Next steps

• [Performance tips] - Optimization guide
• [Getting support] - How to get help