QuQi

Merchant Feed And Page Parity

The feed and the product page are two representations of the same item, maintained by different teams, so they drift. The mismatch suppresses the item without touching organic ranking, which is why it goes unnoticed for months. The instinct is to work through disapprovals in the interface one at a time, but they are nearly always produced by a handful of feed rules or by fields missing from the source catalogue.

Get the skill file Let the agents run it
CATEGORY
Ecommerce SEO
FORMAT
merchant-feed-and-page-parity.md
STEPS
7
PRICE
Free - no account
WHEN TO REACH FOR THIS

Use when free product listings show far fewer items than the catalogue holds, or items get disapproved while the product pages themselves look fine.

The skill file

merchant-feed-and-page-parity.md
---
name: merchant-feed-and-page-parity
description: Use when free product listings show far fewer items than the catalogue holds, or items get disapproved while the product pages themselves look fine.
---

# Merchant Feed And Page Parity

The feed and the product page are two representations of the same item, maintained by different teams, so they drift. The mismatch suppresses the item without touching organic ranking, which is why it goes unnoticed for months. The instinct is to work through disapprovals in the interface one at a time, but they are nearly always produced by a handful of feed rules or by fields missing from the source catalogue.

## What you need first

- The current feed export plus item-level diagnostics with disapproval reasons attached
- Rendered product pages for a sample across categories, showing price and availability as a crawler sees them
- GTIN, MPN and brand coverage figures per category taken from the source catalogue, not the feed
- The tax and shipping settings configured on the merchant account

## Method

1. Count disapproved and pending items by reason before opening a single item. Two or three reasons usually account for most of the volume and they are configuration or coverage faults, not per-item ones.
2. Reconcile counts first: feed rows against sellable SKUs in the database. A feed missing a third of the catalogue is a generation fault and no attribute work matters until that is fixed.
3. Diff price and availability between feed and rendered page across the sample, comparing timestamps as well as values. Different caches on the two paths is the most common source of mismatch.
4. Fix identifier coverage at the catalogue source rather than in a feed rule. An identifier invented during a feed transformation fails validation and corrupts the record you will need later.
5. Build feed titles from your own attribute order, brand then product then the attribute buyers search by, rather than reusing the page title. Feed titles are matched against queries and truncated hard, so page title order is rarely right.
6. Write down which fields the feed is allowed to differ on. Shipping and tax belong in account settings rather than item data, and descriptions may legitimately be shorter than the page.
7. Recheck diagnostics at 14 days and watch the reason mix rather than the headline count, since clearing one reason routinely exposes a second that was masked behind it.

## What this produces

A reconciled feed with a stated field parity rule, disapprovals cleared at cause, and identifier coverage repaired in the source catalogue.

## Where this goes wrong

- Patching mismatches with feed rules while the source catalogue stays wrong, so the same errors return at the next full rebuild
- Generating placeholder identifiers to satisfy a required field, which produces disapprovals harder to diagnose than the missing field was
- Reading an account-level approval rate as health when the disapprovals sit on a few high-revenue lines
- Comparing the feed against the source HTML when price and stock are injected client-side, so the mismatch never shows up in testing

---

From the QuQi skill library - https://www.quqi.io/skills/merchant-feed-and-page-parity
Free to download · no account, no email

What you need first

  • The current feed export plus item-level diagnostics with disapproval reasons attached
  • Rendered product pages for a sample across categories, showing price and availability as a crawler sees them
  • GTIN, MPN and brand coverage figures per category taken from the source catalogue, not the feed
  • The tax and shipping settings configured on the merchant account

Method

  1. 01 Count disapproved and pending items by reason before opening a single item. Two or three reasons usually account for most of the volume and they are configuration or coverage faults, not per-item ones.
  2. 02 Reconcile counts first: feed rows against sellable SKUs in the database. A feed missing a third of the catalogue is a generation fault and no attribute work matters until that is fixed.
  3. 03 Diff price and availability between feed and rendered page across the sample, comparing timestamps as well as values. Different caches on the two paths is the most common source of mismatch.
  4. 04 Fix identifier coverage at the catalogue source rather than in a feed rule. An identifier invented during a feed transformation fails validation and corrupts the record you will need later.
  5. 05 Build feed titles from your own attribute order, brand then product then the attribute buyers search by, rather than reusing the page title. Feed titles are matched against queries and truncated hard, so page title order is rarely right.
  6. 06 Write down which fields the feed is allowed to differ on. Shipping and tax belong in account settings rather than item data, and descriptions may legitimately be shorter than the page.
  7. 07 Recheck diagnostics at 14 days and watch the reason mix rather than the headline count, since clearing one reason routinely exposes a second that was masked behind it.

What this produces

A reconciled feed with a stated field parity rule, disapprovals cleared at cause, and identifier coverage repaired in the source catalogue.

Where this goes wrong

  • Patching mismatches with feed rules while the source catalogue stays wrong, so the same errors return at the next full rebuild
  • Generating placeholder identifiers to satisfy a required field, which produces disapprovals harder to diagnose than the missing field was
  • Reading an account-level approval rate as health when the disapprovals sit on a few high-revenue lines
  • Comparing the feed against the source HTML when price and stock are injected client-side, so the mismatch never shows up in testing

Use this skill in your own AI

The download is a plain markdown file with the name and trigger in its frontmatter. Where an assistant supports skills it can load itself, that frontmatter is what it reads to decide this one applies.

Claude Code Save it as ~/.claude/skills/merchant-feed-and-page-parity/SKILL.md and Claude loads it on its own when what you are doing matches the trigger line. Put it in .claude/skills inside a project instead if the whole team should have it.
Claude Upload the file in the skills section of your settings. Once it is there it applies itself in any conversation where the trigger fits, so you do not have to remember it exists.
ChatGPT There is no skills format to install into, so paste the file contents into a Project instruction or a Custom GPT instead. It then applies to every chat in that project rather than only the one you paste it into.
Anything else Paste the markdown into the chat before your question. It works in any assistant, it just has to be pasted again each time.

Questions about this skill

When is this the right method rather than clearing disapprovals in the interface?

When free listings show far fewer items than the catalogue holds, or items are disapproved while the product pages themselves look fine. Nearly all disapprovals come from a handful of feed rules or fields missing at source, so working through them item by item clears symptoms and the next full rebuild brings the same set straight back.

What do I need before opening a single disapproval?

The current feed export with item level disapproval reasons, rendered product pages sampled across categories, identifier coverage per category taken from the source catalogue rather than the feed, and the account tax and shipping settings. Take coverage from the feed and you measure what survived transformation instead of what the catalogue holds, which is the number any fix depends on.

What does the reconciliation leave behind, and which part gets used later?

A reconciled feed with disapprovals cleared at cause, identifier coverage repaired in the source catalogue, and a written rule for which fields may legitimately differ from the page. The parity rule is what gets used again: it settles that shipping and tax belong in account settings and that a shorter feed description is not a defect, so the next drift check is quick.

Which shortcut makes the disapprovals harder to diagnose?

Generating placeholder identifiers to satisfy a required field. They fail validation, corrupt the record you will need later, and produce disapprovals harder to diagnose than the missing field was. Reading an account level approval rate as health is the quieter version of the same error, since disapprovals usually concentrate on a few high revenue lines.

More in Ecommerce SEO