Skip to main content

Items

Items View​

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​

LimitationDetails
Initial Load LimitFirst 250 items load immediately
Search ScopeClient-side search on loaded items only
Diagnose Search LimitLimited to first 100 matches
Large DatasetsSlower rendering with 10,000+ items

Merge Key Limitations​

LimitationDetails
Single Key OnlyOne merge key per project
Case SensitivityCase-sensitive after trimming
Empty KeysItems with empty keys are not merged
Unmatched ItemsAppear as separate entries

Diagnose Tab Limitations​

LimitationDetails
Global Rules OnlyChannel-specific rules not shown
Static AnalysisNo historical rule changes
All Templates ValidatedMay show irrelevant errors
Condition EvaluationLimited operator support
No Export PreviewFinal export values not shown

Data Display Limitations​

LimitationDetails
Value TruncationLong values truncated in table
No Inline EditingEdits must be done at source
Memory UsageLarge 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
  • Project Fields
  • Transformation Rules
  • Exports
  • Health Score