GBP Reviews

Docs

Install guides

Every GBP Reviews widget is two lines of HTML. Pick your platform for step-by-step instructions.

WordPress Squarespace Wix Webflow Shopify HTML, Astro, and other sites

Copy your embed code

  1. Sign in to GBP Reviews and open your Review dashboard.
  2. Under Review outputs, open the list or carousel widget you want to show. Create one with Create review output if you haven't yet.
  3. Make sure the widget is Published, then click Copy JavaScript embed.

The code looks like this, with your own token in place of YOUR_WIDGET_TOKEN:

<script src="https://gbpreviews.app/embed/v1.js" defer></script>
<gbp-reviews token="YOUR_WIDGET_TOKEN"></gbp-reviews>

Match your site's design

The widget keeps its own styles so your site's CSS can't break it. To adjust its look, set any of these variables on the gbp-reviews element in your site's CSS:

gbp-reviews {
  --gbp-reviews-font: 16px/1.5 Inter, sans-serif; /* full font shorthand */
  --gbp-reviews-text: #172033;
  --gbp-reviews-muted: #667085;
  --gbp-reviews-link: #1a73e8;
  --gbp-reviews-stars: #f5a623;
  --gbp-reviews-background: transparent;
  --gbp-reviews-card-background: #ffffff;
  --gbp-reviews-border: #e4e7ec;
  --gbp-reviews-radius: 14px;
  --gbp-reviews-spacing: 20px;
}

Layout (list, grid, or carousel), review selection, and order are set on the widget page in GBP Reviews, so you can change them without editing your site.

If the reviews don't appear

  • Check the live, published page. Many site editors don't run custom scripts while you're editing.
  • Confirm the widget is still published in GBP Reviews and that your subscription or trial is active. Unavailable widgets render nothing rather than an error.
  • If you rotated the widget's public URL, copy the new embed code. The old token stops working.
  • Changes to a widget can take up to five minutes to show on your site.
  • If your site or plan doesn't allow third-party scripts, use the Iframe compatibility option on the widget page instead. It needs no JavaScript on your site, but you set its height yourself.

Still stuck? Email [email protected] with the page address and we'll take a look.