Quick Diagnosis Checklist
Before diving into detailed troubleshooting, check these common issues:- Recent changes made - Allow 1-2 minutes for indexing updates
- Feed status - Check dashboard for recent feed execution
- Configuration enabled - Verify feeds and indexing are turned on
- Cron jobs running - Ensure background tasks are functioning
- Error logs - Review for any error messages
Configuration Verification
1. Check Feed and Indexing Settings
Navigate to Stores > Configuration > PureClarity > Data Feeds / Indexing and verify:
- Product Indexing Enabled: Yes
- Daily Feed Enabled: Yes
Product indexing enables real-time updates while daily feeds provide comprehensive backup synchronization.
- Change to “Yes” for both settings
- Save configuration
- Clear configuration cache
- Test with a product change
2. Verify Indexer Configuration
Check that PureClarity indexers are properly configured:- Navigate to System > Index Management
- Locate PureClarity indexers in the list
- Verify they’re set to “Update by Schedule”

- Select PureClarity indexers
- Change mode to “Update by Schedule”
- Save changes
- Reindex if necessary
“Update on Save” mode can cause performance issues and may not trigger feeds correctly. Always use “Update by Schedule” for optimal performance.
Cron Job Verification
3. Ensure Cron Jobs Are Running
Cron jobs are essential for feed processing and indexing. Verify they’re properly configured: Check cron configuration:- Review your server’s crontab for Magento cron entries
- Ensure cron is running every minute
- Verify Magento cron groups are configured
If cron jobs aren’t set up, follow the Magento cron documentation for proper configuration.
4. Monitor Cron Job Execution
Check cron job execution in Magento:- Navigate to System > Tools > Cron
- Review recent cron job execution
- Look for PureClarity-related jobs
- Check for any error messages
pureclarity_feeds_product
pureclarity_feeds_category
pureclarity_feeds_user
pureclarity_indexer_process
Error Investigation
5. Review System Logs
Check Magento logs for feed-related errors: Log locations:var/log/system.log
var/log/exception.log
var/log/debug.log
- Authentication failures (invalid credentials)
- Network connectivity issues
- Memory or timeout errors
- Data validation problems
6. Check Feed Status
Monitor feed execution status in the Magento admin:- Navigate to PureClarity > Dashboard
- Review the Data Feeds panel
- Check last execution times and status
- Green with date - Successfully completed
- Orange/Yellow - In progress or waiting
- Red - Error requiring attention

Manual Testing
7. Test Manual Feed Execution
Force feed execution to test the system:- Navigate to PureClarity Dashboard in Magento admin
- Click “Run Feeds Manually”
- Select Product and Category feeds
- Click “Run feeds now”
- Monitor progress over the next few minutes
Manual feed execution helps isolate whether the issue is with automatic scheduling or the feed process itself.
8. Test Individual Product Changes
Create a controlled test to verify indexing:- Make a simple product change (e.g., update product name)
- Save the product
- Wait 2-3 minutes for indexing to process
- Check feed status for updates
- Verify change appears in PureClarity admin
- Indexer processes the change
- Feed status shows recent activity
- Changes appear in PureClarity within minutes
Advanced Troubleshooting
9. Database Investigation
For persistent issues, check database-level problems: Indexer queue status:- Stuck queue items
- Failed cron jobs
- Duplicate entries
- Processing errors
10. Memory and Performance Issues
Check for resource-related problems: PHP memory limits:- Verify adequate memory allocation
- Check for memory exhaustion errors
- Monitor during feed processing
- CPU usage during feed processing
- Database connection limits
- Disk space availability
- Network connectivity
Large catalogs may require increased memory limits and processing time. Monitor server resources during feed execution.
Resolution Steps
For Configuration Issues
- Correct configuration settings
- Clear all caches
- Restart cron jobs
- Test manual feed execution
For Indexer Problems
- Set indexers to “Update by Schedule”
- Reindex PureClarity indexers
- Clear indexer locks if stuck
- Monitor subsequent changes
For Cron Issues
- Verify cron setup on server
- Check cron execution in Magento
- Clear stuck cron jobs if necessary
- Test manual cron execution
For Feed Errors
- Review error logs for specific issues
- Check credentials and connectivity
- Verify data integrity in feeds
- Contact support if errors persist
Prevention and Monitoring
Regular Maintenance
- Weekly indexer status review
- Monthly cron job health check
- Quarterly configuration audit
- Feed performance monitoring
Monitoring Setup
- Feed status alerts for failures
- Cron job monitoring for missed executions
- Error log monitoring for issues
- Performance tracking for degradation
Best Practices
- Test changes in staging environments
- Monitor after updates to Magento or extensions
- Document configuration for troubleshooting reference
- Keep backups of working configurations
When to Contact Support
Contact PureClarity support if:- Configuration appears correct but feeds still fail
- Error messages are unclear or technical
- Performance issues persist after optimization
- Data corruption is suspected in feeds
- Magento version and edition
- PureClarity extension version
- Recent changes to configuration
- Error log excerpts
- Feed status screenshots
- Cron job configuration details
Related Resources
Configuration Guides
- Data Feeds & Indexing - Complete configuration reference
- When Data Feeds Run - Understanding feed timing
- Feed Status - Status interpretation guide
Troubleshooting Guides
- Feed Error Troubleshooting - Specific error resolution
- Zone Troubleshooting - Zone display issues
- Magento Logs - Log analysis and debugging
Performance Optimization
- Dashboard Overview - System monitoring
- Configuration Mode - Performance considerations