PureClarity adds several custom attributes to Magento products that enhance personalization and recommendation accuracy. These attributes provide additional context for PureClarity’s AI to deliver more relevant customer experiences.

​
Accessing Product Attributes

To configure PureClarity attributes for a product:
  1. Navigate to Catalog > Products in Magento admin
  2. Edit any product
  3. Scroll to the bottom of the product edit page
  4. Expand the “PureClarity” section
PureClarity section fields on Magento Product edit page

​
Product Attribute Fields

​
Search Tags

Purpose: Enhance search-based recommendations
Format: Comma-separated list of keywords or phrases
Use Case: Boost product relevance for specific search terms Examples:
  • Seasonal products: Summer, Beach, Vacation, Hot Weather
  • Style descriptors: Casual, Formal, Business, Weekend
  • Occasion-based: Wedding, Party, Date Night, Work
  • Trending terms: Sustainable, Eco-friendly, Organic
Search tags help PureClarity understand product context beyond standard attributes, improving recommendations for customers who search using specific terms.
Best Practices:
  • Use customer language - Think about how customers would describe the product
  • Include variations - Add plural forms and synonyms
  • Consider seasons - Add time-relevant descriptors
  • Think broadly - Include lifestyle and use-case terms

​
Exclude from Recommenders

Purpose: Remove products from all PureClarity recommendation engines
Options: Yes/No
Default: No When to exclude products:
  • Low-value items - Small accessories that dilute recommendation quality
  • Seasonal products - Out-of-season items (alternatively, use search tags)
  • Discontinued items - Products being phased out
  • Administrative products - Gift cards, services, or non-shippable items
  • Test products - Items used for internal testing
Excluded products will not appear in any PureClarity recommendations, including related products, cross-sells, and personalized recommendations.

​
New Arrival

Purpose: Flag products as recent additions to your catalog
Options: Yes/No
Default: No (automatic detection may apply) Benefits of marking new arrivals:
  • Enhanced visibility in “What’s New” campaigns
  • Fresh content for returning customers
  • Trend highlighting for fashion and seasonal items
  • Inventory promotion for newly launched products
Use new arrival status strategically for products you want to promote or test market response. This can drive interest and sales for recently added inventory.
Management strategies:
  • Time-based rotation - Update new arrival status monthly or seasonally
  • Product lifecycle - Remove new arrival status after specific time periods
  • Category focus - Highlight new arrivals in specific product categories
  • Campaign coordination - Align with marketing campaigns

​
On Offer

Purpose: Mark products as promotional or discounted
Options: Yes/No
Default: Automatic detection based on special pricing Automatic vs. Manual flagging:
  • Automatic: PureClarity detects products with special prices or catalog rules
  • Manual override: Use this field to flag products as promotional without price changes
When to manually flag products:
  • Bundle promotions - Products that are part of bundle deals
  • Marketing campaigns - Products featured in advertising
  • Clearance items - Products being cleared without price reductions
  • Strategic positioning - Products you want to promote as special
Manual “On Offer” flagging is useful when you want to treat products as promotional in recommendations without changing their actual pricing structure.

​
Attribute Impact on Recommendations

​
Search-Based Recommendations

Products with relevant search tags appear more prominently when customers search for related terms, improving the accuracy of search-driven recommendations.

​
Category Recommendations

New arrival and on-offer status influence which products are prioritized in category-based recommendations, helping promote strategic inventory.

​
Cross-Sell and Upsell

Product attributes help PureClarity understand product relationships and customer intent, improving the relevance of complementary product suggestions.

​
Personalized Recommendations

Customer behavior patterns combined with product attributes create more nuanced personalization, especially for returning customers.

​
Bulk Attribute Management

​
Using Import/Export

For large catalogs, manage PureClarity attributes via Magento’s import/export functionality:
  1. Export current products with all attributes
  2. Modify PureClarity columns in the CSV
  3. Import updated data back to Magento

​
Attribute Columns in CSV

  • pureclarity_search_tags
  • pureclarity_exclude_from_recommenders
  • pureclarity_newarrival
  • pureclarity_on_offer

​
Mass Actions

Use Magento’s mass update functionality to:
  • Bulk exclude product categories from recommendations
  • Seasonal updates for new arrival status
  • Promotional flagging for marketing campaigns
Always backup your product data before performing bulk updates to PureClarity attributes.

​
Attribute Strategy Best Practices

​
Search Tag Strategy

  • Research customer language - Use terms customers actually search for
  • Analyze search data - Review internal search logs for popular terms
  • Competitive analysis - See how competitors describe similar products
  • Regular updates - Refresh tags based on trends and seasonality

​
Exclusion Strategy

  • Quality over quantity - Focus recommendations on best-selling items
  • Regular auditing - Review excluded products quarterly
  • Performance monitoring - Track impact of exclusions on recommendation performance

​
Promotional Strategy

  • Coordinate with marketing - Align promotional flags with campaigns
  • Track performance - Monitor conversion rates for flagged products
  • Seasonal adjustments - Update promotional status for holiday seasons

​
Monitoring Attribute Effectiveness

​
Feed Validation

Verify attributes are being sent to PureClarity:
  1. Check feed status in the dashboard
  2. Review feed logs for attribute data
  3. Test recommendations to see attribute impact

​
Performance Tracking

Monitor how attribute usage affects:
  • Click-through rates on recommendations
  • Conversion rates for tagged products
  • Customer engagement with promotional items
  • Search result relevance for tagged products

​
Feed Integration

Product attributes are included in:
  • Product feeds sent to PureClarity
  • Real-time updates via indexing
  • Manual feed refreshes

​
Campaign Configuration

Attributes can be used in PureClarity campaigns for:
  • Targeted recommendations based on product flags
  • Promotional campaigns featuring on-offer products
  • Seasonal campaigns highlighting new arrivals
  • Search optimization using search tags
For more information on feed management, see Types of Data Feeds. For campaign configuration guidance, see Campaign Overview.

​
Troubleshooting Attributes

​
Common Issues

Attributes not appearing in recommendations:
  • Verify product is enabled and visible
  • Check if product is excluded from recommenders
  • Confirm feed has been sent after attribute updates
  • Review campaign configuration in PureClarity admin
Search tags not improving results:
  • Ensure tags match customer search terms
  • Check for spelling errors in tags
  • Verify feed includes search tag data
  • Test with multiple tag variations
For comprehensive troubleshooting, see Product Updates Not Working.