Configuration Location
Navigate to Stores > Configuration > PureClarity to access the Environment & Credentials settings.
These settings are populated automatically when you sign up through the PureClarity dashboard page. Manual changes are rarely needed during normal operation.
Configuration Fields
Enabled
Purpose: Master switch for PureClarity functionalityOptions: Yes/No
Default: Yes (after signup) When set to “No”, PureClarity will:
- Stop displaying zones on the frontend
- Disable daily feed execution
- Stop real-time product and category indexing
- Maintain configuration but suspend all operations
Disabling PureClarity will immediately stop all personalization features and data synchronization. Use this setting carefully.
Access Key
Purpose: Public identifier for your PureClarity storeFormat: Alphanumeric string
Security: Safe to share with PureClarity support The Access Key identifies your specific PureClarity store and is used for:
- API authentication
- Feed submission
- Zone content retrieval
- Analytics tracking
Access Keys are store-specific. Each Magento store view connected to PureClarity has its own unique Access Key.
Secret Key
Purpose: Private authentication credentialFormat: Alphanumeric string
Security: Highly confidential - never share The Secret Key provides secure authentication for:
- Data feed encryption
- API request validation
- Account verification
- Secure data transmission
Never share your Secret Key with anyone outside your organization. Treat it like a password and store it securely.
Region
Purpose: Determines which PureClarity servers to connect toOptions: USA / Europe
Impact: Affects performance and data residency The region setting controls:
- Server endpoints for API calls and feeds
- Data storage location for compliance requirements
- Network latency and connection performance
- Service availability and redundancy
Choose the region closest to your primary customer base for optimal performance. This setting cannot be changed after account creation.
Configuration Sources
Automatic Configuration
Settings are populated automatically when:- Signing up through the PureClarity dashboard
- Linking existing stores during setup
- Adding additional stores to your account
Manual Configuration
Manual entry may be needed for:- Account recovery after configuration loss
- Store migration between environments
- Multi-environment setup (staging, production)
- Troubleshooting connection issues
Security Best Practices
Credential Management
- Limit access to Magento admin users who need it
- Use different credentials for staging and production
- Rotate credentials if compromise is suspected
- Document access for compliance purposes
Environment Security
- Use HTTPS for all PureClarity communications
- Restrict admin access to configuration pages
- Monitor configuration changes in admin logs
- Backup configurations before making changes
Store Secret Keys in secure password managers or documentation systems. Never include them in code repositories or unsecured documents.
Troubleshooting Connection Issues
Verification Steps
- Check credentials are correctly entered
- Verify region matches your account setup
- Test network connectivity to PureClarity servers
- Review error logs for authentication failures
Common Issues
Authentication Errors:- Incorrect Access Key or Secret Key
- Wrong region configuration
- Network connectivity problems
- Account suspension or expiration
- Invalid credentials preventing data transmission
- Region mismatch causing connection timeouts
- Firewall blocking PureClarity server access
- Access Key mismatch preventing content retrieval
- Account disabled or suspended
- Incorrect region reducing performance
Multi-Store Configuration
Store View Settings
Each Magento store view requires:- Unique Access Key for that specific store
- Corresponding Secret Key for the same store
- Correct region for your account
- Individual enable/disable control
Shared Account Benefits
Multiple stores on one PureClarity account provide:- Unified billing across all stores
- Shared analytics and reporting
- Cross-store insights and optimization
- Centralized management in PureClarity admin
While stores share an account, each maintains separate credentials and can be managed independently.
Configuration Changes
When to Update Settings
- Account migration to new regions
- Security incidents requiring credential rotation
- Store consolidation or separation
- Environment changes (staging to production)
Change Process
- Backup current settings before making changes
- Update credentials in Magento configuration
- Save configuration and clear relevant caches
- Test functionality to verify successful connection
- Monitor feeds and zones for proper operation
Post-Change Validation
- Check feed status in dashboard
- Verify zones load correctly
- Test personalization features
- Monitor error logs for issues
Related Configuration
Dependent Settings
Environment & Credentials affect:- Feed Status - Connection required for feed transmission
- Dashboard Overview - Credentials needed for data display
- Zone Configuration - Access Key required for content retrieval
Integration Points
These settings integrate with:- Data Feed Indexing - Credentials authenticate feed submission
- Zone Display - Access Key retrieves personalized content
- Analytics Tracking - Account identification for proper attribution
Support and Recovery
If you lose access to your credentials:- Contact PureClarity support with account details
- Verify account ownership through alternative means
- Request credential reset if necessary
- Update Magento configuration with new credentials
- Test full functionality after restoration
Keep your PureClarity account contact information current to facilitate credential recovery if needed.