How it works Pricing Blog Docs

Troubleshooting Product Pages

Last updated: June 19, 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. BetterReviews Script app embed enabled. The sections only load their styles and script through the BetterReviews Script app embed. In Theme Editor → Customize → App embeds, make sure it’s toggled on for your published theme.
  2. 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.
  3. Theme cache. Shopify caches theme content for 30-60 seconds. Refresh the page after waiting a minute.
  4. 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?

During your first 7 days, Product Pages is unlocked on every plan as part of the reverse trial — the behavior below applies once the trial ends (or if you downgrade later).

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

Dashboard-side: locked out. Opening the Product page content card in Studio 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 Growth, 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.

”Out of AI credits” or “publish more” errors

Publishing a product page draws 5 AI credits from your monthly plan (generating and regenerating drafts is free). Two credit-related responses can appear:

  • 402 credit_limit_reached on publish — you’re out of AI credits for the period. Turn on auto-recharge (extra credits bill at your plan’s block rate) or upgrade for a bigger monthly pool. With auto-recharge on, publishing just continues and bills the overage.
  • 429 unpublished_optimization_limit on optimize/regenerate — you’ve optimized the per-period maximum of products without publishing any. Publish a draft to unlock the next, or wait for your next billing period. (Re-optimizing a product you’ve already drafted this period is always allowed.)

How do I upgrade?

Click Upgrade to Growth on the Product page content upsell in Studio, 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.