Troubleshooting Background Jobs #
Common issues and solutions.
Issue 1: Jobs Not Running #
Symptom: Jobs show “Not Scheduled” or never execute.
Checklist:
| Check | Solution |
|---|---|
| WP Cron enabled? | Verify in Settings > System Status |
| Action Scheduler active? | Check WooCommerce is active |
| Server cron? | Some hosts disable WP Cron |
Fix server cron: If WP Cron is disabled, set up real server cron:
- Contact hosting support
- Set cron to hit wp-cron.php every minute
Issue 2: Jobs Failing with Errors #
Symptom: Jobs run but show errors.
Common errors:
| Error | Cause | Solution |
|---|---|---|
| Memory exhausted | Large data set | Increase PHP memory |
| Database timeout | Slow queries | Contact hosting |
| Email failed | SMTP issue | Check email settings |
Issue 3: Emails Not Sending #
Symptom: Email queue grows but emails don’t send.
Checklist:
- Check email settings in Settings > Email
- Test email sending (Settings > System Status)
- Check spam folder
- Verify SMTP configuration
Issue 4: Jobs Running Too Slowly #
Symptom: Jobs take very long or time out.
Solutions:
- Increase PHP max_execution_time
- Increase PHP memory_limit
- Check database performance
- Consider better hosting
Issue 5: Duplicate Jobs #
Symptom: Same job running multiple times.
Solution:
- Go to Action Scheduler
- Find duplicate pending jobs
- Delete extras
- Jobs will self-correct on next run