> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pureclarity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Products Not Updating Troubleshooting

> Comprehensive troubleshooting guide for when product and category changes aren't appearing in PureClarity recommendations

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:

<img src="https://mintlify.s3.us-west-1.amazonaws.com/pureclarity/images/magento/data-feeds-configuration-check.webp" alt="Data feeds configuration with Product Indexing and Daily Feed enabled" />

**Required settings:**

* **Product Indexing Enabled:** Yes
* **Daily Feed Enabled:** Yes

<Note>
  Product indexing enables real-time updates while daily feeds provide comprehensive backup synchronization.
</Note>

**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](/integrations/magento/magento-2/data-feeds-indexing).

### 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"**

<img src="https://mintlify.s3.us-west-1.amazonaws.com/pureclarity/images/magento/indexers-update-by-schedule.webp" alt="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**

<Warning>
  "Update on Save" mode can cause performance issues and may not trigger feeds correctly. Always use "Update by Schedule" for optimal performance.
</Warning>

## 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:**

```bash theme={null}
* * * * * 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:**

```bash theme={null}
cd /path/to/magento
php bin/magento cron:run
```

<Info>
  If cron jobs aren't set up, follow the [Magento cron documentation](https://devdocs.magento.com/guides/v2.4/config-guide/cli/config-cli-subcommands-cron.html) for proper configuration.
</Info>

**Temporary solution for testing:**
Run cron manually to process pending feed updates:

```bash theme={null}
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:**

```bash theme={null}
cd /path/to/magento
grep -i pureclarity var/log/system.log | tail -20
```

For comprehensive error troubleshooting, see [Feed Error Troubleshooting](/integrations/magento/magento-2/feeds-failing-errors).

### 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

<img src="https://mintlify.s3.us-west-1.amazonaws.com/pureclarity/images/magento/feed-status-dashboard.webp" alt="PureClarity dashboard showing feed status indicators" />

For detailed status interpretation, see [Feed Status Guide](/integrations/magento/magento-2/feed-status).

## 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

<Tip>
  Manual feed execution helps isolate whether the issue is with automatic scheduling or the feed process itself.
</Tip>

### 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:**

```sql theme={null}
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:**

```sql theme={null}
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

<Warning>
  Large catalogs may require increased memory limits and processing time. Monitor server resources during feed execution.
</Warning>

## 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

## Related Resources

### Configuration Guides

* [Data Feeds & Indexing](/integrations/magento/magento-2/data-feeds-indexing) - Complete configuration reference
* [When Data Feeds Run](/integrations/magento/magento-2/when-feeds-run) - Understanding feed timing
* [Feed Status](/integrations/magento/magento-2/feed-status) - Status interpretation guide

### Troubleshooting Guides

* [Feed Error Troubleshooting](/integrations/magento/magento-2/feeds-failing-errors) - Specific error resolution
* [Zone Troubleshooting](/integrations/magento/magento-2/zones-not-showing) - Zone display issues
* [Magento Logs](/integrations/magento/magento-2/logs) - Log analysis and debugging

### Performance Optimization

* [Dashboard Overview](/integrations/magento/magento-2/dashboard) - System monitoring
* [Configuration Mode](/integrations/magento/magento-2/configuration-mode) - Performance considerations