Troubleshooting Guide
Having trouble? This guide helps you quickly find solutions to common issues with the platform.
Quick Problem Finder
Connection Issues?
- OAuth and Connection Errors - Can't connect social accounts
- Token Expiration - "Reconnect" messages
Posting Problems?
- Posting Failures - Posts not publishing
- Scheduling Conflicts - Timing issues
Media Issues?
- Media Upload Problems - Can't upload files
- Platform Requirements - Format specifications
Performance?
- Performance Issues - Slow loading, sync delays
Common Issues by Category
Connection & Authentication
Can't Connect Platform → OAuth Errors Guide
"Token Expired" Message → Token Expiration Guide
Missing Permissions → OAuth Errors - Permissions Section
Account Not Eligible → Platform-Specific Connection Guides
Content Publishing
Post Failed to Publish → Posting Failures Guide
Scheduled Post Didn't Go Out → Scheduling Conflicts Guide
Platform-Specific Errors → Posting Failures - Platform Errors
Character Limit Exceeded → Platform Requirements
Media & Uploads
Can't Upload Image/Video → Media Upload Issues
File Size Too Large → Media Upload Issues - Size Limits
Wrong Format Error → Media Upload Issues - Format Problems
Crop Validation Failed → Media Upload Issues - Crop Errors
Performance & Loading
Platform Loading Slowly → Performance Issues Guide
Data Not Syncing → Performance Issues - Sync Delays
Browser Compatibility → Performance Issues - Browser
General Troubleshooting Steps
Before diving into specific guides, try these general steps:
1. Check Your Internet Connection
- Ensure stable internet connection
- Try refreshing the page
- Check if other websites load normally
2. Clear Browser Cache
Chrome: Settings → Privacy → Clear Browsing Data Firefox: Settings → Privacy → Clear Data Safari: Preferences → Privacy → Manage Website Data
3. Try a Different Browser
- Test in Chrome, Firefox, or Safari
- Disable browser extensions temporarily
- Try incognito/private mode
4. Check Platform Status
- Verify the social platform itself is working
- Check platform's status page:
5. Review Error Messages
- Read the full error message
- Note any error codes
- Screenshot errors for support
Platform-Specific Issues
Meta (Facebook + Instagram)
Common Issues:
- Page not appearing in list → Check admin access
- Instagram not available → Must be Business account and linked to Page
- Permission errors → Re-authorize with all permissions
- Posts fail to Instagram → Check media format and dimensions
📖 Full Guide: Meta Connection Troubleshooting
Google Business Profile
Common Issues:
- No locations found → Verify account has Owner/Manager role
- Location not verified → Complete verification process first
- Reviews not appearing → Wait for initial sync (5-10 minutes)
- Response failed → Check character limit and content guidelines
📖 Full Guide: Google Business Troubleshooting
TikTok
Common Issues:
- Video upload failed → Check format (MP4, 9:16 ratio)
- Account not eligible → Ensure account in good standing
- Analytics not showing → Wait 24-48 hours after posting
- Can't add sounds → TikTok API limitation (add sound pre-upload)
📖 Full Guide: TikTok Troubleshooting
Quick Fixes
Reset Connection
- Go to Connected Platforms
- Click Disconnect on problematic account
- Reconnect through OAuth flow
- Grant all permissions
Force Data Sync
- Go to connection settings
- Click Sync Now button
- Wait for sync to complete
- Refresh the page
Clear Local Data
// Open browser console (F12) // Run this command: localStorage.clear(); sessionStorage.clear(); // Then refresh page
Retry Failed Action
- Check error message for details
- Fix the underlying issue
- Click Retry button
- Or create/schedule post again
Getting Additional Help
If these guides don't solve your problem:
1. Search Documentation
Use the search feature to find specific topics
2. Check FAQ Section
Common questions answered in each guide
3. Contact Support
Provide the following information:
- Detailed description of the issue
- Steps you've already tried
- Screenshots of error messages
- Browser and operating system
- Account type (personal/team)
4. Community Forum
- Ask questions
- Learn from others
- Share solutions
Prevention Tips
Avoid common issues:
✅ Keep Connections Fresh: Reconnect when prompted ✅ Grant All Permissions: Don't skip OAuth permissions ✅ Follow Format Requirements: Check specs before uploading ✅ Test Small First: Try one post before bulk scheduling ✅ Monitor Status: Check publishing status regularly ✅ Stay Updated: Follow platform policy changes
Detailed Troubleshooting Guides
Dive deeper into specific issues:
- OAuth and Connection Errors - Fix authentication issues
- Token Expiration - Handle expired tokens
- Posting Failures - Resolve publishing problems
- Media Upload Issues - Fix file upload errors
- Scheduling Conflicts - Resolve timing issues
- Performance Issues - Speed up the platform
Related Resources
- Platform Connections - Connection guides
- Content Creation - Creating posts
- Platform Requirements - Format specs
- Getting Started - New user guides
Last updated: January 14, 2025