Common Issues and Solutions

Updated on November 11, 2025

Quick solutions to frequently encountered problems.

Authentication Issues

“Login Failed”

Causes:

  • Incorrect email or password
  • Account not verified
  • Password expired
  • Browser cache issues

Solutions:

  1. Verify email address (check for typos)
  2. Try password reset
  3. Check email for verification link
  4. Clear browser cache and cookies
  5. Try different browser

“Session Expired”

Cause: JWT token expired (after 24 hours)

Solution:

  1. Click “Refresh Session” if prompted
  2. Or simply log in again
  3. Enable “Remember Me” for longer sessions

“Account Locked”

Cause: Multiple failed login attempts (security measure)

Solution:

  1. Wait 30 minutes for automatic unlock
  2. Or use “Forgot Password” to reset immediately
  3. Contact support if urgent

Content Generation Issues

“Insufficient Credits”

Problem: Not enough credits for generation

Solutions:

  1. Check credit balance in dashboard
  2. Purchase additional credits
  3. Use lower-cost model (switch to Groq)
  4. Reduce word count
  5. Enable auto top-up to prevent future issues

“Generation Failed”

Possible causes:

  • API timeout
  • Invalid input
  • Service temporarily unavailable

Solutions:

  1. Click “Retry Generation”
  2. Try different AI model
  3. Simplify keyword/instructions
  4. Check system status page
  5. Wait 5 minutes and retry
  6. Contact support if persists

“Poor Quality Content”

Problem: Generated content doesn’t meet expectations

Solutions:

  1. Use higher quality model:
    • Switch from Groq to Gemini or Claude
    • Premium models = better quality
  2. Improve input:
    • Use more specific keywords
    • Add detailed instructions
    • Specify desired tone
  3. Select appropriate word count:
    • Longer content (2000+ words) = more depth
    • Shorter content may lack detail
  4. Post-generation editing:
    • Review and edit AI content
    • Add unique insights
    • Enhance with examples

“Content Too Short/Long”

Problem: Generated content doesn’t match requested word count

Cause: AI models approximate word count (±10%)

Solutions:

  1. Adjust target word count:
    • Want 1,500 words? Request 1,600
  2. Use “Regenerate” with adjusted count
  3. Edit to add/remove content manually

WordPress Publishing Issues

“Connection Failed”

Problem: Can’t connect WordPress site

