Items

Overview

The Items View is the central hub for viewing and managing all product items across your feeds. It provides a unified view of your data by intelligently merging items from multiple feeds using a configurable merge key and includes a powerful Diagnose Tab for troubleshooting individual items.

---

Key Features

Items Tab

Multi-Feed Data Merging

Items from multiple feeds are automatically merged into a single unified view based on a merge key field (e.g., id, sku, product_id).

• Merge Logic
  • The first feed's values take priority
  • Missing or empty fields are filled from subsequent feeds
  • Each field tracks its original source feed
• Field Source Tracking
  • Displays the source feed per field using color-coded badges

---

Merge Key Configuration

• Auto-Detection of common identifiers: id, product_id, sku, article_number, ean, gtin, upc, item_id, asin
• Manual Override via the Project Fields page
• Items without valid merge keys are treated as unmatched

---

Search & Filtering

• Full-text search across visible columns
• Issue-based filtering via Health Score dashboard links
• Active filters shown as removable badges

---

Column Visibility

• Toggle individual columns
• Quick All / None actions
• Session-based persistence

---

Pagination

• Page size options: 25, 50, 100, 250
• Displays the current position and total count
• Keyboard-friendly navigation

---

Item Detail Modal

Clicking an item opens a detailed modal with:

• All field values
• Source feed indicators
• Empty field markers

---

Diagnose Tab

The Diagnose Tab is a debugging tool for understanding how individual items are processed.

Diagnostic Sections

Feed Sources

• Lists all feeds contributing to the item
• Shows Project Field → Source Column → Value
• Helps trace data origin

---

Rule Impact

• Displays applied transformation rules
• Shows Original Value → Transformed Value
• Indicates whether rules were applied or skipped
• Visual distinction between applied and skipped rules

---

Validation Errors

• Validates items against all channel templates
• Shows Channel, Field, Current Value, and Issue
• Displays "All valid" when no issues are detected

---

How It Works

Data Flow

┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ Feed 1          │ │ Feed 2          │ │ Feed N          │
│ (CSV/XML)       │ │ (CSV/XML)       │ │ (CSV/XML)       │
└────────┬────────┘ └────────┬────────┘ └────────┬────────┘
│                 │                 │
▼                 ▼                 ▼
┌─────────────────────────────────────────────────────────────────┐
│ Field Mappings Applied                                      │
│ (Source Column → Project Field)                             │
└─────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ Merge by Key Field                                        │
│ (Items with same key value combined, gaps filled)           │
└─────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ Items View (Unified)                                      │
│ + Diagnose Tab Analysis                                    │
└─────────────────────────────────────────────────────────────────┘

Merge Priority

• First feed (newest by creation date) has priority
• Only empty or null fields are overwritten
• Existing values are never replaced

---

Limitations

Performance Limitations

Limitation	Details
Initial Load Limit	First 250 items load immediately
Search Scope	Client-side search on loaded items only
Diagnose Search Limit	Limited to first 100 matches
Large Datasets	Slower rendering with 10,000+ items

---

Merge Key Limitations

Limitation	Details
Single Key Only	One merge key per project
Case Sensitivity	Case-sensitive after trimming
Empty Keys	Items with empty keys are not merged
Unmatched Items	Appear as separate entries

---

Diagnose Tab Limitations

Limitation	Details
Global Rules Only	Channel-specific rules not shown
Static Analysis	No historical rule changes
All Templates Validated	May show irrelevant errors
Condition Evaluation	Limited operator support
No Export Preview	Final export values not shown

---

Data Display Limitations

Limitation	Details
Value Truncation	Long values truncated in table
No Inline Editing	Edits must be done at source
Memory Usage	Large feeds may impact browser memory

---

Best Practices

1. Set merge key early
2. Use consistent identifiers
3. Check Diagnose tab regularly
4. Resolve issues before exporting

---

Hands-On Tutorial

For a step-by-step guide on searching and filtering items, customizing columns, and diagnosing feed sources, check out our Search & Filter Items Tutorial.

---

Related Features

• Project Fields
• Transformation Rules
• Exports
• Health Score