Troubleshooting
Solutions to common issues and problems with Gondla
Find solutions to common issues with Gondla. Use this guide to quickly resolve problems and get back to creating content.
API Key Issues
"Invalid API Key" Error
Problem: Can't add or validate API key
Solutions:
- ✅ Copy the key again carefully (no extra spaces)
- ✅ Verify you selected the correct provider
- ✅ Check key hasn't been revoked in provider dashboard
- ✅ Ensure key format matches provider requirements
- ✅ Try generating a new key from provider
"Insufficient Quota" or "Out of Credits"
Problem: Key valid but can't generate content
Solutions:
- ✅ Add credits/balance to your provider account
- ✅ Check spending limits in provider dashboard
- ✅ Verify payment method is valid
- ✅ Use a different API key temporarily
- ✅ Wait for monthly quota reset (some providers)
"Rate Limit Exceeded"
Problem: Too many requests too quickly
Solutions:
- ✅ Wait 1-5 minutes before retrying
- ✅ Space out bulk generations
- ✅ Upgrade provider plan for higher limits
- ✅ Use different API key for distribution
Content Generation Issues
Generation Failed or Stuck
Problem: Content doesn't generate or gets stuck
Solutions:
- ✅ Check API key has credits
- ✅ Verify network connection
- ✅ Try a different AI model
- ✅ Refresh the page
- ✅ Clear browser cache
- ✅ Try in incognito/private window
Content Quality Issues
Problem: Content is off-topic, repetitive, or low quality
Solutions:
- ✅ Be more specific with topic/keyword input
- ✅ Add custom instructions for guidance
- ✅ Use higher-quality AI model (GPT-5.1, Claude Sonnet 4.5)
- ✅ Create custom outline first
- ✅ Add knowledge base context to project
- ✅ Try different tone setting
- ✅ Increase word count for more depth
Content Too Short or Too Long
Problem: Generated content doesn't match target word count
Solutions:
- AI targets word count ±10-15%
- For longer: Increase word count slider
- For shorter: Decrease word count slider
- Use "Comprehensive Guide" type for depth
- Add custom outline with more sections
AI Hallucinations or Inaccurate Information
Problem: Content contains false or made-up information
Solutions:
- ✅ Always review AI content before publishing
- ✅ Use Deep Research feature for fact-based content
- ✅ Add "cite sources" to custom instructions
- ✅ Fact-check claims manually
- ✅ Use knowledge base for accurate company info
- ✅ Try Claude Sonnet 4.5 or Perplexity models (generally more accurate)
Image Generation Issues
Images Not Generating
Problem: Images fail to generate or don't appear
Solutions:
- ✅ Verify image generation is toggled ON
- ✅ Check Replicate or Google AI key is configured
- ✅ Ensure key has sufficient credits
- ✅ Try different image model
- ✅ Check image prompt isn't blocked (policy violations)
Image Quality Issues
Problem: Images don't match content or look poor
Solutions:
- ✅ Try Flux 1.1 Pro Ultra for highest quality
- ✅ Change art style to match content
- ✅ Adjust aspect ratio
- ✅ Regenerate with different prompt
- ✅ Use Google Nano Banana Pro for text in images
Text Unreadable in Images
Problem: Text in generated images is garbled
Solution: ✅ Use Google Nano Banana Pro model specifically designed for legible text rendering
Publishing & Integration Issues
WordPress Connection Failed
Problem: Can't connect to WordPress site
Solutions:
- ✅ Verify site URL is correct (including https://)
- ✅ Check application password is copied correctly
- ✅ Ensure application passwords enabled in WordPress
- ✅ Verify user has publishing permissions
- ✅ Check WordPress site is accessible (not down)
- ✅ Test with site admin account
Shopify Connection Failed
Problem: OAuth connection to Shopify fails
Solutions:
- ✅ Complete OAuth flow without closing window
- ✅ Ensure you're logged into correct Shopify store
- ✅ Grant all required permissions
- ✅ Clear cookies and try again
- ✅ Contact Shopify support if store access issues
Google Docs Connection Failed
Problem: OAuth with Google Docs doesn't work
Solutions:
- ✅ Grant all requested Google permissions
- ✅ Use account with Google Docs access
- ✅ Complete OAuth without closing window
- ✅ Check Google account isn't restricted by organization
- ✅ Revoke and reconnect if token expired
Webflow Connection Failed
Problem: Can't connect Webflow site
Solutions:
- ✅ Verify site token is correct and not expired
- ✅ Check token has CMS write permissions
- ✅ Ensure copying entire token (no truncation)
- ✅ Generate new site token from Webflow
- ✅ Verify site is published
Publishing Failed
Problem: Content generated but publish failed
Solutions:
- ✅ Check connection is still active
- ✅ Test connection in Settings → Integrations
- ✅ Verify platform credentials haven't changed
- ✅ Check platform isn't experiencing downtime
- ✅ Review error message for specific issue
- ✅ Try publishing manually first
- ✅ Reconnect integration
SEO Audit Issues
Audit Failed to Start
Problem: SEO audit won't run
Solutions:
- ✅ Verify website URL is correct and accessible
- ✅ Check DataForSEO credits available
- ✅ Ensure site isn't blocking crawlers (robots.txt)
- ✅ Try with www/non-www variant
- ✅ Check site isn't password-protected
Audit Stuck in Progress
Problem: Audit runs indefinitely
Solutions:
- ✅ Large sites take 5-15 minutes
- ✅ Refresh page to check status
- ✅ Wait 30 minutes before assuming stuck
- ✅ Contact support if truly stuck
Missing or Incomplete Results
Problem: Audit completes but data missing
Solutions:
- ✅ Some pages may be unreadable to crawler
- ✅ Check robots.txt isn't blocking
- ✅ Ensure pages are published and public
- ✅ Try running audit again
Keyword Research Issues
Batch Generation Failed
Problem: Keyword opportunity batch doesn't generate
Solutions:
- ✅ Check competitor URLs are valid and accessible
- ✅ Verify project settings are configured
- ✅ Ensure API credits available (DataForSEO)
- ✅ Wait 2-5 minutes for AI analysis
- ✅ Try with different competitor
No Keywords Found
Problem: Batch completes but returns no keywords
Solutions:
- ✅ Ensure competitors actually rank for keywords
- ✅ Try different competitor websites
- ✅ Check your site isn't identical to competitor
- ✅ Lower opportunity score threshold
Account & Settings Issues
Can't Invite Team Members
Problem: Team invitations fail
Solutions:
- ✅ Verify you have Owner or Admin role
- ✅ Check team plan allows more members
- ✅ Ensure valid email address
- ✅ Check spam folder for invitations
- ✅ Resend invitation
Settings Not Saving
Problem: Changes to settings don't persist
Solutions:
- ✅ Click Save/Update button
- ✅ Check for error messages
- ✅ Verify network connection
- ✅ Clear browser cache
- ✅ Try different browser
Performance Issues
Slow Loading
Problem: Platform loads slowly
Solutions:
- ✅ Check internet connection speed
- ✅ Clear browser cache and cookies
- ✅ Disable browser extensions
- ✅ Try incognito/private mode
- ✅ Use modern browser (Chrome, Firefox, Safari, Edge)
- ✅ Check platform status page
Bulk Generation Very Slow
Problem: Bulk creation takes too long
Expected times:
- 10 articles: 5-8 minutes
- 25 articles: 12-18 minutes
- 50 articles: 25-35 minutes
If slower:
- ✅ Check API provider isn't rate-limiting
- ✅ Try smaller batches
- ✅ Use faster AI models (GPT-5.1 Mini, Gemini Flash)
- ✅ Disable images for faster generation
Browser Issues
Page Blank or Not Loading
Problem: Pages don't render correctly
Solutions:
- ✅ Hard refresh: Ctrl+Shift+R (Windows) or Cmd+Shift+R (Mac)
- ✅ Clear cache and cookies
- ✅ Try incognito/private window
- ✅ Update browser to latest version
- ✅ Try different browser
- ✅ Disable ad blockers
Editor Not Working
Problem: Content editor doesn't respond
Solutions:
- ✅ Refresh the page
- ✅ Try different browser
- ✅ Disable browser extensions
- ✅ Clear cache
- ✅ Check JavaScript isn't blocked
Data & Export Issues
Can't Find Generated Content
Problem: Content missing from library
Solutions:
- ✅ Check correct project selected
- ✅ Check status filters (Ready, Scheduled, etc.)
- ✅ Search by keyword
- ✅ Check Archived content
- ✅ Verify generation completed successfully
Export Failed
Problem: Can't export content
Solutions:
- ✅ Check integration connection active
- ✅ Verify export format supported
- ✅ Try exporting smaller batch
- ✅ Check browser download settings
Getting Additional Help
When to Contact Support
Contact support if:
- ✅ Error persists after trying solutions
- ✅ Account or billing issues
- ✅ Data loss or corruption
- ✅ Security concerns
- ✅ Feature requests or bugs
Before Contacting Support
Prepare:
- Description of the problem
- Steps to reproduce
- Error messages (screenshots helpful)
- Browser and OS information
- Account email address
- When the issue started
Support Resources
- FAQ - Common questions
- Best Practices - Optimize usage
- API Keys Guide - Setup help
- Contact: [your-support-email]
Common Error Messages
"Session expired"
Solution: Log out and log back in
"Network error"
Solution: Check internet connection, refresh page
"Permission denied"
Solution: Check account role/permissions
"Resource not found"
Solution: Content may have been deleted, check library
"Validation error"
Solution: Check form inputs, ensure required fields filled
Preventing Issues
Best Practices
- ✅ Keep API keys funded
- ✅ Monitor provider usage dashboards
- ✅ Test connections regularly
- ✅ Review content before publishing
- ✅ Use stable internet connection
- ✅ Keep browser updated
- ✅ Back up important content
- ✅ Don't share API keys
- ✅ Set spending alerts with providers
- ✅ Save work frequently