Checklist:

  1. ✅ Plugin installed and activated?
  2. ✅ API key copied correctly (no spaces)?
  3. ✅ Site URL correct (include https://)?
  4. ✅ WordPress REST API enabled?
  5. ✅ Firewall/security plugin allowing API?
  6. ✅ SSL certificate valid?

Solutions:

  • Test connection in plugin settings
  • Regenerate API key
  • Temporarily disable security plugins
  • Check WordPress error logs
  • Contact hosting support

“Publishing Failed”

Problem: Content generated but won’t publish to WordPress

Common causes:

Permission Issues:

  • WordPress user lacks publish permissions
  • Solution: Grant “publish_posts” capability

Plugin Conflicts:

  • Security/optimization plugins blocking
  • Solution: Temporarily disable and test

Server Timeout:

  • Large content or slow server
  • Solution: Increase PHP max_execution_time

Category/Tag Issues:

  • Invalid category or tag ID
  • Solution: Verify categories exist in WordPress

Steps to diagnose:

  1. Click “View Error” on failed post
  2. Read error message
  3. Follow suggested solution
  4. Test connection again
  5. Retry publishing

“Duplicate Content”

Problem: Same article published multiple times

Causes:

  • Clicking “Publish” multiple times
  • Network timeout causing retry
  • Scheduler duplicate

Solutions:

  1. Check WordPress for duplicate posts
  2. Delete duplicates manually in WordPress
  3. When publishing, wait for confirmation
  4. Don’t refresh page during publishing

“Wrong Site Published”

Problem: Content published to incorrect WordPress site

Prevention:

  1. Always verify selected site before publishing
  2. Double-check when publishing to multiple sites
  3. Use site groups to organize

Recovery:

  1. Delete post from wrong site (in WordPress)
  2. Republish to correct site from ContentAI
  3. Content remains in ContentAI, no credits lost

Sitemap Issues

“Sitemap Not Found”

Problem: System can’t locate site’s sitemap

Solutions:

  1. Verify sitemap exists:
    • Visit: yourdomain.com/sitemap.xml
    • If 404 error, sitemap doesn’t exist
  2. Generate sitemap:
    • Use SEO plugin (Yoast, RankMath)
    • Or WordPress default sitemap (WP 5.5+)
  3. Check robots.txt:
    • Visit: yourdomain.com/robots.txt
    • Ensure not blocking sitemap
    • Remove any “Disallow: /sitemap.xml”
  4. Use custom sitemap URL:
    • Some sites use non-standard locations
    • Enter full URL manually in ContentAI

“Crawl Timeout”

Problem: Sitemap crawl takes too long or fails

Causes:

  • Very large sitemap (1000+ URLs)
  • Slow server response
  • Temporary server issues

Solutions:

  1. For large sitemaps:
    • Normal for 1000+ URLs
    • Wait up to 2-3 minutes
    • Crawl during off-peak hours
  2. For slow servers:
    • Check hosting performance
    • Optimize WordPress (caching, etc.)
    • Consider better hosting
  3. Retry crawl:
    • Wait 10 minutes
    • Try again
    • If repeated failures, contact support

“No URLs Found”

Problem: Sitemap crawled but no URLs indexed

Solutions:

  1. Check sitemap format:
    • Must be valid XML
    • Use sitemap validator tool
    • Fix XML syntax errors
  2. Verify sitemap has URLs:
    • Open sitemap.xml in browser
    • Should list URLs with <loc> tags
    • Empty sitemap = no URLs to index
  3. Check sitemap type:
    • Some sitemaps are “indexes” pointing to other sitemaps
    • ContentAI automatically follows indexes
    • Verify nested sitemaps exist

Scheduler Issues

“Post Didn’t Publish”

Problem: Scheduled post didn’t publish at scheduled time

Check these:

  1. Credits available?
    • Scheduled posts need credits at publish time
    • If insufficient, post fails
    • Solution: Buy credits, reschedule post
  2. WordPress connection active?
    • Test site connection
    • Green status = active
    • Red status = fix connection, then reschedule
  3. Correct timezone?
    • Verify your timezone setting
    • Check WordPress timezone
    • Reschedule with correct time
  4. System status:
    • Check status page for outages
    • If system issue, posts auto-retry

View error details:

  1. Go to Scheduler → List
  2. Find failed post
  3. Click “View Error”
  4. Follow resolution steps

“Wrong Time Published”

Problem: Post published at unexpected time

Common causes:

Timezone mismatch:

  • Your timezone: EST
  • WordPress timezone: PST
  • Result: 3-hour difference

Solution:

  1. Check timezone in Settings → Profile
  2. Verify WordPress timezone setting
  3. Reschedule future posts accounting for difference
  4. Or match both timezones

Daylight Saving Time:

  • During DST changes, times may shift
  • Solution: System auto-adjusts, verify after DST

“Can’t Edit Scheduled Post”

Problem: Scheduled post locked or can’t modify

Causes:

  • Post currently publishing
  • System processing

Solutions:

  1. Wait 2-3 minutes for process to complete
  2. Refresh page
  3. If persists, cancel schedule and recreate

Keyword Research Issues

“No Results Found”

Problem: Keyword research returns no results

Solutions:

  1. Try broader keyword:
    • Instead of “best DSLR cameras under $500 for beginners”
    • Try “DSLR cameras”
  2. Check spelling:
    • Typos return no results
    • Verify keyword spelling
  3. Use English:
    • Keyword tool optimized for English
    • Translate keywords if needed
  4. Try variations:
    • Singular vs plural
    • Different phrasing

“Search Volume Shows 0”

Problem: Keyword has 0 search volume

Interpretation:

  • Doesn’t mean nobody searches it
  • Means very low volume (<10/month)
  • Consider:
    • Very niche keyword (might still be valuable)
    • Typo or uncommon phrasing
    • Try related keywords

“High Competition Score”

Problem: All keywords show 60+ competition

Understanding:

  • High competition = harder to rank
  • Not impossible, just requires more effort

Strategies:

  1. Target long-tail variations:
    • “content marketing” (90 competition)
    • → “content marketing for B2B SaaS startups” (40 competition)
  2. Build authority first:
    • Start with low-competition keywords
    • Build site authority
    • Then target harder keywords
  3. Focus on quality:
    • Even high-competition keywords rankable with:
      • Exceptional content quality
      • Strong backlinks
      • User engagement

Billing and Payment Issues

“Payment Failed”

Problem: Credit card or payment declined

Common causes:

  • Insufficient funds
  • Card expired
  • Bank security block
  • Payment processor issue

Solutions:

  1. Verify card details correct
  2. Check card expiration date
  3. Contact bank (may need to authorize)
  4. Try different payment method
  5. Use Paystack mobile app (if available)

Leave a Reply

Your email address will not be published. Required fields are marked *