Learn how to identify, understand, and resolve common errors in WP Automator.

Common Error Types

Connection Errors

Issues connecting to WordPress sites:

Invalid Credentials

Wrong username or app password

Site Unreachable

WordPress site is down or URL changed

SSL Issues

Certificate problems or HTTPS configuration

Firewall Blocking

Security plugins or hosting firewall

Generation Errors

Problems during content generation:

OpenAI API errors - Rate limits or service issues
Content policy violations - Inappropriate content requests
Timeout errors - Generation taking too long
Invalid parameters - Wrong settings or prompts

Publishing Errors

Issues when publishing to WordPress:

Permission denied - User lacks publishing rights
Category not found - Invalid category specified
Media upload failed - Image upload problems
Post creation failed - WordPress API errors

Error Messages

Understanding Error Codes

Common HTTP status codes:

400 Bad Request - Invalid request parameters
401 Unauthorized - Authentication required
403 Forbidden - Permission denied
404 Not Found - Resource doesn't exist
429 Too Many Requests - Rate limit exceeded
500 Internal Server Error - Server problem
502 Bad Gateway - Service unavailable
503 Service Unavailable - Temporary outage

WP Automator error codes:

WP_CONNECTION_FAILED - Can't connect to WordPress
INVALID_CREDENTIALS - Wrong username/password
GENERATION_FAILED - Content generation error
QUOTA_EXCEEDED - Usage limit reached
VALIDATION_ERROR - Invalid input data

Troubleshooting Guide

Connection Issues

Verify Credentials

Check username is correct
Regenerate app password if needed
Ensure user has required permissions

Test Site URL

Confirm URL is correct (http vs https)
Check site is accessible in browser
Verify REST API is enabled

Check Security

Disable security plugins temporarily
Whitelist WP Automator IP if needed
Review .htaccess restrictions

Review Logs

Check WordPress error logs
Review hosting error logs
Look for firewall blocks

Generation Failures

When content generation fails:

Check OpenAI Status - Verify service is operational
Review Prompt - Ensure prompt follows guidelines
Reduce Length - Try shorter content first
Simplify Keywords - Use basic keywords
Check Credits - Ensure OpenAI credits available

Tip: Start with simple, short articles to test configuration before attempting complex content.

Publishing Problems

Resolve publishing issues:

Permission Issues

Ensure WordPress user has Editor or Administrator role

Category Errors

Create categories in WordPress before using them

Media Failures

Check WordPress media upload settings and limits

API Limits

Review hosting provider's API rate limits

Error Recovery

Automatic Recovery

WP Automator automatically handles:

Retry with backoff - Waits before retrying failed requests
Fallback options - Uses alternatives when available
Partial completion - Continues despite individual failures
Error isolation - Prevents cascade failures

Manual Recovery

When automatic recovery fails:

Review error details - Check console for specifics
Fix root cause - Address underlying issue
Clear and retry - Reset and try again
Contact support - If problem persists

Rate Limiting

Understanding Limits

Different services have different limits:

Service	Default Limit	Reset Period
OpenAI API	Based on tier	Continuous
WordPress API	Varies by host	Varies
Image APIs	50-500/hour	1 hour

Handling Rate Limits

When you hit rate limits:

Wait for reset period
Reduce batch size
Spread requests over time
Use different API keys

Upgrade service tiers
Implement request queuing
Optimize API usage
Cache responses

Validation Errors

Common Validation Issues

Prevent errors with proper validation:

URL format - Must include http:// or https://
App password - Must be in correct format (xxxx-xxxx-xxxx-xxxx)
Title length - Keep under 200 characters
Keyword count - Use 3-5 keywords
Word count - Between 500-3000 words

Input Sanitization

WP Automator sanitizes inputs to prevent:

SQL injection
XSS attacks
Invalid characters
Malformed data

Logging and Monitoring

Error Logs

Where to find logs:

Browser Console - JavaScript errors and API responses
Network Tab - Failed requests and responses
WordPress Debug - Enable WP_DEBUG for details
Server Logs - Check hosting error logs

Monitoring Best Practices

Regular Testing

Test connections weekly to catch issues early

Monitor Usage

Track API usage to avoid hitting limits

Review Failures

Analyze failed generations for patterns

Update Credentials

Rotate app passwords periodically

Getting Help

Self-Service Resources

Before contacting support:

Check this documentation
Review error messages carefully
Test with minimal configuration
Search for similar issues

Contacting Support

When reporting issues, include:

Error message (exact text)
Steps to reproduce
Browser and OS information
Screenshot if applicable
Time and date of occurrence

Security Note: Never share app passwords or API keys in support tickets.

Prevention Strategies

Best Practices

Minimize errors by:

Testing incrementally - Start small, scale gradually
Monitoring actively - Watch for early warning signs
Updating regularly - Keep credentials current
Backing up - Save configurations and data
Planning capacity - Ensure adequate resources

Error Handling