Here are troubleshooting tips for common issues with the Magento 1.x PureClarity integration.

​
Feed Issues

​
Why Are My Feeds Failing?

Check Server Connectivity and Credentials:
  • Ensure your server can talk to the PureClarity servers
  • Verify your AccessKey, SecretKey and Region are correct
Enable Debug Logging: You can activate Debugging under System > Configuration > Developer > Debug and enable “Log Settings”. Check the var/debug.log for additional information as to why the feed may not be working.
The debug log will show detailed error messages that can help identify specific connectivity or authentication issues.

​
Zone Display Issues

​
Why Are the BMZs Not Showing?

Check Basic Configuration:
  • Verify everything is enabled in the PureClarity configuration
  • Ensure zones are being rendered to the screen
Enable Debug Mode: Enable Debugging by switching Debug Mode from the Advanced section on the PureClarity Configuration page, to see if the BMZs show the BMZ Ids on the front end. If BMZs Are Rendered But Not Populated:
  • Ensure that the BMZs are configured in the PureClarity admin console under settings
  • Check that you have active merchandising campaigns set up
If BMZs Are Not Being Rendered At All:
  1. Check that other types of Widget can be displayed on the site (e.g. a CMS Static Block)
  2. If not, there is likely an issue with the theme
  3. Try removing any content from the Layout and Default fields at System > Configuration > General > Design
  4. Re-test a basic Widget against different themes you have listed
  5. If the Widget now displays, it indicates an issue with the theme you were using
If widgets aren’t working at all, the issue is likely with your Magento theme rather than the PureClarity extension.
Alternative Approach: An alternative approach to displaying BMZs would be to embed them directly within the theme if widgets aren’t working properly.

​
Data Sync Issues

​
My Products/Categories Aren’t Updating

Check Feed Configuration:
  • Ensure that Daily and Index feeds are enabled on the PureClarity Configuration page
  • Verify that your Index Management contains the PureClarity Indexes
  • Confirm that your indexing Cron jobs are running
Data synchronization relies on both the feeds being enabled and the Magento cron jobs running properly to process the index updates.
Verify Cron Job Status: Check that Magento’s cron jobs are running correctly, as PureClarity relies on these for data synchronization.

​
Customer-Specific Pricing

​
How Do I Show Customer Specific Prices?

Currently, PureClarity only supports customer specific pricing in Server Side Mode, and the PureClarity Magento 1.x extension does not support the server-side method.
Read the Implementation Methods section of our documentation for further information on server side mode.

​
General Debugging Tips

​
Debug Mode Benefits

When Debug Mode is enabled, you can:
  • See BMZ IDs displayed on the frontend
  • Identify which zones are being loaded
  • Check if zones are properly configured
  • Verify that PureClarity JavaScript is loading correctly

​
Common Resolution Steps

  1. Clear Magento Cache: Always clear cache after making configuration changes
  2. Check Error Logs: Review both Magento logs and PureClarity debug logs
  3. Verify Permissions: Ensure proper file permissions for the extension
  4. Test in Different Browsers: Sometimes browser caching can hide updates

​
Getting Additional Help

If you continue to experience issues after following these troubleshooting steps:
  1. Enable debug mode and gather any error messages
  2. Check the feed status in your PureClarity admin console
  3. Contact support at support@pureclarity.com with:
    • Your Magento version
    • PureClarity extension version
    • Description of the issue
    • Any error messages from debug logs
When contacting support, providing detailed information about your setup and any error messages will help resolve issues more quickly.