> ## 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.
# Product Attributes
> Understanding and configuring PureClarity-specific product attributes in Magento 2.x for enhanced personalization
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**
## 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
## Related Configuration
### 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](/integrations/magento/magento-2/types-of-feed).
For campaign configuration guidance, see [Campaign Overview](/features/campaigns/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](/integrations/magento/magento-2/products-not-updating).