Editing AI-generated content

Every Product Pages optimization is editable. The AI gives you a draft; you decide what ships. This page covers the editor workflow — what’s editable, what isn’t, and when to regenerate vs. tweak by hand.

Open the editor

From the products table, click any product → click Edit in the preview. The editor shows five sections:

1. AI summary — short paragraph
2. FAQs — Q&A pairs
3. “Best for” labels — use-case tags
4. SEO description — long-form product description rewritten in customer language
5. Top review — one full customer review, shown exactly as it was written

Each section has its own edit, regenerate, and discard controls.

Edit by hand

Click Edit on any section to switch into an inline text editor. Save your changes, then Publish when you’re ready.

Saving runs the fact check again over the sections you changed. Every sentence on a product page has to trace back to one of your reviews or to your own product description, and that includes sentences you wrote — so an edit is re-checked before it can be published. One or two edited sections are checked on the spot; more than that finishes in the background, and the section shows Checking… until it’s done. A section you didn’t touch isn’t re-checked, and saving a section without changing a character doesn’t re-check it either.

Quotes have to match a review exactly. If you type a quote from memory and the wording or spelling differs from the review, the check removes it as an inexact quote — copy the words from the review instead. The content rules below (banned topics and words, one drawback per page) apply only to AI-written text; your own words are never filtered by them.

Every block in the Layout panel carries its own result: Fact-checked, Checking…, Not enough evidence, or Couldn’t be checked. If a sentence has no support in your reviews or your product description, it’s removed, and the removed sentences are listed under the block with the reason each one went. A block marked Not enough evidence offers Write it yourself, which opens that block for editing.

Content rules the AI follows

Every generation follows a few rules, so the copy stays about the product:

• No store topics. By default the AI never writes about price or value for money, sales and discounts, shipping, delivery or stock, customer service or returns, or other retailers — and FAQ items and review quotes that touch them are left out. These are on for every store. To allow a topic, or to add words the AI must never use, set ppo_content in your review settings through the Settings API.
• One drawback per page. At most one sentence or FAQ answer that raises a drawback or a “things to know before buying” point survives across the whole page.
• Enough reviews first. With only 1–2 approved reviews, the reviews summary and FAQ aren’t generated (the product features and top review still are). The page shows up to 5 items per list (features, highlights, FAQ). Products with fewer than 10 reviews ask for up to 4 FAQ questions and are never padded, and with fewer than 10 reviews the copy never says “many” or “most” customers. Exact review counts are never stated.
• Names. Reviewers appear only as “First L.” (for example “Linda G.”), and never inside the AI’s own sentences.
• Turned-off blocks. If your store has turned a block off (enabled_widgets in the same setting), it isn’t charged when you regenerate and it’s left off your live page.

The rules apply to the next generation. Drafts and live pages you already have don’t change until you regenerate them.

Regenerate a single block

If a particular block isn’t right (e.g., the FAQs are too generic but the summary is fine), click Regenerate on just that block. The AI takes a fresh pass with the same review input. The other blocks stay untouched.

Five free regenerations per block. The first generation is free. After that each block gets 5 free regenerations per draft, and regenerating the whole product counts one against every block. Past 5, a regenerated block costs 1 AI credit from the same pool as AI-guided reviews. The counter resets when you publish. Re-optimizing a product you’ve already drafted never counts against your unpublished-optimization limit. Publishing draws 5 AI credits per product — see Billing & limits.

Mark a block as low quality

If a block invented something, is off-brand, or is just too thin, click Mark as low quality on that block. Pick a reason (hallucinated, off_brand, too_short or other) and, if you like, add a short note. We record every flag — it is the main signal we have about generation quality.

The same flag is available through the API — POST /api/v1/products/:product_id/optimization/feedback, documented in the API reference.

The refund only lands when our own check agrees with you. Every generated block is fact-checked against your reviews and product spec. If that check flagged the block (it came back unverified, or it stripped sentences out), marking it low quality gives the regeneration back: the free slot returns and any AI credit it cost drops out of your usage for the period. If the check passed the block cleanly, the flag is recorded but nothing is refunded. Blocks generated before the fact check shipped have no report, so they never refund.

Two limits worth knowing: you can earn at most 20 refunds per billing period (flags past that are still recorded, just not refunded), and a refunded credit does not refund an extra-credit block you already bought — that purchase is already billed through Shopify.

Flagging the same block of the same generation twice does nothing the second time, so there is no way to refund one regeneration twice. Regenerate that block and you get a fresh generation, which you can flag on its own.

Regenerate the whole product

Open the Regenerate menu at the top of the editor and pick Regenerate all to redo every block at once. Useful when:

• You’ve imported a large batch of new reviews and want the content refreshed
• The original generation happened with too few reviews
• You want a different tone or angle (the same menu has a feedback field — add notes for the AI before running the regeneration)
• You want a different top review — regenerating it with feedback skips the review the previous version featured (your current draft’s, or the live page’s after you publish)

Discard a draft

If a draft is unrecoverable, click Discard. The product returns to “not started” — no metafield writes happen. You can generate again from scratch when ready.

When publishing is blocked

Publish is blocked whenever a section hasn’t passed the fact check. The button reads Checking… while a check is running. Try to publish a draft that hasn’t passed, and a banner appears under the editor toolbar saying what to do (it also appears on its own if a check stalls):

• Checking… — a check is still running. Wait, then publish.
• Couldn’t be checked — the checker was unreachable when the draft was written or edited. Click Re-check in that banner; it re-runs the check over the blocks that haven’t passed and leaves the rest alone. (On the API this is POST /api/v1/products/:product_id/optimization/recheck.)
• The reviews behind this draft are gone — the reviews it was written from have been deleted or erased since, so there’s nothing left to check it against and re-checking won’t help. Regenerate it. (A product with no reviews at all is fine: its draft is checked against your product description.)
• Generated before fact-checking — the draft predates the fact check and has no report at all, so there’s nothing to re-check. Editing one saves your text but leaves it unpublishable. Regenerate it, then publish.

Not enough evidence doesn’t stop you publishing, but that section is left off your live page — your draft keeps it. It means your reviews and product description couldn’t support enough text to fill it. Collect more reviews or add detail to your product description, then regenerate it. A block your store has turned off is left off the live page the same way.

Publish vs. unpublish

Publish writes the current content to your Shopify product metafields. Your storefront blocks pick it up immediately (or within ~30s if your theme caches).

Unpublish clears the metafields but keeps the draft in BetterReviews. Useful for pulling content while you fix something. Shopper-facing storefront blocks fall back to no content until you republish.

Tips

• Edit one section at a time. AI drafts are usually 80% right. Regenerating a single section leaves the others — including your edits to them — exactly as they were; only the section you regenerate is rewritten.
• Use feedback for tone shifts, low-quality for mistakes. If the summary reads too marketing-speak, open the Regenerate menu, type “use plainer language” or “lead with the most-mentioned use case” into the feedback field, and run regeneration. Feedback steers that one run only — it isn’t remembered next time, so a rule you always want (a topic or word to avoid) belongs in your content settings instead. It never refunds anything. Use Mark as low quality when the block was wrong rather than merely off-tone — that is the one that can give the regeneration back.