Enabling Zone Debug Mode
To enable zone debug mode:- Navigate to Stores > Configuration > PureClarity
- Expand the Advanced section
- Set Debug Mode to “Yes”
- Click “Save Config”
Debug mode should only be enabled during development or troubleshooting. Always disable it on production sites before going live.
What Debug Mode Shows
When debug mode is enabled, zones that aren’t populated by PureClarity will display their identification information instead of remaining invisible.Debug Display Format
Unpopulated zones will show:- Zone Name - The descriptive name of the zone
- Zone ID - The unique identifier used in campaigns
When to Use Debug Mode
Development Scenarios
- Initial zone setup - Verify zones appear in correct locations
- Widget placement testing - Confirm layout updates work as intended
- Theme integration - Check zone positioning with custom themes
- Multi-store configuration - Validate zones on different store views
Troubleshooting Scenarios
- Missing zones - Identify if zones are placed but not populated
- Layout issues - Verify zone containers and positioning
- Campaign connectivity - Distinguish between placement and content issues
- Cache problems - Confirm zones render after cache clears
Debug mode only shows zones that are properly placed but not receiving content from PureClarity. Zones with configuration errors may not appear at all.
Interpreting Debug Information
Zone Visibility States
| Debug Display | Meaning | Next Steps |
|---|---|---|
| Zone name + ID visible | Zone placed correctly, no content | Check campaign configuration |
| Nothing visible | Zone not placed or disabled | Verify widget/layout configuration |
| Fallback content | Zone working, using backup content | Normal operation or campaign inactive |
Common Debug Scenarios
Scenario 1: Zone ID Shows- Status: Zone placement successful
- Issue: No active campaign or campaign mismatch
- Solution: Check campaign configuration in PureClarity admin
- Status: Zone not rendering at all
- Issue: Widget configuration or cache problem
- Solution: Review widget setup and clear caches
- Status: Zone shows in unexpected location
- Issue: Layout update configuration error
- Solution: Adjust widget layout settings
Debug Mode Best Practices
Development Workflow
- Enable debug mode before testing new zones
- Test all pages where zones should appear
- Document zone positions and IDs for team reference
- Disable debug mode before production deployment
Troubleshooting Workflow
- Enable debug mode to visualize zone issues
- Check zone placement on affected pages
- Verify zone IDs match campaign configuration
- Test with campaigns active and inactive
- Disable debug mode after issue resolution
Take screenshots of debug displays to document zone layouts and share with team members or support staff.
Security and Performance Considerations
Production Environment
- Never leave enabled on live sites
- Test privately before public deployment
- Use staging environments for extensive debugging
- Monitor performance as debug mode may add slight overhead
Access Control
- Limit admin access to configuration changes
- Document debug procedures for team members
- Use development copies of production data when possible
Debug information could potentially reveal site structure details to visitors. Always disable debug mode on public-facing sites.
Advanced Debugging Techniques
Browser Developer Tools
Combine debug mode with browser inspector to:- Examine HTML structure around debug displays
- Check CSS styling affecting zone appearance
- Monitor network requests for PureClarity content
- Test responsive behavior across device sizes
Debug Mode + Cache Testing
- Clear specific caches and check zone behavior
- Test with cache disabled during development
- Verify zone persistence across cache rebuilds
Related Debugging Resources
Configuration Validation
- Environment & Credentials - Verify basic setup
- Feed Status - Check data synchronization
- Dashboard Overview - Monitor system health
Zone Troubleshooting
- Why Zones Not Showing - Comprehensive zone troubleshooting
- Adding Zones Using Widgets - Widget configuration guide
- Default Zone Installation - Standard zone setup
Magento Resources
- Configuration Mode - Development vs production settings
- Magento Logs - System-level debugging information
Disabling Debug Mode
After troubleshooting:- Return to Stores > Configuration > PureClarity
- Set Debug Mode to “No”
- Click “Save Config”
- Clear relevant caches
- Verify zones display properly without debug information
Remember to clear page cache and block HTML output cache after disabling debug mode to ensure debug displays are fully removed from your site.