Troubleshooting Product Pages

Last updated: April 26, 2026

“Generation failed” or empty drafts

If a Product Pages run completes with empty FAQs, no “best for” labels, or a generic summary, the most common cause is not enough review content to extract from. The AI needs reviews with actual substance — phrases customers wrote about the product, not just star ratings.

How to fix

  • Wait for more reviews. Aim for at least 10 detailed AI-conversation reviews per product before the first optimization.
  • Re-import your existing reviews from Judge.me/Okendo/Yotpo if you haven’t yet — those count too.
  • If the product is new and has no reviews, Product Pages will skip it on bulk generation and show a “Needs reviews” status.

Content not appearing on my storefront

Click Publish on a product, then visit your live storefront and don’t see the AI summary or FAQs?

Check

  1. Theme blocks installed. Each AI section requires a corresponding Liquid block in your theme — hero-section, top-section, middle-section, bottom-section. Open Theme Editor → Customize → Add block on a product page. If you don’t see them, the BetterReviews theme extension isn’t installed; reinstall via the app.
  2. Theme cache. Shopify caches theme content for 30-60 seconds. Refresh the page after waiting a minute.
  3. Metafield permissions. If your theme is on a custom dev branch, the metafield render may need permissions. The block’s Liquid code reads product.metafields.ppo.* — check your theme can access that namespace.

I downgraded to Reviews — what happens to my Product Pages content?

Storefront-side: nothing changes. Already-published optimizations keep rendering on your product pages. Customers see what they saw yesterday.

Dashboard-side: locked out. Clicking Product Pages in the BetterReviews admin shows the upgrade prompt. You can’t generate new optimizations, edit existing ones, or republish. Your historical data is preserved — when you upgrade back to Pro, everything reappears.

API-side: 403. Calls to POST /api/v1/products/.../optimize and friends return 403 entitlement_required. Read endpoints (GET /api/v1/products/.../optimization) return your stored data with the AI-generated content field stripped to null.

How do I upgrade?

Click Upgrade to Pro on the Product Pages upsell screen, or open /pricing directly in your BetterReviews admin URL. Shopify handles the billing flow; we get notified within seconds and Product Pages unlocks immediately — no need to log out.

I’m a legacy “lite” plan customer — am I locked out?

No. If you were on the legacy “lite” plan before Product Pages launched, your account has a per-store override that grants Product Pages access. Your dashboard works the same as a Pro merchant. Reach out at hello@betterreviews.app if you see the upsell screen — that’s a sync bug, not a plan change.

Still stuck?

Email us at hello@betterreviews.app or, if you have the Slack integration set up, ping the BetterReviews team in your dedicated channel.