Skip to main content

Widget Builder Guide

info

This guide is for client administrators configuring widgets in the BX Platform. If your looking at how to add a configured PG Amplify widget on your site you should skip to Installation & Setup.

  1. Log into the BX Platform
  2. Go to Brand Experience → Transparency
  3. Click Amplify

Amplify landing page in the BX Platform showing the Widgets list and Create Widget button

Creating a New Widget

Click Create Widget to open the Widget Builder. You'll configure your widget in three steps: Configure, Style, and Publish.

Step 1: Configure Your Widget

Name Your Widget

Enter a clear, recognizable name (e.g., "Cardiology Reviews Widget").

Screenshot: Widget Builder configure step showing the name input field

Choose a Widget Type

TypeDescription
SummaryDisplays overall rating and review count. Best for a quick snapshot.
DetailShows individual reviews in a list with sorting and pagination.
Summary + Detail (Recommended)Combines both views. Can be deployed together on one page or separated but linked across pages.

Configure Data Options

Toggle these features on or off:

OptionDescription
AI SummaryDisplays an automatically generated summary of reviews.
Question-Level SummarySummarizes ratings for specific survey questions.
Auto-updateKeeps your widget updated with the latest data. On by default — only disable if you want to display static ratings that do not automatically update.

Configuration options showing AI Summary, Question-Level Summary, and Auto-update toggles

Apply Filters

Control what data appears in the widget:

FilterDescription
Survey SourceChoose one or more data sources.
Date RangeTime window for included reviews (e.g., last 365 days is the most common setting).
Minimum Rating ThresholdOnly display data after a minimum number of reviews. Recommended: 30.

Security Settings (Optional)

Restrict where your widget can appear by adding approved website domains (e.g., https://yourwebsite.com).

Click Continue to move to styling.

Step 2: Customize the Design

Make the widget match your website's look and feel.

Style customization panel showing typography and color options with the live preview on the right

Typography

  • Font family — Select from the dropdown. If your preferred font isn't listed (e.g., custom Adobe fonts), contact your CX Advisor or support rep. Provide the font file and it will be uploaded to your instance.
  • Font size — Small, Medium, or Large.

Colors

SettingDescription
Text colorPrimary text color for the widget.
Link/navigation colorColor for clickable links and navigation elements.
Accent colorColor for star ratings, buttons, and highlights.
Background colorWidget background color.

Live Preview

As you make changes, a preview updates in real time so you can see exactly how your widget will look.

Click Continue when finished.

Step 3: Publish Your Widget

Select Content Source

Choose a Provider (e.g., doctor, staff member) and optionally a Location. This determines which reviews appear. If no provider or location is selected, sample data is shown in the preview.

Publish step showing provider/location selector and the embed code output

Preview Your Widget

Review how the widget will appear with real data from the selected provider/location.

Copy Your Embed Code

Copy the generated HTML snippet and add it to your website. See Installation & Setup for detailed embedding instructions.

Editing an Existing Widget

  1. Go to Widgets
  2. Find your widget in the list
  3. Click the Actions menu
  4. Select Edit

You can update:

  • Configuration — data options, filters, security settings
  • Styling — typography, colors
  • Provider/location selection

Changes will update wherever the widget is embedded.

Tips & Best Practices

  • Use Summary + Detail for the best user experience
  • Enable AI Summary for quick insights
  • Set a minimum review threshold to ensure credibility
  • Match colors to your brand for a seamless look
  • Preview before publishing

Once your widget is configured, see Installation & Setup for instructions on adding it to your website.