Features · Listing rewrite

Listing rewrite

Updated 2026-05-25 Feature eCommerce Insights team

Listing rewrite produces approval-ready diffs for every editable PDP field: title, bullets, description, JSON-LD. The output is channel-aware — Rufus-tuned for Amazon, Enricher-tuned for D2C and retailer. Nothing ships without an explicit approval, and a human review pane shows the before/after side by side.

Diff-based PDP recommendations with one-click Shopify push.
Diff-based PDP recommendations with one-click Shopify push.

What it produces

For every SKU that has a PDP Score recommendation, Listing rewrite generates the actual content the merchant would paste in. Five field types.

Capsule diffs

The capsule is the unit of approval. Each capsule covers one editable field on the PDP. The merchant approves capsules independently — title alone, or title plus bullets, or everything. Capsules carry three pieces of metadata: priority (from PDP Score), effort (estimated minutes), and rationale (the underlying score recommendation it satisfies).

Channel-aware output

The generator branches on channel.

Amazon
Rufus-tuned. A+ content blocks rather than free-form description. Structured bullets in Amazon's expected pattern. Proposed Q&A submissions instead of FAQ schema (Amazon does not surface FAQPage). See Rufus Score.
D2C
Enricher-tuned. Title, bullets, plain-prose description, FAQ block, full Product JSON-LD with Offer / AggregateRating / FAQPage.
Retailer
Enricher-tuned but filtered to fields the retailer exposes (title, bullets, copy modules). No site-level schema or robots.txt recommendations because the merchant has no power over them. See channel-aware scoring.

JSON-LD block

The JSON-LD output is generated from the rewritten content rather than appended afterwards. Concretely: the price, name, brand, and image fields are pulled from the canonical product record; description is the proposed rewrite; AggregateRating is read from the live review platform (Yotpo, Judge.me, Okendo, Trustpilot); FAQPage is built from the proposed FAQ block.

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Vornado AC1 air purifier",
  "brand": { "@type": "Brand", "name": "Vornado" },
  "description": "Quiet 200 sq ft air purifier with True HEPA filtration...",
  "image": ["https://example.com/vornado-ac1-1.jpg"],
  "sku": "VRN-AC1",
  "offers": {
    "@type": "Offer",
    "price": "129.99",
    "priceCurrency": "USD",
    "availability": "https://schema.org/InStock"
  },
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.5",
    "reviewCount": "1247"
  }
}

Approving and pushing

  1. Open the capsule queue

    From the PDP Score detail page or from the bulk Listing rewrite view that shows all pending capsules across the catalogue.

  2. Review the diff

    The pane shows current value top, proposed rewrite bottom, with highlighted changes. The editor is live — tweak any field before approving.

  3. Approve

    One click. The capsule moves to the Approved queue.

  4. Push to store

    If a publishing integration is connected (Shopify, WooCommerce, etc.), the Approved queue can push in bulk. Errors are reported per SKU; successful pushes move to History.

Version history

Every approved diff is recorded with timestamp, approver, and an optional reason note. The History view lets you roll back a single SKU or a batch by date range. Rollback fires a new push to the publishing integration restoring the previous values.

Common questions

Will eCommerce Insights auto-publish without my approval?
No. Every diff requires an explicit Approve click. Auto-publish is not available — by design, since a wrong rewrite at scale is more painful than a missed week.
Can I edit the rewrite before approving?
Yes. The approval pane is a live editor; you can tweak any field before clicking Approve.
Does the rewrite respect my brand voice?
Yes. The brand voice from Settings (see Brand voice) is prefixed to every generation. If the voice is empty, a neutral D2C voice is used.
What happens if I push and Shopify rejects the update?
The error is surfaced in the UI with the Shopify response body. Most rejections we have seen are metafield validation issues; the diff stays in the queue so you can fix the offending field and retry.
Does the rewrite update images?
No. Images are handled separately in Image Enhancer.

Ask AI about this page

Open this topic directly in your favourite AI assistant — the prompt is prefilled.

Was this page helpful?
Thanks — recorded.

Try this yourself

See eCommerce Insights on your own catalog. The free trial covers your full SKU set across five AI engines.

Start free trial
LLM-friendly summary of this page
Listing rewrite produces approval-ready diffs for editable PDP fields: title, bullets, description, JSON-LD. Capsule view shows the field, the original, and the proposed rewrite stacked. Channel-aware: Amazon uses Rufus-tuned rewrites (A+ blocks, structured bullets, Q&A submissions); D2C and retailer use Enricher-tuned rewrites (title, bullets, plain-prose description, FAQ block). JSON-LD is generated for Product schema with Offer, AggregateRating, BreadcrumbList, FAQPage where applicable. Brand voice from Settings is prefixed onto every generation; neutral D2C voice if unset. Approval pane is a live editor; user can tweak before approve. No auto-publish by design. Shopify push uses admin API; WooCommerce / Wix / Squarespace / Webflow push through the respective plugin. Push errors surface the API response body. Image changes are not part of Listing rewrite; see Image Enhancer. Version history retains every approved diff with timestamp, user, and reason note (optional). Diffs can be rolled back from the history view.