When product or category changes in Magento aren’t reflected in PureClarity recommendations, the issue is typically related to feed execution, indexing configuration, or cron job setup. This guide provides systematic troubleshooting steps.

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: Data feeds configuration with Product Indexing and Daily Feed enabled Required settings:
  • Product Indexing Enabled: Yes
  • Daily Feed Enabled: Yes
Product indexing enables real-time updates while daily feeds provide comprehensive backup synchronization.
If settings are incorrect:
  1. Change to “Yes” for both settings
  2. Save configuration
  3. Clear configuration cache
  4. Test with a product change
For detailed configuration information, see Data Feeds & Indexing Configuration.

2. Verify Indexer Configuration

Check that PureClarity indexers are properly configured:
  1. Navigate to System > Index Management
  2. Locate PureClarity indexers in the list
  3. Verify they’re set to “Update by Schedule”
PureClarity indexers set to Update by Schedule in Magento indexer management If indexers are set to “Update on Save”:
  1. Select PureClarity indexers
  2. Change mode to “Update by Schedule”
  3. Save changes
  4. 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
Standard Magento cron setup:
* * * * * php /path/to/magento/bin/magento cron:run 2>&1 | grep -v "Ran jobs by schedule"
* * * * * php /path/to/magento/bin/magento cron:run --group=index 2>&1 | grep -v "Ran jobs by schedule"
Manual cron testing:
cd /path/to/magento
php bin/magento cron:run
If cron jobs aren’t set up, follow the Magento cron documentation for proper configuration.
Temporary solution for testing: Run cron manually to process pending feed updates:
php bin/magento cron:run

4. Monitor Cron Job Execution

Check cron job execution in Magento:
  1. Navigate to System > Tools > Cron
  2. Review recent cron job execution
  3. Look for PureClarity-related jobs
  4. Check for any error messages
Common PureClarity cron jobs:
  • 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
Common error patterns to look for:
  • Authentication failures (invalid credentials)
  • Network connectivity issues
  • Memory or timeout errors
  • Data validation problems
Example log analysis:
cd /path/to/magento
grep -i pureclarity var/log/system.log | tail -20
For comprehensive error troubleshooting, see Feed Error Troubleshooting.

6. Check Feed Status

Monitor feed execution status in the Magento admin:
  1. Navigate to PureClarity > Dashboard
  2. Review the Data Feeds panel
  3. Check last execution times and status
Status indicators:
  • Green with date - Successfully completed
  • Orange/Yellow - In progress or waiting
  • Red - Error requiring attention
PureClarity dashboard showing feed status indicators For detailed status interpretation, see Feed Status Guide.

Manual Testing

7. Test Manual Feed Execution

Force feed execution to test the system:
  1. Navigate to PureClarity Dashboard in Magento admin
  2. Click “Run Feeds Manually”
  3. Select Product and Category feeds
  4. Click “Run feeds now”
  5. 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:
  1. Make a simple product change (e.g., update product name)
  2. Save the product
  3. Wait 2-3 minutes for indexing to process
  4. Check feed status for updates
  5. Verify change appears in PureClarity admin
What to look for:
  • 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:
SELECT * FROM pureclarity_product_queue ORDER BY updated_at DESC LIMIT 10;
SELECT * FROM pureclarity_category_queue ORDER BY updated_at DESC LIMIT 10;
Cron schedule status:
SELECT * FROM cron_schedule WHERE job_code LIKE '%pureclarity%' ORDER BY scheduled_at DESC LIMIT 10;
Look for:
  • 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
Server resources:
  • 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

  1. Correct configuration settings
  2. Clear all caches
  3. Restart cron jobs
  4. Test manual feed execution

For Indexer Problems

  1. Set indexers to “Update by Schedule”
  2. Reindex PureClarity indexers
  3. Clear indexer locks if stuck
  4. Monitor subsequent changes

For Cron Issues

  1. Verify cron setup on server
  2. Check cron execution in Magento
  3. Clear stuck cron jobs if necessary
  4. Test manual cron execution

For Feed Errors

  1. Review error logs for specific issues
  2. Check credentials and connectivity
  3. Verify data integrity in feeds
  4. 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
Information to provide:
  • Magento version and edition
  • PureClarity extension version
  • Recent changes to configuration
  • Error log excerpts
  • Feed status screenshots
  • Cron job configuration details

Configuration Guides

Troubleshooting Guides

Performance Optimization