Section 2: Review Queue & Approval Workflow
Purpose of the Review Page
The Review page is the primary quality-control checkpoint in CatalogPilot.
Its role is to give merchants fast, low-cognitive confirmation that enriched product data is accurate, improved, and safe to approve — without requiring deep technical review or repetitive editing.
This page is intentionally designed to:
- Minimize cognitive load
- Encourage visual comparison rather than line-by-line validation
- Reinforce trust in the enrichment system
- Make bulk approval the normal and safe action
CatalogPilot assumes that merchants want control, not busywork.
Review Status Overview (Top Counters)
At the top of the Review page, merchants see a summary of items awaiting review:
- Products Awaiting Review
- Images Awaiting Review
- Variants Awaiting Review
- Categories Awaiting Review
These counters represent items that have completed enrichment and are pending merchant approval.
Important:
Not every enriched object appears here.
Many records (such as inherited variant data or category-level metadata) are derived from already-approved sources and do not require redundant review.
Review Queue Tabs
The Review Queue is divided into four tabs:
- Products (primary focus)
- Variants
- Images
- Categories
Product Tab (Primary Review Focus)
The Products tab is the only tab most merchants need to meaningfully review.
This tab displays enriched versions of product-level content that merchants are already familiar with from their eCommerce platform, including:
- Product Title
- Description
- Meta Title & Meta Description
- Structured headings (H1, H2, H3)
These fields represent the largest and most visible change compared to the original catalog and are where merchants will most easily recognize value.
Original vs Enriched Comparison
CatalogPilot provides two levels of comparison controls:
- Global toggle buttons (Original / Enriched)
- Per-section toggles (for Products, Variants, Images, Categories)
These toggles allow merchants to quickly switch between:
- Original — the data as it existed in the platform
- Enriched — the AI-generated, optimized version
The intent is visual validation, not forensic inspection.
Merchants are encouraged to:
- Scroll through the Product list
- Toggle Original ↔ Enriched
- Confirm that the enriched content is clearly more complete, descriptive, and structured
This comparison can typically be completed in seconds per product.
Edit vs Approve
Each product row includes two actions:
- Approve (Primary action)
- Edit (Secondary, intentionally de-emphasized)
Edit Button (Use Sparingly)
The Edit option exists for edge cases only.
Using Edit:
- Increases cognitive load
- Interrupts batch-level review flow
- Is unnecessary for the vast majority of products
CatalogPilot strongly encourages merchants to approve unless something is clearly incorrect.
The system is designed to avoid drift, hallucination, or destructive changes.
Editing is always available.
Even after approval, merchants can edit any enriched field at any time from the product view. Approval simply enables delivery and visibility — it does not lock content. This allows merchants to move quickly into the main product view, review everything at a glance, and make targeted edits only if needed.
Variants Tab (Verification Only)
The Variants tab is intended for confirmation, not review.
What merchants should look for:
- Variants match the parent product
- Attributes such as size, color, or style are correctly represented
What merchants do not need to do:
- Edit variant descriptions
- Manually review repeated content
- Validate every variant independently
Why This Works
CatalogPilot builds independent structured records for each variant while inheriting approved product data.
This allows:
- Each variant to be indexed independently
- Improved long-tail discoverability
- Amplified schema coverage without duplication risk
Images Tab (ADA & Descriptive Validation)
The Images tab shows enriched image metadata, including:
- Image titles
- Alt text (ADA / WCAG)
- Descriptive captions
Merchants should:
- Glance to confirm descriptions are accurate
- Ensure imagery is clearly described
- Avoid over-editing unless something is factually wrong
The image enrichment system is designed to be:
- Highly consistent
- Stylistically aligned
- Safe for accessibility and search engines
Categories Tab (Search & Discovery Optimization)
The Categories tab reflects metadata generated for category-level discovery.
Most merchants do not have native access to category SEO fields in their platform.
Category enrichment is:
- Primarily for search engines and crawlers
- Not intended for frequent human editing
- Safe to approve as a group
This is one of the key ways CatalogPilot improves site-wide discoverability beyond product pages.
Approve All (Primary Action)
At the top of the Review Queue is the Approve All button.
This is the expected and encouraged action.
When clicked:
- All currently reviewed items are approved instantly
- Approved content becomes eligible for delivery
- Merchants can immediately navigate to live product pages to see results
Approval does not wait for background jobs to complete; it acts on finalized records only.
Partial Visibility Is Intentional
Not all enriched records appear in the Review Queue.
This is by design.
CatalogPilot avoids:
- Redundant review
- Re-approval of inherited data
- Cognitive overload
Only records that introduce new or materially changed information are surfaced for review.
Summary: How Merchants Should Use Review
- Open the Review page
- Focus on the Products tab
- Toggle Original ↔ Enriched
- Scroll and visually confirm improvements
- Click Approve All (recommended for most cases)
- Move on — detailed edits can be made later from the full product gallery view if needed
For most merchants, this entire process takes minutes, not hours.
