Section 4 — Product Gallery Tab(A/B Comparison View)
Purpose of the Product Gallery
The Product Gallery is the primary confidence-building view in CatalogPilot.
This is where merchants can clearly see, at a glance, what CatalogPilot has changed, why it changed, and how that data will be interpreted by search engines and AI systems—without being required to edit or approve every individual field.
The Gallery is not a review queue and not a workflow gate.
It is a visual comparison and inspection space designed to reduce cognitive load while increasing trust.
How the Gallery Is Structured
Each product opens into a three-column comparison layout, with a clear distinction between human-facing content and machine-readable content.
Column Meaning
- Left Column — Human Context
- Represents what a human merchant traditionally recognizes:
- Product title
- Alternate title
- Short (mobile) description
- Long description
- Primary product imagery
- This column reflects the intent of the merchant and the way products were historically managed.
- Center & Right Columns — Machine Interpretation
- Represent how search engines, crawlers, and AI systems interpret the product.
- These columns contain:
- Structured SEO metadata
- ADA image descriptions
- Schema-aligned attributes
- Category, variant, and image mappings
- Subtle iconography (human vs. crawler indicators) visually reinforces this distinction.
This separation helps merchants immediately understand:
“What I write for people” vs. “What machines need to understand.”
Original vs. Approved Toggle (A/B Comparison)
At the top of the Gallery, merchants can toggle between:
- Original
- A composite of:
- Platform API data
- Existing storefront content
- Legacy SEO or app-generated metadata
- This represents the starting point before CatalogPilot enrichment.
- Approved
- CatalogPilot’s enriched, validated, and structured output.
- This is the version delivered to search engines and AI systems.
The toggle allows merchants to visually compare before and after states without editing or approving anything.
This comparison is designed to be:
- Fast
- Visual
- Intuitive
—not something that requires reading every field.
Image & ADA Review
Within the Gallery, image metadata is displayed adjacent to the image itself, including:
- Image Title
- Image Alt Text
- Image Caption
An audio icon allows merchants to hear exactly what a screen reader will read, reinforcing accessibility confidence without requiring ADA expertise.
In most cases, no editing is required.
The system uses high-accuracy visual analysis to describe images consistently and safely.
Navigation & Utilities
The Product Gallery includes several lightweight navigation and utility controls:
- Left / Right Arrows
- Navigate sequentially through products in the current list or filter.
- Collapse / Expand Control
- Collapse the Gallery to return to the tabbed product view.
- Copy to Clipboard
- Copy the product title for use elsewhere in CatalogPilot.
- Direct Storefront Link
- Open the live product page on the merchant’s storefront in a new tab.
These tools are intentionally subtle and optional.
Editing Philosophy (Important)
CatalogPilot does not lock content after approval.
Even after a product is approved:
- All fields remain editable
- Changes can be made at any time
- Updates are version-safe and non-destructive
However, merchants are not expected to edit content during the Gallery review.
The recommended flow is:
- Visually compare Original ↔ Approved
- Confirm overall improvement
- Approve
- Edit later only if desired, from the same Gallery view
This ensures momentum without sacrificing control.
What Merchants Should (and Should Not) Do Here
Recommended
- Scan visually
- Toggle Original ↔ Approved
- Confirm that enrichment is clearly better
- Move forward confidently
Not Required
- Reading every metadata field
- Editing copy line-by-line
- Reviewing variants, images, or categories in detail
Most extended data (variants, images, categories) inherits safely from approved product logic and does not require manual verification.
